Prozessreferenz für Workflows

Letzte Aktualisierung: 18. April 2024
  • Gilt für:
  • Experience Manager 6.5

Erstellt für:

  • Entwickler

AEM bietet verschiedene Prozessschritte für die Erstellung von Workflow-Modellen. Darüber hinaus können auch benutzerdefinierte Prozessschritte für Aufgaben hinzugefügt werden, die nicht von den integrierten Schritten abgedeckt werden (siehe Erstellen von Workflow-Modellen).

Prozessmerkmale

Die folgenden Merkmale werden für jeden Prozessschritt beschrieben.

Java™-Klasse oder ECMA-Pfad

Prozessschritte werden entweder durch eine Java™-Klasse oder ein ECMAScript definiert.

  • Für die Java™-Klassenprozesse wird der vollqualifizierte Klassenname angegeben.
  • Bei ECMAScript-Prozessen wird der Pfad des Skripts angegeben.

Payload

Die Payload ist die Entität, auf die die Workflow-Instanz reagiert. Die Payload wird implizit durch den Kontext ausgewählt, in dem eine Workflow-Instanz gestartet wird.

Wenn beispielsweise ein Workflow auf die AEM-Seite P angewendet wird, durchläuft P bei fortlaufendem Workflow die verschiedenen Schritte. Dabei wirkt sich jeder Schritt optional in irgendeiner Weise auf P aus.

Meist besteht die Payload aus einem JCR-Knoten im Repository (beispielsweise eine AEM-Seite oder ein AEM-Asset). Eine JCR-Knoten-Payload wird als Zeichenfolge übergeben, die entweder aus einem JCR-Pfad oder einer JCR-Kennung besteht (UUID). Manchmal ist die Payload eine JCR-Eigenschaft (sie wird dann als JCR-Pfad übergeben), eine URL, ein Binärobjekt oder ein generisches Java™-Objekt. Einzelne Prozessschritte, die auf die Payload reagieren, erwarten in der Regel einen bestimmten Typ Payload oder verhalten sich je nach Payload-Typ anders. Der erwartete Payload-Typ (falls vorhanden) wird für jeden der unten beschriebenen Prozesse angegeben.

Argumente

Einige Workflow-Prozesse akzeptieren Argumente, die die Administratorin oder der Administrator beim Einrichten des Workflow-Schritts angibt.

Argumente werden als einzelne Zeichenfolge im Bereich Eigenschaften des Workflow-Editors in der Eigenschaft Prozess-Argumente angegeben. Das Format der Argumentzeichenfolge wird für jeden unten beschriebenen Prozess in einfacher EBNF-Grammatik angegeben. Im folgenden Beispiel besteht die Argumentzeichenfolge aus einem oder mehreren durch Kommas getrennten Paaren. Jedes Paar besteht aus einem Namen (einer Zeichenfolge) und einem Wert, die durch einen zweifachen Doppelpunkt getrennt werden:

    args := name '::' value [',' name '::' value]*
    name := /* A string */
    value := /* A string */

Maximale Wartezeit

Nach dieser maximalen Wartezeit funktioniert der Workflow-Schritt nicht mehr. Einige Workflow-Prozesse respektieren die maximale Wartezeit, für andere gilt sie nicht und wird daher ignoriert.

Berechtigungen

Die Sitzung, die an den WorkflowProcess übergeben wird, wird durch den Dienstbenutzer für den Workflow-Prozessdienst gestützt, der über folgende Berechtigungen am Stamm des Repositorys verfügt:

  • jcr:read
  • rep:write
  • jcr:versionManagement
  • jcr:lockManagement
  • crx:replicate

Wenn dieser Berechtigungssatz nicht ausreichend für die WorkflowProcess-Implementierung ist, muss auf eine Sitzung mit den erforderlichen Berechtigungen zurückgegriffen werden.

Hierfür wird empfohlen, eine Dienstbenutzerin oder einen Dienstbenutzer mit einer minimalen Teilmenge der erforderlichen Berechtigungen einzusetzen.

CAUTION
Wenn Sie ein Upgrade von einer früheren Version auf AEM 6.2 durchführen, müssen Sie möglicherweise auch Ihre Implementierung aktualisieren.
In den vorherigen Versionen wurde die Adminsitzung an die WorkflowProcess-Implementierungen übergeben. Danach war der uneingeschränkte Zugriff auf das Repository ohne Definition der spezifischen ACLs möglich.
Die Berechtigungen werden nun wie oben dargestellt definiert (Berechtigungen). Dasselbe gilt für die empfohlene Methode zum Aktualisieren Ihrer Implementierung.
Wenn Code-Änderungen nicht praktikabel sind, steht eine kurzfristige Lösung für die Abwärtskompatibilität zur Verfügung:

  • Öffnen Sie die Web-Konsole (/system/console/configMgr) und suchen Sie nach dem Adobe Granite Workflow-Konfigurationsdienst.

  • Aktivieren Sie den Legacymodus des Workflow-Prozesses.

Dadurch wird das bisherige Verhalten wieder aktiviert, nach dem eine Adminsitzung an die WorkflowProcess-Implementierung übergeben und wieder uneingeschränkter Zugriff auf das gesamte Repository eingeräumt wird.