Queues, Queueworker und Jobs

1. Überblick

Queues (Warteschlangen) steuern in Xentral Connect die Ausführung von Flow-Ausführungen.

Jede Flow-Ausführung wird als Job in eine Queue eingereiht. Die Queue legt fest:

• wann Jobs ausgeführt werden

• in welcher Reihenfolge sie abgearbeitet werden

• wie viele Jobs parallel ausgeführt werden dürfen

• auf welcher Warteschlange ein Flow abgearbeitet wird

Durch die Konfiguration verschiedener Queues lässt sich die Lastverteilung in größeren Integrationsszenarien gezielt steuern.

---

2. Funktionsweise von Queues

Eine Queue entspricht einer Warteschlange, in der sich Jobs (Flow-Ausführungen) befinden.

Je nach Konfiguration werden die Jobs:

• nacheinander abgearbeitet (seriell)

• gleichzeitig ausgeführt (parallel)

Queues ermöglichen es außerdem, dass Flows auf unterschiedlichen Warteschlangen laufen und sich dadurch nicht gegenseitig blockieren.

Beispiel:

Queue	Worker	Ergebnis
high	5	Bis zu 5 Jobs parallel
low	1	Nur ein Job gleichzeitig

Flows auf verschiedenen Queues beeinflussen sich nicht gegenseitig.

---

3. Verwaltung von Queues

Queues werden über das Menü verwaltet:

Einstellungen → Queues

Dort sind alle vorhandenen Queues gelistet.

3.1 Neue Queue anlegen

Über „Hinzufügen“ können neue Queues erstellt werden.

Folgende Eigenschaften stehen zur Verfügung:

Einstellung	Beschreibung
Name	Bezeichnung der Queue
Projekt	Zuordnung zu einem Projekt
Aktiv	Gibt an, ob die Queue verwendet werden kann
Worker	Anzahl paralleler Jobs

---

4. Worker-Konfiguration

Der Worker-Wert definiert, wie viele Jobs parallel in dieser Queue ausgeführt werden dürfen.

4.1 Bedeutung der Worker

• Worker = 1

  → Es wird immer nur ein Job gleichzeitig ausgeführt.

  → Geeignet für Entitäten, die sequenziell verarbeitet werden müssen (z. B. abhängig voneinander).

• Worker > 1

  → Mehrere Jobs können gleichzeitig ausgeführt werden.

  → Sinnvoll, wenn Jobs unabhängig sind und parallel verarbeitet werden dürfen.

4.2 Beispiel

• Queue low, Worker = 1

  → Nur ein Auftrag wird zur selben Zeit verarbeitet.

• Queue test, Worker = 5

  → Bis zu fünf Aufträge können parallel laufen.

---

5. Queue-Zuweisung im Flow

Die Queue kann auf Flow-Ebene definiert werden.

Flow bearbeiten → Konfiguration → Queue auswählen

Ein Flow wird immer in der hier eingestellten Queue ausgeführt – sofern die Queue aktiv ist.

Hinweis:

Ist eine Queue deaktiviert, kann der Flow nicht ausgeführt werden. Dies führt zu Fehlermeldungen im Journal oder beim Start.

---

6. Verhalten beim Flow-Test

Im Flow-Editor stehen zwei unterschiedliche Ausführungsmodi zur Verfügung:

Modus	Verhalten
Testen	Der Flow wird direkt ausgeführt – ohne über eine Queue zu laufen.
Starten	Der Flow wird in die konfigurierte Queue eingereiht und wie ein normaler Flow ausgeführt.

Dies ist wichtig, wenn die parallele/serielle Ausführung realistisch geprüft werden soll.

---

7. Reporting und Kontrolle

Nach der Ausführung eines Flows können Queue-Informationen im Reporting nachvollzogen werden:

Journal / Detail-Reporting

Hier wird u. a. angezeigt:

• welche Queue verwendet wurde

• Zeitpunkt der Ausführung

• Erfolg oder Fehler eines Jobs

Dies ermöglicht eine klare Trennung und Diagnose bei parallelen oder sequentialen Abläufen.

---

8. Best Practices

• Flows trennen, die unabhängig laufen können

  → z. B. Produktupdates parallel, aber Bestellimport seriell.

• Mindestens eine Queue mit Worker = 1 verwenden

  → Für sequenzielle, empfindliche Vorgänge.

• Queue immer aktiv halten

  → Inaktive Queues führen zu Ausführungsfehlern.

• Testmodus bewusst nutzen

  → „Testen“ ignoriert die Queue – daher für echte Performancetests „Starten“ verwenden.

---