--- title: "Getting started with powertools" url: "https://help.aedifion.io/de/article/getting-started-with-powertools" language: "de" last_updated: "2026-04-17T09:05:17.415Z" --- # Getting started with powertools Under Construction ## **Erste Schritte** ### **Lieferoptionen** Die aedifion powertools suite ist ein Python-Programm, das experimentelle Werkzeuge für Betreiber enthält, um ihre aedifion-Projekte einzurichten, zu organisieren und zu erweitern. Sie steht erfahrenen Kundinnen und Kunden auf Anfrage zur Verfügung. Die aedifion powertools werden als einzelne .exe-Datei bereitgestellt, die die erforderliche Python-Version und alle Abhängigkeiten enthält. Eine Installation ist nicht notwendig, jedoch erstellt die Ausführung der .exe-Datei einige Dateien auf Ihrem Computer, zum Beispiel eine .log-Datei. **Konfiguration einrichten** Starten Sie die powertools, indem Sie die Datei ausführen. Die aedifion powertools sind so eingerichtet, dass sie automatisch nach Benutzerdaten in einer .ini-Datei suchen. Wenn Sie bisher keine solche Datei verwendet haben, können Sie sie in weniger als zwei Minuten erstellen. Erstellen Sie zunächst eine leere Textdatei und benennen Sie sie in **aedifion\_config.ini** um. Sie können diese Datei an einem beliebigen Ort auf Ihrem Computer speichern. ⚠️ **Achtung** Stellen Sie sicher, dass niemand Zugriff auf Ihre gespeicherten Passwörter erhält. Speichern Sie diese Datei **nicht** auf Netzlaufwerken, in Git-Repositories oder auf unverschlüsselten Laufwerken. Diese Datei kann nun mit Ihren Benutzerdaten gefüllt werden. Sie können für jeden Abschnitt einen beliebigen Namen in eckigen Klammern \[\] wählen, gefolgt von drei Zeilen mit **url**, **username** und **password**, jeweils mit einem **\=** und dem entsprechenden Wert. Verwenden Sie dabei die URL der API. **Beispiel** ``` [reallycoolserver] url = https://api.reallycoolserver.aedifion.io username = youremail@emailprovider.com password = y0urHighlYsecuReP4ssword [dev] url = https://api.dedicateddevelopmentserver.aedifion.io username = youremail@emailprovider.com password = hunter2 [silverback] url = https://api.verybiggorilla.aedifion.io username = youremail@emailprovider.com password = 1234 ``` Es gibt zwei Möglichkeiten, die powertools auf diese Datei aufmerksam zu machen: - Starten Sie die powertools und legen Sie den Pfad unter **Datei > Konfigurationsdateipfad festlegen** fest. Möglicherweise müssen Sie zuvor eine gültige Verbindung eingeben. - Oder erstellen Sie eine Umgebungsvariable mit dem Namen **AEDIFION\_API\_CONFIG\_PATH** und fügen Sie den Dateipfad als Wert hinzu. 💡 **Tipp** Setzen Sie Ihre Umgebungsvariable auf einen **absoluten Pfad**, z. B.: `Mac: "/Users/MyFavoriteAedifionEmployee/Documents/aedifion_config.ini"` `Windows: "C:\Users\MyFavoriteAedifionEmployee\Documents\aedifion_config.ini"` `Linux: "/home/MyFavoriteAedifionEmployee/Documents/aedifion_config.ini"` Wenn Sie einen relativen Pfad wie "~/aedifion\_config.ini" verwenden, wird Ihre Konfigurationsdatei nicht korrekt gelesen. * * * **Hauptmenü** Das Hauptmenü der grafischen Benutzeroberfläche (GUI) bietet direkten Zugriff auf alle Funktionen der powertools. Es zeigt außerdem an, ob der **Dry-Run-Modus** aktiv ist, der über den Schalter oben im Menü aktiviert oder deaktiviert werden kann. ![](https://cdn-assets.productfruits.com/5da2e596-acf5-43d5-8a6d-7ebbe4b895c1) **Menüleiste** Die Menüleiste befindet sich oben in der Anwendung, wenn Sie sich im Hauptmenü befinden. Sie enthält folgende Optionen: - **Datei** - - *Konfigurationsdateipfad festlegen*: Legen Sie den Pfad zu einer Konfigurationsdatei mit Anmeldedaten fest. - *Protokollebene ändern*: Ändern Sie die Nachrichtenebene der Logdatei. - **Werkzeuge** - - *Projekte neu laden*: Lädt Ihre verfügbaren Projekte erneut von der API. - **Ansicht** - - *Dunkel-/Hellmodus wechseln*: Wechselt das Design der API. - **Hilfe** - - *Dokumentation*: Öffnet diese Dokumentation im Standardbrowser. - *Kontakt*: Öffnet eine E-Mail mit vorab ausgefüllten Informationen in Ihrer Standard-Mailanwendung. - *Über*: Zeigt Informationen zu den powertools an. * * * **Verbindungskonfiguration** **Projektauswahl** Der obere Bereich des Hauptmenüs zeigt Ihr aktuell ausgewähltes Projekt. Über das Dropdown-Menü können Sie ein anderes Projekt vom aktuellen Server auswählen. Wenn Sie die Serverkonfiguration ändern möchten, klicken Sie auf **Verbindung ändern**. Den **Dry-Run-Modus** können Sie über den Schalter aktivieren oder deaktivieren. Wenn der Modus aktiv ist, wird im Hauptmenü eine Warnung angezeigt. ⚠️ **Achtung** Im Dry-Run-Modus führen die meisten Anwendungen so viele Berechnungen wie möglich durch, einschließlich API-GET-Anfragen, schreiben jedoch nichts zurück an die API. Nicht alle Funktionen können ohne API-Antwort simuliert werden. Der Dry-Run-Modus kann Fehler enthalten – verwenden Sie ihn daher mit Vorsicht. * * * ### **Verbindung ändern** - *Server aus Konfiguration auswählen*: Wählen Sie eine der gespeicherten Konfigurationen aus Ihrer Konfigurationsdatei. - *Server manuell eingeben*: Geben Sie Server und Zugangsdaten manuell ein. Im nächsten Bildschirm können Sie eines Ihrer Projekte vom neu ausgewählten Server auswählen. * * * **Werkzeugauswahl** Die powertools sind in fünf Bereiche unterteilt, je nach Anwendungsfeld. Sie können jedes Werkzeug über den entsprechenden Button starten. Nach Abschluss oder Abbruch des Werkzeugs kehren Sie zum Hauptmenü zurück. Weitere Informationen zu den einzelnen Werkzeugen finden Sie in den jeweiligen Unterabschnitten dieser Dokumentation. - **Projekt** – Werkzeuge zum Sammeln von Informationen oder Hochladen von Daten. - **Komponenten-Mapping** – Werkzeuge zum Zuordnen von Komponenten, Clustern von Daten und Erstellen von Frontend-Cockpits. - **.analytics** – Werkzeuge zur Verwaltung Ihrer .analytics-Instanzen. - **Virtuelle Datenpunkte** – Werkzeuge zum Erstellen, Verwalten und Löschen virtueller Datenpunkte. - **.controls** – Werkzeuge zur Verwaltung Ihrer .controls-Anwendungen. * * * **Hilfe & Fehlerberichte** Wenn Sie Unterstützung benötigen, auf einen Fehler stoßen oder eine neue Funktion vorschlagen möchten, kontaktieren Sie uns bitte unter [**controls@aedifion.com**](mailto:controls@aedifion.com).