Referenz für Workflow-Schritte workflow-step-reference

Workflow-Modelle beinhalten eine Reihe von Schritten unterschiedlichen Typs. Je nach Typ können diese Schritte konfiguriert und mit Parametern und Skripten erweitert werden, um die benötigten Funktionen und Steuerungsmöglichkeiten bereitzustellen.

Schritt-Eigenschaften step-properties

Jede Schrittkomponente beinhaltet ein Dialogfeld Schritt-Eigenschaften, in dem Sie die erforderlichen Eigenschaften definieren und bearbeiten können.

Schritteigenschaften – Registerkarte „Allgemein“ step-properties-common-tab

Eine Kombination der folgenden Eigenschaften ist für die meisten Workflow-Schrittkomponenten im Eigenschaften-Dialogfeld auf der Registerkarte Allgemein verfügbar:

Schritteigenschaften – Registerkarte „Benutzer/Gruppe“ step-properties-user-group-tab

Die folgenden Eigenschaften sind für viele Workflow-Schrittkomponenten auf der Registerkarte Benutzer/Gruppe des Eigenschaftendialogfelds verfügbar:

UND-Teilung and-split

Mit der  UND-Teilung wird der Workflow unterteilt und beide Verzweigungen werden aktiviert. Sie fügen jeder Verzweigung nach Bedarf Workflow-Schritte hinzu. In diesem Schritt können Sie mehrere Verarbeitungspfade in den Workflow einführen. Sie können beispielsweise zulassen, dass bestimmte Überprüfungsschritte parallel ausgeführt werden und so Zeit sparen.

UND-Teilung – Konfiguration and-split-configuration

So konfigurieren Sie die Aufspaltung:

Container-Schritt container-step

Ein Container-Schritt startet ein anderes Workflow-Modell, das als untergeordneter Workflow ausgeführt wird.

Mit diesem Container können Sie Workflow-Modelle wiederverwenden, um häufig verwendete Schrittfolgen zu implementieren. Beispielsweise kann ein Übersetzung-Workflow-Modell in mehreren Bearbeitung-Workflows verwendet werden.

Container-Schritt – Konfiguration container-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Zum Schritt wechseln goto-step

Die Option Zum Schritt wechseln ermöglicht Ihnen, den nächsten Schritt anzugeben, der im Workflow-Modell ausgeführt werden soll. Sie können eine Regeldefinition, ein externes Skript oder ein ECMA-Skript als Routing-Ausdruck angeben, um den nächsten Schritt für das Workflow-Modell zu bewerten.

Mit Zum Schritt wechseln können Sie erweiterte Routingstrukturen im Workflow-Modell implementieren. Um z. B. eine Schleife zu implementieren, kann Zum Schritt wechseln  so definiert werden, dass im Workflow ein vorheriger Schritt ausgeführt wird und der Routing-Ausdruck eine Schleifenbedingung auswertet.

Zum Schritt wechseln – Konfiguration goto-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Simulieren einer for-Schleife simulating-a-for-loop

Zur Simulation einer „for-Schleife“ müssen Sie die Anzahl der aufgetretenen Schleifeniterationen zählen:

Um beispielsweise einen Workflow zu implementieren, der eine Aktion auf mehreren JCR-Knoten ausführt, können Sie einen Schleifenzähler als Index für die Knoten verwenden. Speichern Sie in der Datenzuordnung der Workflow-Instanz einen integer-Wert, um die Schleifenzahl zu speichern. Um die Anzahl zu erhöhen und die Anzahl mit dem Ausstiegskriterium zu vergleichen, verwenden Sie das Skript des Zum Schritt wechseln.

function check(){
   var count=0;
   var keyname="loopcount"
   try{
      if (workflowData.getMetaDataMap().containsKey(keyname)){
        log.info("goto script: found loopcount key");
        count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
      }

     workflowData.getMetaDataMap().put(keyname,count);

     }catch(err) {
         log.info(err.message);
         return false;
    }
   if (parseInt(count) <7){
       return true;
   } else {
      return false;
   }
}

Simulieren einer for-Schleife mithilfe der Regeldefinition simulateforloop

Sie können auch eine for-Schleife simulieren, indem Sie die Regeldefinition als Routing-Ausdruck verwenden. Erstellen Sie eine Variable count des Datentyps Long. Verwenden Sie Ausdruck als Zuordnungsmodus im Schritt Variable festlegen, um den Wert der Variable count bei jeder Ausführung des Schritts Variable festlegen auf count + 1 zu setzen.

Verwenden Sie in Zum Schritt wechseln Variable festlegen als Target-Schritt und count < 5 als Routing-Ausdruck.

Der Schritt Variable festlegen wird wiederholt ausgeführt. Dabei wird der Wert der Variablen count bei jedem Durchlauf um 1 erhöht, bis der Wert 5 erreicht.

ODER-Teilung or-split

Die ODER-Teilung erstellt eine Verzweigung im Workflow, nach der nur eine der beiden Verzweigungen aktiv bleibt. Mit diesem Schritt können Sie bedingte Verarbeitungspfade in einem Workflow einrichten. Sie fügen jeder Verzweigung nach Bedarf Workflow-Schritte hinzu.

ODER-Teilung – Konfiguration or-split-configuration

So konfigurieren Sie die Aufspaltung:

Teilnehmerschritte und Auswahlmöglichkeiten participant-steps-and-choosers

Teilnehmerschritt participant-step

Mit der Option Teilnehmer-Schritt können Sie einer bestimmten Aktion Eigentümerrechte zuweisen. Der Workflow wird nur fortgesetzt, wenn der Benutzer bzw. Benutzerin den Schritt manuell bestätigt hat. Dieser Workflow wird verwendet, wenn Sie möchten, dass jemand auf den Workflow reagiert. Zum Beispiel ein Überprüfungsschritt.

Obwohl sie nicht direkt damit im Zusammenhang steht, muss die Benutzerautorisierung beim Zuweisen einer Aktion berücksichtigt werden. Der Benutzer muss Zugriff auf die Seite mit der Workflow-Payload haben.

Teilnehmerschritt – Konfiguration participant-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Dialogfeld „Teilnehmerschritt“ dialog-participant-step

Verwenden Sie das Dialogfeld Teilnehmerschritt, um Daten des Benutzers bzw. der Benutzerin zu erfassen, dem das Arbeitselement zugewiesen wird. Dieser Schritt ist nützlich für die Erfassung kleiner Datenmengen, die später im Workflow verwendet werden.

Nach Abschluss des Schritts enthält das Dialogfeld Arbeitselement fertigstellen die Felder, die Sie für dieses Dialogfeld definiert haben. Die in den Feldern erfassten Daten werden in den Knoten der Workflow-Payload gespeichert. Nachfolgende Workflow-Schritte können dann den Wert aus dem Repository lesen.

Um den Schritt zu konfigurieren, geben Sie die Gruppe oder den Benutzer bzw. der Benutzerin an, dem bzw. der das Arbeitselement zugewiesen werden soll, sowie den Pfad zum Dialogfeld.

Dialogfeld „Teilnehmerschritt“ – Konfiguration dialog-participant-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Dialogfeld „Teilnehmerschritt“ – Erstellen eines Dialogfelds dialog-participant-step-creating-a-dialog

Beim Erstellen eines Dialogfelds müssen Sie Folgendes beachten:

Dialogfeld „Teilnehmer-Schritt“ – Speichern von Daten in der Payload dialog-participant-step-storing-data-in-the-payload

Sie können Widget-Daten in der Workflow-Payload oder in den Metadaten des Arbeitselements speichern. Das Format der name-Eigenschaft des Widget-Knotens bestimmt, wo die Daten gespeichert werden.

Dialogfeld „Teilnehmerschritt“ – Dialogfelddefinition dialog-participant-step-dialog-definition

Dynamischer Teilnehmerschritt dynamic-participant-step

Die Komponente Dynamischer Teilnehmerschritt ähnelt Teilnehmerschritt, mit dem Unterschied, dass der Teilnehmer oder die Teilnehmerin zur Laufzeit automatisch ausgewählt wird.

Rufen Sie zur Konfiguration des Schritts eine Teilnehmerauswahl auf, die Teilnehmende identifiziert, denen das Arbeitselement, zusammen mit einem Dialogfeld, zugewiesen werden soll.

Dynamischer Teilnehmerschritt – Konfiguration dynamic-participant-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Dynamischer Teilnehmerschritt – Schritt zur Entwicklung der Teilnehmerauswahl dynamic-participant-step-developing-the-participant-chooser

Sie erstellen die Teilnehmerauswahl. Daher können Sie eine beliebige Auswahllogik oder ein beliebiges Kriterium verwenden. Ihre Teilnehmerauswahl kann beispielsweise Benutzer bzw. Benutzerinnen (innerhalb einer Gruppe) mit den wenigsten Arbeitselementen auswählen. Sie können eine beliebige Anzahl von Teilnehmerauswahlen erstellen, die mit verschiedenen Vorkommen der Komponente Dynamischer Teilnehmerschritt in Ihren Workflow-Modellen verwendet werden kann.

Erstellen Sie einen OSGi-Dienst oder ein ECMAScript, das Benutzer bzw. Benutzerinnen auswählt, denen das Arbeitselement zugewiesen werden soll.

Dynamischer Teilnehmerschritt – Beispiel für einen Teilnehmerauswahldienst dynamic-participant-step-example-participant-chooser-service

Die folgende Java™-Klasse implementiert die Schnittstelle ParticipantStepChooser. Die Klasse gibt den Namen des Teilnehmers zurück, der den Workflow initiiert hat. Der Code verwendet dieselbe Logik wie das Beispielskript (initiator-participant-chooser.ecma).

Die @Property-Anmerkung setzt den Wert des SERVICE_PROPERTY_LABEL-Felds auf Workflow Initiator Participant Chooser.

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;

@Component
@Service
@Properties({
        @Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
        @Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public String getParticipant(WorkItem arg0, WorkflowSession arg1,
   MetaDataMap arg2) throws WorkflowException {

  String initiator = arg0.getWorkflow().getInitiator();
  logger.info("Assigning Dynamic Participant Step work item to {}",initiator);

  return initiator;
 }
}

Im Dialogfeld Dynamischer-Teilnehmer-Schritt enthält die Liste Teilnehmerauswahl das Element Workflow Initiator Participant Chooser (script), das für diesen Dienst steht.

Wenn das Workflow-Modell gestartet wird, wird in der Protokolldatei die ID des Benutzers angegeben, der den Workflow initiiert hat und dem das Arbeitselement zugewiesen ist. In diesem Beispiel hat der Benutzer admin den Workflow gestartet.

13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin

Formular „Teilnehmerschritt“ form-participant-step

Das Formular „Teilnehmerschritt“ zeigt beim Öffnen des Arbeitselements ein Formular an. Wenn der Benutzer das Formular ausfüllt und absendet, werden die Daten in den Knoten der Workflow-Payload gespeichert.

Um den Schritt zu konfigurieren, geben Sie die Gruppe oder den Benutzer bzw. die Benutzerin an, dem bzw. der das Arbeitselement zugewiesen werden soll, und den Pfad zum Formular.

Formular „Teilnehmerschritt“ – Konfiguration form-participant-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Formular „Teilnehmerschritt“ – Erstellen des Formulars form-participant-step-creating-the-form

Erstellen Sie wie gewohnt ein Formular mit einem Formular „Teilnehmerschritt“. Formulare für Formular „Teilnehmerschritt“ müssen wie folgt konfiguriert werden:

Die Anforderungen Ihres Workflows bestimmen, wo Felddaten gespeichert werden sollen. Beispielsweise können Felddaten verwendet werden, um die Eigenschaften des Seiteninhalts zu konfigurieren. Der folgende Wert der Eigenschaft Elementname speichert Felddaten als Wert der redirectTarget-Eigenschaft des Knotens jcr:content:

./jcr:content/redirectTarget

Im folgenden Beispiel werden die Felddaten als Inhalt einer Text-Komponente auf der Payload-Seite verwendet:

./jcr:content/par/text_3/text

Das erste Beispiel kann für eine beliebige Seite verwendet werden, die von der cq:Page-Komponente gerendert wird. Das zweite Beispiel kann nur verwendet werden, wenn die Payload-Seite eine Text-Komponente mit der ID text_3 beinhaltet.

Das Formular kann sich an einer beliebigen Stelle im Repository befinden, Workflow-Benutzer bzw. -Benutzerinnen müssen jedoch berechtigt sein, das Formular zu lesen.

Zufallsbasierte Teilnehmerauswahl random-participant-chooser

Der Schritt Zufallsbasierte Teilnehmerauswahl bezieht sich auf eine Teilnehmerauswahl, die das erzeugte Arbeitselement einem willkürlich aus einer Liste ausgewählten Benutzer zuweist.

Zufallsbasierte Teilnehmerauswahl – Konfiguration random-participant-chooser-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Workflow-Initiator-Teilnehmerauswahl workflow-initiator-participant-chooser

Der Schritt Workflow-Initiator-Teilnehmerauswahl ist eine Teilnehmerauswahl, die das generierte Arbeitselement dem Benutzer bzw. der Benutzerin zuweist, der bzw. die den Workflow gestartet hat. Außer den Allgemein-Eigenschaften gibt es keine weiteren zu konfigurierenden Eigenschaften.

Workflow-Initiator-Teilnehmerauswahl – Konfiguration workflow-initiator-participant-chooser-configuration

Bearbeiten Sie den Schritt auf den folgenden Registerkarten, um ihn zu konfigurieren:

Prozessschritt process-step

Ein Prozessschritt führt ein ECMA-Skript aus oder ruft einen OSGi-Dienst für eine automatische Verarbeitung auf.

Prozessschritt – Konfiguration process-step-configuration

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren:

Variable festlegen set-variable

Mit dem Schritt „Variable festlegen“ können Sie den Wert einer Variablen festlegen und die Reihenfolge definieren, in der die Werte festgelegt werden. Die Variable wird in der Reihenfolge festgelegt, in der die Variablenzuordnungen im Schritt „Variable festlegen“ aufgeführt sind.

Variable festlegen – Konfiguration setvariable

Verwenden und bearbeiten Sie die folgenden Registerkarten, um den Schritt zu konfigurieren: