`pc list-process-instances`

Listet, sortiert und filtert Prozessinstanzen von der verbundenen Engine nach Datum, Status, Prozessmodell und/oder Korrelation.

Erlaubt die Ver-UND-ung und Ver-ODER-ung dieser Filter durch Piping.

Verwendung


pc list-process-instances [options]
pc lsi [options]

Argumente

keine

Filter-Optionen

Name, Kürzel	Default	Beschreibung
`--created-after`		Nur Instanzen anzeigen, die nach dem angegebenen Zeitpunkt erstellt wurden
`--created-before`		Nur Instanzen anzeigen, die vor dem angegebenen Zeitpunkt erstellt wurden
`--completed-after`		Nur Instanzen anzeigen, die nach dem angegebenen Zeitpunkt abgeschlossen wurden
`--completed-before`		Nur Instanzen anzeigen, die vor dem angegebenen Zeitpunkt abgeschlossen wurden
`--completed-in`		Nur Instanzen anzeigen, die innerhalb der angegebenen Zeitspanne abgeschlossen wurden
`--filter-by-correlation-id`		Nach Correlation ID filtern
`--filter-by-process-model-id`		Nach Prozessmodell-ID filtern (unterstützt reguläre Ausdrücke)
`--filter-by-state`		Nach Status filtern: `running`, `finished` oder `error`
`--reject-by-process-model-id`		Nach Prozessmodell-ID ausschließen (unterstützt reguläre Ausdrücke)
`--reject-by-state`		Nach Status ausschließen: `running`, `finished` oder `error`

Sortier-Optionen

Name, Kürzel	Default	Beschreibung
`--sort-by-created-at`		Sortiert nach Erstellungszeitpunkt: `asc` oder `desc`
`--sort-by-process-model-id`		Sortiert nach Prozessmodell-ID: `asc` oder `desc`
`--sort-by-state`		Sortiert nach Status: `asc` oder `desc`
`--limit`		Listet maximal die gegebene Anzahl Prozessinstanzen

Ausgabe-Optionen

Name, Kürzel	Default	Beschreibung
`--output, -o`	`text`	Steuert das Ausgabeformat: `text` oder `json`

Beispiele

Alle Instanzen auflisten


pc list-process-instances

Filter nach Zeitpunkten

Filter nach Startzeitpunkt akzeptieren das Format YYYY-MM-DD:


pc list-process-instances --created-after "2024-01-01" --created-before "2024-01-31"

Filter nach Endzeitpunkt:


pc list-process-instances --completed-after "2024-01-01" --completed-before "2024-10-31"

Filter nach Dauer

Filter nach Ausführungsdauer für die Zeiteinheiten Tage (d), Stunden (h), Minuten (m) oder Sekunden (s):


# Instanzen, die länger als eine Stunde brauchten
pc list-process-instances --completed-in "> 1h"
 
# Instanzen, die weniger als 45 Minuten brauchten
pc list-process-instances --completed-in "< 45m"

Die Zeiteinheiten sind nicht kombinierbar: > 1h 30m funktioniert nicht, verwenden Sie stattdessen > 90m.

Filter nach Status


# Alle fehlgeschlagenen Instanzen
pc list-process-instances --filter-by-state error
 
# Laufende oder abgeschlossene Instanzen
pc list-process-instances --filter-by-state running --filter-by-state finished

Filter nach Prozessmodell

Die Filterung unterstützt Wortteile und reguläre Ausdrücke:


# Alle Instanzen mit "Registration" in der Prozessmodell-ID
pc list-process-instances --filter-by-process-model-id "Registration"
 
# Alle Instanzen, deren Prozessmodell-ID mit "Registration" anfängt
pc list-process-instances --filter-by-process-model-id "^Registration.+$"

Ver-ODER-ung und Ver-UND-ung

Mehrere verkettete Filter-Optionen entsprechen einer ODER-Verknüpfung:


pc list-process-instances --filter-by-state error --filter-by-state finished

Das Ergebnis zu Pipen führt zu einer UND-Verknüpfung:


pc list-process-instances --filter-by-process-model-id "Registration" \
| pc list-process-instances --filter-by-process-model-id "Email"

Komplexes Beispiel


pc list-process-instances --created-after "2024-01-01" --created-before "2024-01-31" \
                          --completed-in "> 1h" \
                          --filter-by-process-model-id "^Registration.+$" \
                          --reject-by-process-model-id "Internal" \
                          --filter-by-state error \
                          --filter-by-state finished \
                          --sort-by-process-model-id asc \
                          --sort-by-state desc \
                          --sort-by-created-at asc

Dieses Beispiel listet alle Prozessinstanzen, die im Januar 2024 von einem Prozessmodell mit dem Präfix Registration. gestartet wurden, deren Prozessmodell-ID nicht das Wort Internal beinhaltet, die länger als eine Stunde zum Abschluss benötigten und entweder erfolgreich oder fehlerhaft beendet wurden.