Knowledge Base

Auto-Verbindung zur Timer-Komponente

In der neueren Version des Editors existieren automatische Verbindungen nicht mehr als Verbindungstyp. Das Auto-Advance-Verhalten wird explizit mit einer Timer-Komponente dargestellt.

1. Manuelle Navigation (Button/Ausgänge): Manuelle Verbindungen bleiben als Ausgänge auf der Komponente (zum Beispiel Instruktions-Buttons, Menü-Buttons, Barcode-Ausgänge). Diese Ausgänge verbinden sich mit dem nächsten Step.

2. Auto-Advance (Timer-Komponente): Wenn der Alt-Workflow eine Auto-Verbindung (Timeout) hatte, fügt der Konverter eine Timer-Komponente hinzu, um dieses Verhalten darzustellen:

• Der Timer wird im selben Schritt wie die Komponente platziert, die zuvor die Auto-Verbindung hatte (meist der Instruktionsschritt, der in einen Pin umgewandelt wird).
• Ein Timer hat genau eine Ausverbindung zu einem einzelnen nächsten Schritt.
• Wenn in der älteren Generation mehrere Autoverbindungen vom selben Node existieren, kann nur eine repräsentiert werden. Der Konverter behält die kürzeste/erste und trimmt die übrigen (LOG).
• Timeout-Werte werden von Millisekunden in Sekunden umgerechnet (je nach Bedarf gerundet).
• Wenn eine automatische Verbindung mit 0 ms aus einem Pin besteht, erzeugt der Konverter einen Timer von 1s, um die Absicht des automatischen Vorschusses zu bewahren.

Hinweis: Die Quiz‑, Menü‑ und Barcode‑Komponenten unterstützen keine ausgehenden Auto‑Verbindungen. Enthält ein Legacy‑Workflow ein entsprechendes Muster, wird dieses gemäß den Best‑Effort‑Regeln konvertiert und durch einen LOG‑Eintrag gekennzeichnet.

Quiz 

Definiert das True‑/False‑Ausgabeverhalten für die im Navigationsbereich konfigurierte Frage. Um beispielsweise bestimmte Fähigkeiten eines Mitarbeiters an einer Maschine zu überprüfen, können Quiz‑Components im Modell platziert werden, die Single‑Answer‑ oder Multiple‑Choice‑Fragen enthalten.

Über die Optionen im rechten Panel der Quiz‑Component können Sie:

• den Namen der Quiz‑Component festlegen (nur im Spatial Editor relevant)
• eine Frage definieren
• festlegen, ob es sich um eine Single‑Answer‑ oder Multiple‑Choice‑Frage handelt
• die richtige(n) und falsche(n) Antwort(en) hinzufügen
• definieren, ob die Frage für das Selbststudium angeboten wird
• falls für das Selbststudium angeboten, die Anzahl der Antwortversuche festlegen
• bestimmen, welches Feedback der Benutzer bei der Beantwortung der Frage erhält

Der Name der Quiz‑Component dient der Identifikation im Spatial Editor. Im Spatial Workplace wird jedoch nur die Frage angezeigt.

Single‑Answer‑ und Multiple‑Choice‑Fragen:

Diese Einstellung definiert, wie viele korrekte Antworten ausgewählt werden müssen, damit eine Frage als korrekt beantwortet gilt.
Ist Single ausgewählt, muss der Benutzer nur eine korrekte Antwort auswählen, auch wenn die Frage mehr als eine korrekte Antwort enthält. Ist Multiple ausgewählt, muss der Benutzer alle korrekten Antworten auswählen, damit die Antwort als korrekt gewertet wird.
Sobald die korrekte(n) Antwort(en) ausgewählt wurden, erhält der Benutzer, sofern für diese Frage definiert, positives Feedback, und der Step, der mit dem True‑Outport der Quiz‑Component verbunden ist, wird aktiviert. Entsprechend wird bei falscher(n) Antwort(en) der Step aktiviert, der mit dem False‑Outport verbunden ist.

Antworten: Beliebig viele mögliche Antworten können zu einer Frage hinzugefügt werden:

1. Klicken auf die Schaltfläche Add Item unter Answers.

2. Aktivieren des Kontrollkästchens neben allen korrekten Antworten der Frage.

Feedback:

Es ist möglich, dem Benutzer unmittelbares Feedback darüber zu geben, ob die Frage korrekt oder falsch beantwortet wurde. Aktivieren Sie die Kontrollkästchen für positives/negatives Feedback und geben Sie die entsprechenden Feedback‑Nachrichten ein, die angezeigt werden sollen. Positives Feedback wird angezeigt, wenn die korrekte(n) Antwort(en) ausgewählt wurden. Negatives Feedback wird angezeigt, wenn der Benutzer die Frage falsch beantwortet. Die maximale Anzahl von Fehlversuchen, bevor negatives Feedback angezeigt wird, hängt von der jeweiligen Fragenkonfiguration ab.

Es ist wichtig zu beachten, dass der Benutzer ohne konfiguriertes Feedback keine Rückmeldung darüber erhält, ob die Frage korrekt oder falsch beantwortet wurde.

1. Hologramme werden in einen Step State innerhalb desselben Steps konvertiert, der die aus dem ursprünglichen Pin erzeugte Instruction Component enthält.

2. Hologramm-Ziele werden zu Step State Targets konvertiert, wobei jedes Target in einem separaten Container platziert wird. Separate Container sind erforderlich, da jedes Target über eigene Farb- und zugehörige Eigenschaften verfügen kann.

3. Die Hologrammfarbe wird auf die Target-Farbe des Containers übertragen, einschließlich des Alpha-Werts. Dabei wird derselbe Standard-Alpha-Wert verwendet wie bei Hologrammen.

4. Der Hologrammstil wird einem Sichtbarkeitsmodifikator zugeordnet:

   • Static → Show
   • Pulsing → Pulse

5. Keyframes der Hologramm-Animation werden unverändert auf die Animation der Step State Targets übertragen.

6. Die Hologramm-Transformation wird der Container-Transformation des Step State zugeordnet. Animations-Keyframes können diese Basistransformation überschreiben.

Sonderfälle:

Wurde ein Hologramm im Legacy Editor dupliziert und existierten mehrere Kopien innerhalb desselben Pins mit jeweils eigenen Animationen, wird jede Kopie als separates Modell in einem eigenen Container innerhalb desselben Step State konvertiert.

Modelle, die zuvor als Hologramme angezeigt wurden, erscheinen im New Editor möglicherweise nicht mit demselben Transparenzgrad.

Alle räumlichen Referenzen in einem Workflow werden einem einzelnen Space (z. B. Space1) hinzugefügt. Ihre Parameter, Transformationen und Eigenschaften bleiben erhalten.

• Spatial-Reference-Nodes werden aus der Workflow-Logik entfernt. Die Nodes davor und danach werden wieder verbunden und verwenden dasselbe Verbindungslabel wie zuvor.
• Falls mehrere Model Placement-Nodes vorhanden waren, wird möglicherweise nur der erste beibehalten. Zusätzliche Nodes können entfernt und im Protokoll (LOG) erfasst werden.
• QR-Code-Marker werden entfernt (Legacy-Verhalten), und die Benutzer werden während der Konvertierung darüber informiert.

Nachdem Spatial References in den Spatial Tracker extrahiert wurden, wird der ehemalige Spatial-Reference-Node zu einem Step mit der Space Preference-Komponente umgewandelt, wobei der extrahierte Spatial Tracker als bevorzugter Tracker ausgewählt wird. Wenn die Legacy-Spatial-Reference einen Auto-Connection-Wert größer als null besitzt, wird zusätzlich eine Timer-Komponente im selben Schritt erstellt.

Die folgenden Transformationen veranschaulichen dieses Verhalten:

Verhalten des Back-Buttons:

Nur eingehende Verbindungen zu Pins/Quiz Pins/Menüs/Barcodes beeinflussen die Einstellung des Back-Buttons des resultierenden Steps:

• Wenn bei allen eingehenden Verbindungen Back aktiviert war, ist Back für den Schritt aktiviert (Back-enabled).
• Wenn bei mindestens einer eingehenden Verbindung Back deaktiviert war, ist Back für den Schritt deaktiviert (Back-disabled).

Back-Button-Flags auf Verbindungen, die zu Scene States führen, werden ignoriert.

Daher entspricht die linke Konfiguration (Legacy) derzeit der rechten Konfiguration (Neu):

Ein Checkpoint ist ein Verhalten auf Step-Ebene in den neuen Workflows, das es einem Workplace-Benutzer ermöglicht, während eines Task Runs zu einem zuvor besuchten Step zurückzukehren.

Ein Step mit Checkpoint = ON wird nachdem er einmal besucht wurde zu einem gültigen Rückkehrpunkt. Von jedem späteren Step aus kann der Benutzer zu diesem Checkpoint zurücknavigieren und den Workflow von dort fortsetzen. Dabei wird der Workflow State auf den Zustand zurückgesetzt, den er zum Zeitpunkt des Besuchs dieses Steps hatte.

Wichtig ist, dass dieses Verhalten unabhängig von den Komponenten innerhalb des Steps ist.

Warum Checkpoints wichtig sind

In Workflows der älteren Generation werden Menu Nodes mit zwei Verantwortlichkeiten kombiniert:

1. Anzeigen mehrerer ausgehender Verbindungen (Navigation UI).
2. Ermöglichen, dass Benutzer nach dem ersten Besuch erneut zum Menu zurückkehren können.

In der neueren Version wurden diese Verantwortlichkeiten bewusst getrennt:

• Die Menu Component steuert, wie die Auswahlmöglichkeiten dargestellt werden.
• Der Checkpoint steuert, ob ein Step erneut besucht werden kann oder nicht.

1. Besuch eines Checkpoint

• Ein Step wird erst dann zu einem gültigen Checkpoint, nachdem der Benutzer ihn besucht hat.
• Steps mit Checkpoint = OFF können niemals erneut aufgerufen werden.

2. Zu Checkpoints zurückkehren

• Vom aktuellen Step aus kann der Benutzer zu jedem zuvor besuchten Step zurückkehren, für den Checkpoint = ON aktiviert ist.
• Bei der Rückkehr wird der Workflow State auf den Zeitpunkt zurückgesetzt, zu dem dieser Checkpoint erreicht wurde.

3. Die Checkpoint-Historie ist linear

• Wenn ein Benutzer zu einem früheren Checkpoint zurückkehrt, werden alle Checkpoints verworfen, die nach diesem Step besucht wurden.
• Nur Checkpoints im aktuell aktiven Pfad bleiben gültig.

Wofür Checkpoints nicht gedacht sind

2. Checkpoints ermöglichen es Benutzern nicht, zu allen zuvor besuchten Checkpoints eines gesamten Task Runs zu springen.
3. Checkpoints unterstützen nicht das erneute Aufrufen von Steps, die nicht mehr Teil des aktuellen aktiven Pfads sind.
4. Das Legacy-Verhalten, bei dem jedes zuvor besuchte Menu jederzeit erneut aufgerufen werden konnte, wird im New Editor bewusst nicht unterstützt.

Der Legacy Editor und der neue Editor validieren Workflows unterschiedlich.

Nach der Konvertierung können neue Validierungsfehler oder Warnungen angezeigt werden, selbst wenn der Legacy-Workflow erfolgreich exportiert werden konnte.

Hinweis zur Quiz-Konvertierung: Der Legacy-Editor erlaubte in bestimmten Fällen nur eine True- oder False-Verbindung. Nach der Konvertierung erfordert der neue Spatial Editor beide Verbindungen. Der Konverter spiegelt das Ziel der vorhandenen Verbindung, um die fehlende Ausgangsverbindung zu erstellen, und protokolliert eine LOG-Warnung.

Konvertierung des Workflow-Status: Der Legacy-Editor erlaubte mehreren sichtbaren Modifikatoren innerhalb eines Scene-State-Nodes, auf dieselben Modellziele zu verweisen. Workflow-State-Komponenten erlauben keine Scene-Target-Container mit doppelten Modellzielen.

Während der Konvertierung wird ein sichtbarer Modifikator, der auf ein Modell verweist, das bereits in den Scene-Target-Containern vorhanden ist, entfernt und durch den neu konvertierten Eintrag ersetzt. Dadurch wird sichergestellt, dass jedes Modell höchstens einmal in der Workflow-State-Komponente vorhanden ist.

Einige Patterns aus dem Legacy Editor können im New Editor nicht exakt abgebildet werden. In diesen Fällen wendet der Converter die bestmögliche Zuordnung an und erzeugt eine Warnung mit dem Tag LOG.

Diese Warnungen verhindern die Konvertierung nicht, sollten jedoch nach der Migration überprüft werden, um mögliche Verhaltensänderungen oder Einschränkungen zu verstehen.

Verhaltensbezogene Einschränkungen

• LOG: Mehrere Auto Connections von einem Node → Es wird nur ein Timer unterstützt. Der kürzeste bzw. erste Timer bleibt erhalten, alle weiteren werden entfernt.
• LOG: Quiz mit mehreren True- oder False-Connections → Die erste Connection bleibt erhalten, alle weiteren werden entfernt.
• LOG: Outport-Name oder Outport-Value zu lang (> 30 Zeichen) → Wird auf 30 Zeichen gekürzt.
• LOG: Doppelte Outport-Namen nach der Konvertierung (z. B. durch zusammengeführte Tabs/Pins) → Werden umbenannt oder gekürzt, um die Validierungsanforderungen zu erfüllen.
• LOG: Compression endet am Workflow-Ende → Es wird ein Step mit einer Workflow State Component und einem Timer von 1 Sekunde erstellt, zusätzlich wird eine Warnung ausgegeben.

Nicht unterstützte Legacy-Konstrukte

• LOG: Legacy Scene State – Reset Modifier → Wird in eine Workflow State Component konvertiert, ohne einen Scene Model Container hinzuzufügen.
• LOG: Hologram mit Legacy-v3d-Format → Wird in eine Step State Component konvertiert, ohne einen Scene Model Container hinzuzufügen.