Prozessreferenz für Workflows workflow-process-reference

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

AEM bietet mehrere Prozessschritte, die zum Erstellen von Workflow-Modellen verwendet werden können. Benutzerdefinierte Prozessschritte können auch für Aufgaben hinzugefügt werden, die nicht von den integrierten Schritten abgedeckt werden (siehe Erstellen von Workflow-Modellen).

Prozessmerkmale process-characteristics

Für jeden Prozessschritt werden die folgenden Eigenschaften beschrieben.

Java-Klasse oder ECMA-Pfad java-class-or-ecma-path

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

  • Für die Java-Klassenprozesse wird der vollständig qualifizierte Klassenname bereitgestellt.
  • Für die ECMAScript-Prozesse wird der Pfad zum Skript bereitgestellt.

Payload 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.

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.

Argumente arguments

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

Argumente werden als einzelne Zeichenfolge in der Prozess-Argumente -Eigenschaft in Eigenschaften -Bereich des Workflow-Editors. Für jeden unten beschriebenen Prozess wird das Format der Argumentzeichenfolge in einer einfachen EBNF-Grammatik beschrieben. 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 */

Zeitüberschreitung timeout

Nach dieser Zeitüberschreitung ist der Workflow-Schritt nicht mehr funktionsfähig. Einige Workflow-Prozesse berücksichtigen den Timeout-Wert, während er für andere nicht gilt und ignoriert wird.

Berechtigungen permissions

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.

Die empfohlene Vorgehensweise ist die Verwendung eines Dienstbenutzers, der mit der erforderlichen, jedoch minimalen Untergruppe von Berechtigungen erstellt wurde.

CAUTION
Wenn Sie ein Upgrade von einer Version vor AEM 6.2 durchführen, müssen Sie möglicherweise 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 jetzt wie oben definiert (Berechtigungen). Dies ist die empfohlene Methode für die Aktualisierung 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.

Workflow-Kontrollprozesse workflow-control-processes

Die folgenden Prozesse führen keine Aktionen für Inhalte durch. Sie dienen der Steuerung des Workflows.

AbsoluteTimeAutoAdvancer (automatisches Voranschreiten für absolute Uhrzeit) absolutetimeautoadvancer-absolute-time-auto-advancer

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.

  • Java-Klasse: com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
  • Payload: Keine.
  • Argumente: Keine.
  • Zeitüberschreitung: Zeitüberschreitung nach festgelegter Zeit und festgelegtem Datum.

AutoAdvancer (Auto-Advancer) autoadvancer-auto-advancer

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.

ProcessAssembler (Prozess-Assembler) processassembler-process-assembler

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 */
  • Zeitüberschreitung: Berücksichtigt.

Beispiel:

  • Extrahieren Sie die Metadaten aus dem Asset.
  • Erstellen Sie drei Miniaturansichten der drei angegebenen Größen.
  • Erstellen Sie ein JPEG-Bild aus dem Asset, vorausgesetzt das Asset ist ursprünglich weder ein GIF noch ein PNG (in diesem Fall wird keine JPEG erstellt).
  • Legen Sie das Datum der letzten Änderung für das Asset fest.
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

Grundlegende Prozesse basic-processes

Die folgenden Prozesse führen einfache Aufgaben durch oder dienen als Beispiel.

CAUTION
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.)

Löschen Sie delete

Das Element am angegebenen Pfad wird gelöscht.

  • ECMA-Skript-Pfad: /libs/workflow/scripts/delete.ecma

  • Payload: JCR-Pfad

  • Argumente: Keine

  • Zeitüberschreitung: Ignoriert

noop noop

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

rule-false rule-false

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

sample sample

Dies ist ein Beispiel für einen ECMAScript-Prozess.

  • ECMA-Skript-Pfad: /libs/workflow/scripts/sample.ecma

  • Payload: Keine

  • Argumente: Keine

  • Zeitüberschreitung: Ignoriert

urlcaller urlcaller

Dies ist ein einfacher Workflow-Prozess, der die angegebene URL aufruft. Normalerweise ist die URL ein Verweis auf eine JSP (oder ein anderes Servlet-Äquivalent), die eine einfache Aufgabe ausführt. Dieser Prozess sollte nur während der Entwicklung und Demonstrationen und nicht in einer Produktionsumgebung verwendet werden. Die Argumente geben die URL, die Anmeldung und das Kennwort an.

  • 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

  • Zeitüberschreitung: Ignoriert

LockProcess lockprocess

Sperrt die Payload des Workflows.

  • Java-Klasse: com.day.cq.workflow.impl.process.LockProcess

  • Payload:  JCR_PATH und JCR_UUID

  • Argumente: Keines

  • Zeitüberschreitung: Ignoriert

Der Schritt hat unter folgenden Umständen keine Auswirkungen:

  • Die Payload wurde bereits gesperrt
  • Der Payload-Knoten enthält keinen untergeordneten jcr:content-Knoten

UnlockProcess unlockprocess

Entsperrt die Payload des Workflows.

  • Java-Klasse: com.day.cq.workflow.impl.process.UnlockProcess

  • Payload:  JCR_PATH und JCR_UUID

  • Argumente: Keines

  • Zeitüberschreitung: Ignoriert

Der Schritt hat unter folgenden Umständen keine Auswirkungen:

  • Die Payload wurde bereits entsperrt
  • Der Payload-Knoten enthält keinen untergeordneten jcr:content-Knoten

Versionierungsprozesse versioning-processes

Der folgende Prozess führt eine versionsbezogene Aufgabe aus.

CreateVersionProcess createversionprocess

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

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e