Engine Nodes Referenz

Diese Referenz dokumentiert alle Engine Nodes, die fuer die Integration von Node-RED-Flows mit der Engine verfuegbar sind.

processcube-engine-config

Kategorie: Konfiguration

Die zentrale Konfigurationsnode fuer die Engine-Verbindung. Sie wird von allen anderen Engine Nodes referenziert.

process-start

Kategorie: Prozesssteuerung

Startet eine neue Prozessinstanz in der Engine.

Konfiguration:

Input (msg):

Output (msg):

Beispiel:

// Prozess mit Startparametern starten
msg.payload = {
    customerName: "Max Mustermann",
    orderId: "ORD-2025-001",
    priority: "high"
};

process-terminate

Kategorie: Prozesssteuerung

Beendet eine laufende Prozessinstanz in der Engine.

Konfiguration:

Input (msg):

Output (msg):

usertask-input

Kategorie: UserTask

Sucht nach UserTasks auf der Engine und gibt diese zur Bearbeitung in Node-RED aus.

Konfiguration:

Input (msg):

Output (msg):

usertask-output

Kategorie: UserTask

Sendet das Ergebnis eines bearbeiteten UserTasks an die Engine zurueck.

Konfiguration:

Input (msg):

Beispiel:

// UserTask-Ergebnis senden
msg.payload = {
    approved: true,
    comment: "Freigabe erteilt",
    approvedBy: "admin"
};

usertask-event-listener

Kategorie: Events

Abonniert Events, die sich auf UserTasks beziehen.

Konfiguration:

Output (msg):

{
    "flowNodeInstanceId": "...",
    "userTaskEvent": { /* Event-Details */ },
    "userTask": { /* UserTask-Instanzobjekt */ },
    "action": "new",
    "type": "usertask"
}

process-event-listener

Kategorie: Events

Abonniert prozessbezogene Events der Engine.

Konfiguration:

Verfuegbare Events:

Output (msg):

{
    "processInstanceId": "...",
    "action": "started",
    "type": "process"
}

externaltask-input

Kategorie: External Task

Erstellt eine Subscription fuer External Tasks mit einem bestimmten Topic, lockt diese und gibt sie zur Abarbeitung in Node-RED aus.

Konfiguration:

Output (msg):

Umgebungsvariablen:

externaltask-output

Kategorie: External Task

Sendet das Ergebnis einer in Node-RED bearbeiteten External Task an die Engine zurueck.

Input (msg):

externaltask-error

Kategorie: External Task

Meldet einen Fehler bei der Verarbeitung einer External Task an die Engine.

Konfiguration:

Input (msg):

Beispiel-Flow:

[externaltask-input: Topic "pdf-erstellen"]
    → [function: PDF generieren]
        → (Erfolg) → [externaltask-output]
        → (Fehler) → [externaltask-error: Code "PDF_GENERATION_FAILED"]

externaltask-event-listener

Kategorie: Events

Abonniert Events, die sich auf External Tasks beziehen.

Konfiguration:

Output (msg):

{
    "flowNodeInstanceId": "...",
    "externalTaskEvent": { /* Event-Daten */ },
    "action": "created",
    "type": "externaltask"
}

processdefinition-query

Kategorie: Abfragen

Sucht auf der Engine nach Prozessdefinitionen oder Prozessmodellen.

Konfiguration:

Input (msg):

Output (msg):

processinstance-query

Kategorie: Abfragen

Sucht auf der Engine nach Prozessinstanzen.

Konfiguration:

Input (msg):

Output (msg):

signal-event-trigger

Kategorie: Events

Loest ein Signal-Event in der Engine aus.

Konfiguration:

Input (msg):

Output (msg):

message-event-trigger

Kategorie: Events

Loest ein Message-Event in der Engine aus.

Konfiguration:

Input (msg):

Output (msg):

dataobject-instance-query

Kategorie: Abfragen

Fragt DataObject-Instanzen auf der Engine ab. DataObjects sind Datenobjekte, die innerhalb eines BPMN-Prozesses definiert sind.

Konfiguration:

Input (msg):

Output (msg):

check-authorization

Kategorie: Autorisierung

Prueft, ob der aktuelle Benutzer eine bestimmte Berechtigung besitzt.

Konfiguration:

Input (msg):

Output (msg):

Weiterführende Informationen

• ProcessCube® Konzepte — Engine-Integration verstehen
• UI Nodes Referenz — UI-Komponenten
• Workflow-Integration — Praxisbeispiele