Erste Schritte

Hier wird gezeigt, welche die ersten Schritte sind, um die CLI gut nutzen zu können.

Verbindung zur Engine

Port-Konfiguration

Die Ports der Engine haben bei der Einrichtung Standardwerte für die verschiedenen Freigabekanäle:

Einstieg mit Studio

Nach dem Start des Studios ist die Studio-interne Engine-Instanz unter http://localhost:56000  verfügbar.

Um sich mit der CLI zu verbinden:

pc engine login http://localhost:56000 --root

Mit pc engine login wird eine Verbindung zu einer Engine-Instanz über die URL hergestellt.

Verkürzte Schreibweise

Die CLI nimmt als Standardprotokoll http und als Standardhost localhost. Dadurch ist auf Entwicklungssystemen eine verkürzte Schreibweise möglich:

# Vollständig
pc engine login http://localhost:56000 --root
 
# Ohne Protokoll
pc engine login localhost:56000 --root
 
# Nur Port
pc engine login :56000 --root

Verbindung zu einer Remote-Engine

Für produktive Umgebungen mit Authentifizierung:

pc engine login https://engine.processcube.io

Sie werden dann nach Ihren Zugangsdaten gefragt. Die Authority öffnet sich im Browser zur Authentifizierung.

Session-Status prüfen

Um zu prüfen, mit welcher Engine Sie verbunden sind:

pc engine session-status

Ausgabe:

Connected to: http://localhost:56000
User: root

Prozessmodelle auflisten

Um verfügbare Prozessmodelle anzuzeigen:

pc engine list-process-models

Prozess starten

Um einen Prozess zu starten:

pc engine start-process-model my_process StartEvent_1

Mit Payload:

pc engine start my_process StartEvent_1 --start-token '{"orderId": "12345"}'

Prozessinstanz inspizieren

Um die Details einer gestarteten Prozessinstanz anzuzeigen:

pc engine show-process-instance <processInstanceId>

Die Ausgabe enthält den Status, die FlowNode-Instanzen und deren Verlauf. Die processInstanceId erhalten Sie aus der Ausgabe von start-process-model oder list-process-instances.

Prozessinstanzen auflisten

Um laufende Prozessinstanzen anzuzeigen:

pc engine list-process-instances

Für ein bestimmtes Prozessmodell:

pc engine list-process-instances --filter-by-process-model-id my_process

BPMN-Diagramme deployen

Um BPMN-Diagramme zu deployen:

pc engine deploy-files ./diagrams/**/*.bpmn

Abmelden

Um die Verbindung zu beenden:

pc engine logout

Weitere Befehle

Eine vollständige Liste aller verfügbaren Befehle finden Sie im Kapitel Engine-Befehle.

Für die Studio-Steuerung via MCP siehe Studio-Befehle.

Für AI-Skill-Verwaltung siehe AI-Skills.

Für fortgeschrittene Workflows mit Befehlsverkettung siehe Template-Pipes.