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 (vergleiche Erstellen von Workflow-Modellen).
Die folgenden Merkmale werden für jeden Prozessschritt beschrieben.
Prozessschritte werden entweder durch eine Java-Klasse oder ein ECMAScript definiert.
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.
Meistens 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.
Einige Workflow-Prozesse akzeptieren Argumente, die 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 */
Nach einer gewissen Zeitüberschreitung funktioniert der Workflow-Schritt nicht mehr. Einige Workflow-Prozesse respektieren die Zeitüberschreitung, für andere gilt sie nicht und wird daher ignoriert.
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, einen Dienstbenutzer mit einer minimalen Untergruppe der erforderlichen Berechtigungen zu verwenden.
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 uneingeschränkter Zugriff auf das gesamte Repository eingeräumt wird.
Die folgenden Prozesse wirken sich nicht auf Inhalte aus. Sie dienen der Steuerung des Workflows.
Der Prozess AbsoluteTimeAutoAdvancer
(automatisches Voranschreiten für absolute Uhrzeit) verhält sich wie AutoAdvancer. Ausnahme ist, dass die Zeitüberschreitung nach einer bestimmten Zeit und einem gewissen Datum anstelle einer entsprechenden Dauer eintritt.
com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
Der AutoAdvancer
-Prozess bringt den Workflow automatisch zum nächsten Schritt. Falls mehr als nur ein nächster Schritt möglich ist (beispielsweise bei einer ODER-Teilung), bringt der Prozess den Workflow auf der Standardroute voran. Wurde keine Standardroute festgelegt, wird der Workflow nicht vorangebracht.
Java-Klasse: com.adobe.granite.workflow.console.timeout.autoadvance.AutoAdvancer
Payload: Keine.
Argumente: Keine.
Zeitüberschreitung: Nach einem festgelegtem Zeitraum.
Der ProcessAssembler
-Prozess führt mehrere Teilprozesse nacheinander in einem einzigen Workflow-Schritt aus. Erstellen Sie für die Nutzung des ProcessAssembler
-Prozesses einen einzelnen entsprechenden Schritt im Workflow und legen Sie die Argumente so fest, dass sie die Namen und Argumente der auszuführenden Teilprozesse angeben.
Java-Klasse: com.day.cq.workflow.impl.process.ProcessAssembler
Payload: DAM-Asset, AEM-Seite oder keine Payload (je nach Anforderungen der Teilprozesse).
Argumente:
args := arg [',' arg]
arg := processname ['::' processargs]
processname := /* A fully qualified Java Class or absolute
repository path to an ECMAScript */
processargs := processarg [';' processarg]*
processarg := '[' nobracketprocessarg ']' | nobracketprocessarg
nobracketprocessarg := listitem [':' listitem]*
listitem := /* A string */
Beispiel:
com.day.cq.dam.core.process.ExtractMetadataProcess,
com.day.cq.dam.core.process.CreateThumbnailProcess::[140:100];[48:48];[319:319:false],
com.day.cq.dam.core.process.CreateWebEnabledImageProcess::dimension:1280:1280;mimetype:image/jpeg,
com.day.cq.dam.core.process.AssetSetLastModifiedProcess
Die folgenden Prozesse führen einfache Aufgaben durch oder dienen als Beispiel.
Sie dürfen keinerlei Änderungen im Pfad /libs
vornehmen,
da der Inhalt von /libs
überschrieben wird, wenn Sie die Instanz das nächste Mal upgraden. (Außerdem kann der Inhalt auch durch Anwenden von Hotfixes oder Feature Packs überschrieben werden.)
Das Element unter dem angegebenen Pfad wird gelöscht.
ECMA-Skript-Pfad: /libs/workflow/scripts/delete.ecma
Payload: JCR-Pfad
Argumente: Keine
Zeitüberschreitung: Ignoriert
Dies ist der Null-Prozess. Es wird kein Vorgang ausgeführt, jedoch eine Debugmeldung protokolliert.
ECMA-Skript-Pfad: /libs/workflow/scripts/noop.ecma
Payload: Keine
Argumente: Keine
Zeitüberschreitung: Ignoriert
Dies ist ein Null-Prozess, der false
für die check()
-Methode zurückgibt.
ECMA-Skript-Pfad: /libs/workflow/scripts/rule-false.ecma
Payload: Keine
Argumente: Keine
Zeitüberschreitung: Ignoriert
Ein Muster-ECMAScript-Prozess.
ECMA-Skript-Pfad: /libs/workflow/scripts/sample.ecma
Payload: Keine
Argumente: Keine
Zeitüberschreitung: Ignoriert
Einfacher Workflow-Prozess, der die angegebene URL aufruft. Für gewöhnlich ist die URL ein Verweis auf ein JSP (oder ein anderes entsprechendes Servlet), das eine einfache Aufgabe ausführt. Dieser Prozess sollte nur während der Entwicklung und für Demonstrationen verwendet werden, nicht in einer Produktionsumgebung. Die Argumente legen die URL, die Anmeldedaten und das Kennwort fest.
ECMA-Skript-Pfad: /libs/workflow/scripts/urlcaller.ecma
Payload: Keine
Argumente:
args := url [',' login ',' password]
url := /* The URL to be called */
login := /* The login to access the URL */
password := /* The password to access the URL */
Beispiel: http://localhost:4502/my.jsp, mylogin, mypassword
Sperrt die Payload des Workflows.
Java-Klasse: com.day.cq.workflow.impl.process.LockProcess
Payload: JCR_PATH und JCR_UUID
Argumente: Keine
Zeitüberschreitung: Ignoriert
Unter folgenden Bedingungen ist der Schritt nicht wirksam:
Entsperrt die Payload des Workflows.
Java-Klasse: com.day.cq.workflow.impl.process.UnlockProcess
Payload: JCR_PATH und JCR_UUID
Argumente: Keine
Zeitüberschreitung: Ignoriert
Unter folgenden Bedingungen ist der Schritt nicht wirksam:
Der folgende Prozess führt eine versionsbezogene Aufgabe aus.
Erstellt eine neue Version der Workflow-Payload (AEM-Seite oder DAM-Asset).
Java-Klasse: com.day.cq.wcm.workflow.process.CreateVersionProcess
Payload: JCR-Pfad oder UUID, der auf eine Seite oder ein DAM-Asset verweist
Argumente: Keine
Zeitüberschreitung: Berücksichtigt