Skip to Content
CLIEngine-Befehlepc engine send-signal

pc engine send-signal

Sendet ein Signal-Event an die verbundene Engine — optional gezielt an eine bestimmte Prozessinstanz.

Im Gegensatz zu Messages (1:1) erreichen Signale alle Prozesse, die auf das Signal warten (1:n) — etwa Signal-Intermediate-Catch-Events oder Signal-Start-Events.

Verwendung

pc engine send-signal <signalName> [options] pc engine sig <signalName> [options]

Argumente

NameObligatorischBeschreibung
signalNameJaName des zu sendenden Signals

Optionen

Name, KürzelDefaultBeschreibung
--process-instance-idSendet das Signal nur an die angegebene Prozessinstanz
--correlation-idSetzt eine eigene Correlation ID für das Signal (erfordert Engine v19.2.0)
--payloadSetzt den Signal-Payload aus einem JSON-String
--payload-from-fileLiest den Signal-Payload als JSON aus einer Datei
--payload-from-stdinLiest den Signal-Payload als JSON von STDIN
--output, -otextSteuert das Ausgabeformat: text oder json

Beispiele

Signal senden

pc engine send-signal SystemMaintenance

Signal mit Payload senden

pc engine send-signal SystemMaintenance --payload '{"reason": "planned"}'

Signal an eine bestimmte Prozessinstanz senden

pc engine send-signal SystemMaintenance --process-instance-id <ID>

Als Eingabe-Format wird JSON5  verwendet, dessen Regeln weniger strikt sind als bei normalem JSON (z.B. erlaubt JSON5 Kommentare). Die Ausgabe der CLI ist immer striktes, standardkonformes JSON.