Best Practices & Expertentipps
Diese Empfehlungen helfen Ihnen, im Aiviro Editor robuste, gut lesbare und wartbare Szenarien zu erstellen.
1. Klein anfangen, schnell ausbauen
Erstellen Sie ein Mini-Szenario – ein paar Aktionen, die eine Anwendung starten und auf eine Schaltfläche klicken. Beherrschen Sie die Grundlagen, und fügen Sie dann Schleifen, Bedingungen und Python-Blöcke hinzu.
2. Häufig testen
Wählen Sie im Baum Befehle einen Zweig aus und führen Sie nur diesen aus. Einen Fehler in einem Szenario mit fünf Aktionen zu beheben, dauert Minuten; denselben Fehler in fünfzig Aktionen zu finden, kann Stunden kosten.
3. Auf den Bildschirm warten statt feste Pausen einbauen
Die mit Abstand häufigste Ursache für unzuverlässige Automatisierungen ist ein festes Schlafen, das an dem Tag, an dem es geschrieben wurde, lang genug war. Verwenden Sie Warten auf für etwas, das der nächste Bildschirm tatsächlich anzeigt, und Warten bis Verschwinden für Fortschrittsdialoge. Behalten Sie Schlafen für den seltenen Fall, dass sich nichts Beobachtbares ändert.
4. Suchen an etwas Stabilem verankern
Wenn sich ein Wert bei jedem Lauf ändert, suchen Sie nicht nach dem Wert – suchen Sie mit einer positionsbezogenen Suche nach der Beschriftung daneben. Bevorzugen Sie textbasierte Objekte gegenüber Bild, das bei Designwechseln und DPI-Skalierung versagt.
5. Niemals Zugangsdaten in eine Aktion schreiben
Jedes Passwort, jedes Token und jede Webhook-URL gehört in den Tresor,
referenziert als {{SECRET:KEY}}. Zugangsdaten, die in einen Parameter eingetippt werden, landen beim
nächsten Speichern in der Projektdatei – und danach in der Git-Historie.
6. In Variablen denken
Speichern Sie dynamische Daten – kopierten Text, Dateipfade, ausgelesene Werte – in Variablen, statt
sie fest einzutragen. Geben Sie ihnen aussagekräftige Namen: record_system_id, nicht variable_1.
7. Mit Abschnitten strukturieren
Fassen Sie zusammengehörige Aktionen in Abschnitt-Blöcken zusammen (Anmeldung, CSV exportieren, Bericht senden). Abschnitte lassen sich einklappen, einzeln ausführen und machen die Ansicht Diagramm übersichtlich.
8. Das Warum kommentieren
Die Aktionsliste sagt bereits, was passiert. Schreiben Sie auf, was sie nicht sagen kann: „Dieser Dialog erscheint nur bei der ersten Anmeldung des Tages“, „der Export dauert am Monatsende ca. 40 s“.
9. Deaktivieren statt löschen
Statt eine riskante Aktion zu löschen, setzen Sie ihre Option Aktion ausführen auf Deaktiviert. Sie bleibt ausgegraut im Baum und lässt sich mit einem Klick wieder aktivieren.
10. Umgebungen nutzen, statt Szenarien zu duplizieren
Mit Aktiviert (Test) und Aktiviert (Prod) verhält sich ein einziges Szenario in den beiden Umgebungen unterschiedlich, gesteuert über den Schalter Umgebung. Zwei Kopien eines Szenarios laufen immer auseinander; ein Szenario mit zwei Modi nicht.
11. Fehler explizit behandeln
- Bei Fehler ausführen für eine Berichtsaktion, damit ein fehlgeschlagener Lauf nie unbemerkt bleibt.
- Immer ausführen für Aufräumarbeiten wie Alle Fenster schließen, damit der Rechner nutzbar bleibt.
- Erfolg erforderlich aus für wirklich optionale Schritte – aber nur für diese.
12. Schleifen endlich halten
Wiederholen bis kann endlos laufen, wenn die Bedingung nie umschlägt. Begrenzen Sie die Schleife mit einem Zähler, mit Die Schleife stoppen bei einer Iterationsgrenze oder mit einer Bedingung, die an etwas geknüpft ist, das der Bildschirm anzeigt.
13. Berichten, was der Lauf getan hat
Nachricht hinzufügen mit einer Abschnitts-ID im Verlauf des Szenarios und ein einziges Als E-Mail senden am Ende machen aus einem undurchsichtigen Job einen Bericht, den jemand beim Kaffee lesen kann.
14. Teilen und versionieren
Projekte werden als JSON gespeichert – committen Sie sie in Git und arbeiten Sie mit Branches wie bei jedem anderen Code. Da Geheimnisse im Tresor liegen, kann die Projektdatei gefahrlos committet werden. Datei → Als Python exportieren liefert Ihnen eine diff-freundliche Ansicht für Code-Reviews.
15. Sich inspirieren lassen
Sehen Sie sich die YouTube-Playlist mit Tutorials und die Beispielprojekte an – siehe Referenzen und Ressourcen. Verwenden Sie bestehende Muster wieder, statt sie neu zu erfinden, und binden Sie gemeinsame Routinen mit Szenario importieren ein.
Wenn Sie diese Praktiken befolgen, bleiben Ihre Automatisierungen übersichtlich, lassen sich leichter debuggen und sind für Kollegen verständlich.