Lektion 02

In diesem Modul zapfen wir zum ersten Mal externe Datenquellen an. Du lernst, wie du Daten aus deiner Xentral-Instanz und aus beliebigen anderen Systemen im Web abrufen kannst. Außerdem meistern wir eine der häufigsten Herausforderungen: den Umgang mit großen Datenmengen (Pagination).

Platz für deine Notizen:

---

Checkliste: Was du heute erreichen wirst

• Den Unterschied zwischen dem Xentral-Konnektor und dem generischen REST-Konnektor erklären können.

• Einen Workflow bauen, der Live-Daten aus deiner Xentral-Instanz liest (z.B. Artikel).

• Einen Workflow bauen, der Daten von einer öffentlichen REST-API abruft.

• Das Problem der Pagination verstehen und eine Schleife bauen, um alle Seiten einer Datenquelle abzurufen.

• Einen API-Fehler (z.B. 404) in den Lenses/Logs identifizieren und die Ursache benennen können.

---

Übung 1: Daten aus Xentral abrufen

Ziel: Eine Liste aller Artikel aus deiner Xentral-Demoinstanz abrufen und im Log ausgeben.

1

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M02-Get-Xentral-Articles.

2

Xentral-Konnektor konfigurieren

• Füge einen Xentral-Knoten hinzu.

• Wähle als Ressource article aus.

• Wähle als Operation list aus.

3

Workflow testen

• Speichere, aktiviere und teste den Workflow.

• Erwartetes Ergebnis: Öffne die Lenses/Logs. Du solltest im Output des Xentral-Knotens ein JSON-Array mit den Artikeldaten aus deiner Demoinstanz sehen.

Platz für deine Screenshots oder Notizen zum Ergebnis:

---

Übung 2: Daten von einer externen REST-API abrufen

Ziel: Eine Liste von Produkten von der öffentlichen Test-API https://dummyjson.com abrufen.

1

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M02-Get-External-Products.

2

REST-Konnektor konfigurieren

• Füge einen REST Request-Knoten hinzu.

• URL: https://dummyjson.com/products

• Response Format: Stelle sicher, dass JSON ausgewählt ist.

• Authentication: None (keine Authentifizierung für diese öffentliche API nötig).

3

Workflow testen

• Speichere, aktiviere und teste den Workflow.

• Erwartetes Ergebnis: In den Logs siehst du ein JSON-Objekt. Es enthält einen Key products, dessen Wert ein Array von Produktobjekten ist. Du wirst auch die Keys total, skip und limit sehen – ein klarer Hinweis auf Pagination!

---

Cheat Sheet: Wichtige Begriffe aus Modul 2

Begriff	Erklärung
Konnektor	Ein Baustein in Connect, der die technische Verbindung zu einem anderen System (z.B. Xentral, REST-API) herstellt.
REST-API	Ein standardisierter Weg für Softwaresysteme, um über das Internet miteinander zu kommunizieren. Basiert auf HTTP-Methoden (GET, POST etc.).
Endpoint	Eine spezifische URL innerhalb einer API, die eine bestimmte Ressource repräsentiert (z.B. /users oder /orders/123).
Pagination	Die Aufteilung einer großen Datenmenge auf mehrere "Seiten". Eine API liefert z.B. nur 50 von 1000 Kunden auf einmal zurück. Man muss dann die restlichen Seiten separat anfragen.
HTTP Status Code	Ein Code, der das Ergebnis einer API-Anfrage anzeigt. 200 OK bedeutet Erfolg. 404 Not Found bedeutet, die URL existiert nicht. 401 Unauthorized bedeutet, die Authentifizierung ist fehlgeschlagen.
Schleife (Loop)	Ein Element in Connect, das es erlaubt, eine Reihe von Aktionen mehrmals hintereinander auszuführen. Essentiell für die Verarbeitung von paginierten Daten.