Entwickler Tutorial (Legacy)
Runtime Expressions

Runtime Expressions

Runtime Expressions ermöglichen es auf Kontext-Informationen zum laufenden Prozess zuzugreifen.

Diese können in vielen Freitextfeldern zur dynamischen Konfiguration von Elementen verwendet werden - z. B. Form Fields von User Task oder Payloads von External Service Tasks.

Verwendung von Runtime Expressions

An Eingabe-Feldern im Studio ist angegeben, ob Runtime Expressions unterstützt werden und wie diese zu benutzen sind. Es gibt zwei Arten von Runtime Expressions, die im Folgenden erklärt werden.

  • x.y - dieser Hinweis zeigt, dass in dem Eingabefeld Runtime Expressions als Parameter eines JavaScript basierten Scripts verwendet werden können.


    Zum Beispiel ist es möglich im Feld Payload eines External Service Task token.current.myDepartment zu nutzen, um die vom Task abgeschickten Daten mit Informationen aus dem aktuellen Prozess Token anzureichern.

    {
      abteilungen: token.current.meineAbteilungen
    }
  • ${} - dieser Hinweis signalisiert einen Template-String, in welchem Runtime Expressions mit einem umschließenden ${} in den String gegeben werden können.


    Zum Beispiel im Label vom Form Field eines User Tasks wird eine Runtime Expression so genutzt:

    Antrag für ${dataObjects.userData.displayName}

    Das Label enthält nun einen statischen ("Antrag für ") und einen dynamischen Teil - den Namen des Nutzers, der zuvor in einem Data Object abgespeichert wurde. Falls dieser Max heißen würde, wäre der Inhalt des Labels nun "Antrag für Max".

Verfügbare Runtime Expressions

Folgende Runtime Expression Parameter sind verfügbar:

  • engine.id - Die ID der Engine
  • engine.name - Der Name der Engine
  • environment.PROPERTY - etwaige unter dem Konfigurationsabschnitt extraInfo definierte Werte
  • token.current - Das aktuelle Prozess Token als JSON Objekt
  • token.history.FLOW_NODE_ID - Das End Token, das von einer ausgeführten Flow Node erstellt wurde (FLOW_NODE_ID ist die Element-ID des BPMN Elements)
  • currentFlowNode - Die aktuell ausgeführte Flow Node mit allen ihren Eigenschaften
  • flowNodeExecutionCount - Die Anzahl, wie oft die Flow Node in der Prozessinstanz ausgeführt wurde
  • dataObjects.DATA_OBJECT_ID - Der Inhalt eines bestimmten Data Object (DATA_OBJECT_ID ist die Element-ID des Data Object)
  • currentDataObject - Nur in Data Source Expressions von Data Objects verfügbar. Erlaubt die Verwendung der aktuellen Daten des Data Objects, um diese in der Expression wiederverwenden zu können
  • correlationMetadata.METADATA_NAME - Ein bestimmter Wert aus den Metadaten der Correlation
  • correlationId - Die aktuelle Correlation-Id
  • processInstanceMetadata.METADATA_ID - Ein bestimmter Wert aus den Metadaten der Prozessinstanz
  • processModelVersion - Die im BPMN annotierte Version des ausgeführten Prozesses
    • Anmerkung: Mit dem 2025.1 Release wird diese durch das processModel Objekt substituiert. Dieses bietet mehr Möglichkeiten und sollte daher bevorzugt verwendet werden
  • processModel.id - Die ID des ausgeführten Prozesses
  • processModel.name - Der eingetragene Name des ausgeführten Prozesses
  • processModel.version - Die im BPMN annotierte Version des ausgeführten Prozesses
  • processModel.definitionId - Die ID der Definition, die den Prozess beinhaltet
  • processModel.definitionHash - Der Hash der Definition, die den Prozess beinhaltet
  • identity.token - Der aktuelle Authentifizierungstoken
  • identity.userId - Die Benutzer-ID
  • identity.userToken - Der aktuelle Authentifizierungstoken. Synonym zu identity.token
  • identity.claims.CLAIM_NAME - Beinhaltet die Berechtigungen des Benutzers (CLAIM_NAME ist ein Berechtigungsname, der true zurückgibt, falls die Berechtigung vorhanden ist)

Downloads

Prozesse