Übung 01

Ziel: In dieser Übung richtest du deine komplette Arbeitsumgebung ein und testest sie mit einem minimalen Workflow. Am Ende hast du eine funktionierende Verbindung zwischen Xentral und Xentral Connect und kannst die Ergebnisse eines Workflows überprüfen.

Voraussetzungen:

• Zugangsdaten zu deiner Xentral Connect Umgebung.

• Zugangsdaten zu einer Xentral Demoinstanz.

---

Schritte

Teil 1: Die Verbindung herstellen

1

Xentral Connect Instanz erstellen

• Melde dich in deiner Xentral Connect Umgebung an.

• Erstelle eine neue Instanz. Benenne sie eindeutig, z.B. lab-dein-name.

2

Service-Verknüpfung in Xentral anlegen

• Öffne deine Xentral Instanz.

• Navigiere zu Administration > Einstellungen > System > Service-Verknüpfung.

• Erstelle eine neue Verknüpfung vom Typ "Xentral Connect".

• Kopiere die angezeigte URL und das Token. Halte sie bereit.

3

Credentials in Xentral Connect speichern

• Wechsle zurück zu Xentral Connect.

• Gehe in den Bereich Credentials.

• Erstelle neue Credentials vom Typ "Xentral API Token".

• Gib einen Namen (z.B. xentral-demo-auth) und füge die kopierte URL und das Token ein.

• Speichere die Credentials.

4

Instanz mit Credentials verknüpfen

• Gehe zurück zur Übersicht deiner Instanzen.

• Bearbeite deine Instanz (lab-dein-name) und wähle im Dropdown für die Authentifizierung die gerade erstellten xentral-demo-auth Credentials aus.

• Speichere die Instanz-Konfiguration.

Zwischenergebnis: Deine Connect-Instanz ist nun prinzipiell bereit, mit Xentral zu kommunizieren.

---

Teil 2: Der "Hello World"-Workflow

1

Neuen Workflow erstellen

• Öffne deine Instanz und gehe zur Workflow-Übersicht.

• Erstelle einen neuen Workflow mit dem Namen M01-Hello-World.

2

Workflow konfigurieren

• Der manuelle Trigger ist bereits vorhanden. Das ist alles, was wir für den Start brauchen.

• Suche in der rechten Werkzeugleiste das Log-Element und ziehe es auf die Arbeitsfläche.

• Verbinde den Start-Knoten mit dem Log-Knoten.

• Klicke auf den Log-Knoten und gib im Textfeld folgende Nachricht ein: Mein erster Workflow wurde erfolgreich ausgeführt.

3

Workflow aktivieren und testen

• Speichere den Workflow oben rechts.

• Aktiviere den Workflow über den Schalter.

• Klicke auf den Test-Button (Play-Symbol), um den Workflow manuell auszuführen.

---

Erwartetes Ergebnis:

• Die Workflow-Ausführung in der Übersicht wird als "Success" (erfolgreich) angezeigt.

• Wenn du auf das Lupensymbol (Lenses/Logs) der Ausführung klickst, siehst du die detaillierte Ansicht.

• Im Log-Output des Log-Elements findest du exakt die Nachricht, die du eingegeben hast.

Beispiel-Log-Output (JSON):

{
  "message": "Mein erster Workflow wurde erfolgreich ausgeführt."
}

"Schematischer" Screenshot:

+----------------------------------------------------+
| Lenses for Workflow: M01-Hello-World               |
+----------------------------------------------------+
| Execution ID: xxxxx-xxxx-xxxx-xxxx                 |
| Status: Success                                    |
+----------------------------------------------------+
| ▼ Step: Log                                        |
|   ► Input                                          |
|   ▼ Output                                         |
|     {
|       "message": "Mein erster Workflow wurde erfolgreich ausgeführt."
|     }                                              |
+----------------------------------------------------+

---

Cleanup

• Für diese Übung ist kein Cleanup notwendig. Der Workflow kann für spätere Tests in der Instanz verbleiben.

---

Varianten & Weiterführende Ideen

• Variante 1: Ändere die Log-Nachricht und führe den Workflow erneut aus. Überprüfe, ob die neue Nachricht in den Logs erscheint.

• Variante 2: Füge einen zweiten Log-Knoten hinzu, der eine andere Nachricht ausgibt. Verbinde den ersten Log-Knoten mit dem zweiten. Teste den Workflow und beobachte, wie beide Nachrichten nacheinander in den Logs erscheinen. Dies demonstriert die sequentielle Abarbeitung eines Workflows.