Noten und Verbindungen
Was eine Note ist, was Ablauf- und Datenlinien unterscheidet, wie Schleifen aussehen und wie du Noten benennst, kopierst und löschst.
Nach diesem Artikel liest du jeden Bot auf einen Blick: Du weißt, was die gelben und blauen Linien bedeuten, warum manche gestrichelt sind, und wie du Noten sauber verdrahtest.
Eine Note
Eine Note (in der Palette „Modul“ genannt) erledigt genau eine Aufgabe: warten, klicken, ein Bild suchen, eine Zahl vergleichen. Sie hat
- oben eine farbige Kopfzeile — die Farbe ist die Kategorie (blau Ablauf, rot Aktion, grün Wahrnehmung, …),
- links Eingänge, rechts Ausgänge,
- im Eigenschaften-Panel ihre Felder (siehe Parameter und Werkzeuge).
Ablauf-Ports (gelb)
Der gelbe Eingang in und die gelben Ausgänge bestimmen die Reihenfolge. Die meisten Noten haben einen Ausgang weiter; wer entscheidet, hat mehrere: „Bild finden“ gefunden / nicht gefunden, „Verzweigung“ true / false, „Wiederholen“ Schleife / fertig. Von jedem Ausgang darf genau eine Linie weggehen; in einen Eingang dürfen beliebig viele hineinführen.
Der Bot folgt immer der Linie am Ausgang, der zum Ergebnis passt. Hat ein Ausgang keine Linie, endet der Ablauf dort.
Daten-Ports (blau)
Blaue Ports tragen Werte: „Bild finden“ gibt x und y aus, „Text lesen (OCR)“ den text, „Zähler“ den wert. Eine blaue Linie von einem Datenausgang zu einem Dateneingang übergibt den Wert — zum Beispiel x/y von „Bild finden“ an x/y von „Klick“.
Datenlinien sind nicht immer nötig: Jeder Datenausgang lässt sich in jedem Feld anderer Noten als
Referenz eintragen, etwa {Bild finden.x} — siehe Variablen und Referenzen.
Für die zwei, drei wichtigsten Werte ist die Linie trotzdem oft übersichtlicher.
Schleifen: gestrichelte Linien
Führt eine Linie zurück zu einer Note weiter links, ist das eine Schleife. Der Editor zeichnet sie als gestrichelten Bogen über die Noten hinweg, damit sie sich vom normalen Fluss abhebt. Typisch: „Wiederholen → Schleife → … → zurück zu Wiederholen“ oder „nicht gefunden → Warten → zurück zu Bild finden“.
Noten bearbeiten
| Aktion | So geht es |
|---|---|
| Hinzufügen | Note in der Palette anklicken, oder von einem Ausgang ins Leere ziehen (Schnellmenü) |
| Verbinden | Vom Ausgang auf einen Eingang ziehen |
| Verbindung löschen | Doppelklick oder Rechtsklick auf die Linie |
| Verschieben | Kopfzeile mit gedrückter Maustaste ziehen; mehrere Noten per Rahmen auswählen |
| Kopieren / Einfügen | Strg+C / Strg+V |
| Löschen | Entf oder Rechtsklick → Löschen |
| Rückgängig | Strg+Z, wiederholen Strg+Y |
Name und Bezeichnung
Jede Note hat einen eindeutigen Namen („Bild finden“, „Bild finden 2“ …). Unter diesem Namen sprichst
du ihre Ausgänge an: {Bild finden 2.x}. Im Eigenschaften-Panel kannst du ihn ändern — alle Verweise
werden automatisch mitgezogen. Die Bezeichnung ist ein freier Kommentar, der über der Note steht
(„Kaufknopf suchen“) und nichts an der Funktion ändert.
Wenn es nicht klappt
- Eine Linie lässt sich nicht ziehen: Ablauf geht nur gelb→gelb, Daten nur blau→blau, und immer von einem Ausgang zu einem Eingang einer anderen Note.
- Der Ablauf endet früher als gedacht: Ein Ausgang ohne Linie beendet den Lauf. Prüfe im Protokoll die letzte Note und schau, welcher Ausgang dort gewählt wurde.