ToolBlockSelectorTool

Mit dem ToolBlockSelectorTool ist es möglich, dynamisch zwischen unterschiedlichen ToolBlocks umzuschalten.

Die Umschaltung erfolgt durch Selektoren, die Eingabeterminals definieren. Bei der Tool-Ausführung entscheidet deren Wert, welcher ToolBlock ausgeführt wird. Es kann mehrere Selektor-Terminals geben, die einen gemeinsamen Schlüssel zur ToolBlock-Auswahl bilden.

Die auszuführenden Toolblocks werden im Tool definiert. Jedem Toolblock ist mit einem Schlüssel-Wert und einem Namen verbunden: Der Name dient lediglich der Identifikation für den Benutzer. Der Schlüssel-Wert bestimmt die Toolblock-Auswahl bei der Tool-Ausführung: stimmt der Schlüssel des Toolblocks mit dem Selektorschlüssel überein, der aus den Werten der Selektoren gebildet wird, so wird er ausgewählt.

Tab „Inputs/Outputs“

Damit das dynamische Umschalten funktioniert, müssen alle ToolBlocks dieselbe Schnittstelle, also identische Inputs und Outputs haben. Im diesem Tab wird diese Schnittstelle definiert. Wird ein neuer Input / Output hinzugefügt, aktualisieren sich sowohl die Terminals des Tools als auch aller enthaltenden TooBlocks. Beim Aufruf des ToolBlockSelectorTools werden alle Inputs an den auszuführenden ToolBlock übergeben und die Outputs nach der Ausführung übernommen.

1. Add new item: Hinzufügen eines Terminals (Es muss der gewünschte Datentyp angegeben werden)

2. Delete selected item: Löschen des markierten Terminals

3. Name: Name des Terminals

4. Type: Datentyp des Terminals (bei einem bestehenden Terminal kann der Datentyp nicht verändert werden)

5. Value: Aktueller Wert des Terminals

Hinweis

Inputs können alternativ auch außerhalb im ToolTree per Drag&Drop anderer Terminals auf den ToolBlockSelectorTool-Knoten angelegt werden.

Tab „Selectors“

Um die Auswahl eines ToolBlocks zu steuern, ist ein Schlüssel zu definieren. Dieser wird aus einem oder mehreren sogenannten Selektoren erzeugt, die in diesem Tab definiert werden. Für jeden Selektor wird spezielles Input-Terminal angelegt. Der Schlüssel für die ToolBlock-Auswahl ist die Verkettung der Selektor-Werte.

Die „Selector-Terminals“ des Tools werden im übergeordneten Ablauf mit diesem Icon gekennzeichnet.

1. Plus/Minus: Hinzufügen beziehungsweise Löschen des markierten Selektors

2. Name: Name des Selektors und dessen Terminals

3. Type: Datentyp des Selektor-Terminals

4. Value: Aktueller Wert des Selektors

5. Format: Format-String, mit dessen Hilfe die Umwandlung einer Zahl in eine Zeichenkette erfolgt. Wird hauptsächlich verwendet, um gleiche Datenlängen zu erreichen, unabhängig von der Eingabe (Beispiel: Daten = 1; FormatString = 000 -> Ergebnis = 001). Es werden alle .NET Format-Strings unterstützt, empfohlen ist aber, nur „000…“ zu verwenden, um gleich lange Strings zu erhalten.

6. FormattedValue: Vorschau der formatierten Zeichenkette des Selektor-Wertes

7. Selectors: Komma-getrennte Liste der Selektoren, aus der der Schlüssel zur Toolgroup-Auswahl abgeleitet wird. Über das Plus Symbol rechts der Textbox können Selektoren ausgewählt und angehängt werden.

8. Toolblock key: Anzeige des aktuellen Wertes des Selektor-Schlüssels, wie er aus der Aneinanderreihung der aktuellen und formatierten Terminal-Werte entsteht.

9. ToolBlock name: Name des ToolBlocks, der aufgrund des aktuellen Schlüsselwertes ausgewählt würde

Tab „Toolblocks“:

In diesem Tab werden die ToolBlocks definiert, zwischen denen umgeschaltet werden kann. Alle ToolBlock haben die gleichen Inputs und Outputs, ihr Inhalt kann sich jedoch beliebig unterscheiden. Zusätzlich muss für jeden ToolBlock der eindeutige Key festgelegt werden.

1. Plus / Minus: Hinzufügen eines neuen (leeren) ToolBlocks / Löschen des markierten Blocks

2. Up / Down-Arrow: Verschieben des markierten Toolbocks in der Liste nach oben und unten

3. Copy / Paste: Kopieren des markierten Toolblocks und Einfügen einer Kopie in die Liste

4. Current: Vorschau des aktuellen Schlüssels zur Toolblock-Auswahl, basierend auf den Werten der Selektoren (in diesem Beispiel: 2a)

5. Selected: Zeigt den aktuell ausgewählten ToolBlock an. Wenn AutoSelect abgewählt ist, kann auch ein anderen ToolBlock ausgewählt werden. AutoSelect wirkt nur in der Benutzeroberfläche. Im Ablauf wird der ToolBlock immer auf Basis des Selektor-Schlüssels ausgeführt.

6. Key: Hier wird der Schlüssel für den einen ToolBlock festgelegt. Stimmt die Schlüssel-Zeichenfolge mit dem aktuellen Selektor-Schlüssel (4) überein, so wird der Toolblock automatisch ausgewählt. Für einen Toolblock können auch mehrere Schlüssel vergeben werden, wenn Multi-Key aktiviert ist. Die Schlüssel werden dann separiert durch Semikola „;“ angegeben. Beispiel: „3;4“ -> kein Leerzeichen.

7. Name: Frei wählbarer Name des ToolBlocks. Dieser hat keine Bedeutung für die automatische Auswahl.

8. Toolblock-Editor. Hier wird der aktuell selektierte Toolblock bearbeitet, also derjenige, dessen Selected-Checkbox aktiv ist. Das Bearbeiten der ToolBlocks erfolgt wie bei einem Standard Cognex-ToolBlock.

9. Default selector: Optional kann hier ein Schlüssel-Wert eingetragen werden, der als Standard-Fallback dient: Ist der Wert leer, so wird er ignoriert. Andernfalls wird dann, wenn zum aktuellen, terminal-basierten Selektor-Schlüssel kein passender Toolblock gefunden, der Default-selector zur Auswahl herangezogen.

Hinweis

Es ist möglich, auch beim Bearbeiten der einzelnen ToolBlocks neue Inputs / Outputs hinzuzufügen bzw. zu Löschen. Diese Änderungen werden jedoch bei allen definierten ToolBlocks übernommen.