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

Workflow-Modelle bestehen aus einer Reihe von Schritten verschiedener Typen. 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 Schritt-Komponente verfügt über eine Schritt-Eigenschaften -Dialogfeld, in dem Sie die erforderlichen Eigenschaften definieren und bearbeiten können.

Schritteigenschaften - Registerkarte "Allgemein" step-properties-common-tab

Für die meisten Workflow-Schritt-Komponenten ist eine Kombination der folgenden Eigenschaften verfügbar: Häufig Registerkarte des Eigenschaftendialogfelds:

Schritteigenschaften - Registerkarte "Benutzer/Gruppe" step-properties-user-group-tab

Die folgenden Eigenschaften sind für viele Workflow-Schritt-Komponenten verfügbar: Benutzer/Gruppe Registerkarte des Eigenschaftendialogfelds:

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. Dieser Schritt ermöglicht es Ihnen, mehrere Verarbeitungspfade in den Workflow einzufügen. Sie können beispielsweise zulassen, dass bestimmte Überprüfungsschritte parallel ausgeführt werden, sodass Zeit gespart wird.

UND-Teilung - Konfiguration and-split-configuration

Container-Schritt container-step

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

Diese Container ermöglicht die Wiederverwendung von Workflow-Modellen zur Implementierung gängiger Schrittfolgen. Beispielsweise kann ein Übersetzungs-Workflow-Modell in mehreren Bearbeitungs-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 Zum Schritt wechseln ermöglicht es Ihnen, den nächsten auszuführenden Schritt im Workflow-Modell abhängig vom Ergebnis eines ECMAScripts anzugeben:

Mit Zum Schritt wechseln können Sie erweiterte Routingstrukturen im Workflow-Modell implementieren. Um beispielsweise eine Schleife zu implementieren, muss die Zum Schritt wechseln kann definiert werden, um einen vorherigen Schritt im Workflow auszuführen, wobei das Skript eine Schleifenbedingung auswertet.

Zum Schritt wechseln - Konfiguration goto-step-configuration

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

Simulieren einer für Schleife simulating-a-for-loop

Für die Simulation einer for-Schleife müssen Sie die Anzahl der aufgetretenen Schleifeniterationen beibehalten:

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. Verwenden Sie das Skript für Zum Schritt wechseln, um die Zahl zu erhöhen und mit den Beendigungskriterien zu vergleichen.

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;
   }
}

ODER-Teilung or-split

Mit der ODER-Teilung wird der Workflow so geteilt, dass nur eine Verzweigung 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

Teilnehmer - Schritte 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 den Schritt manuell quittiert hat. Die Option wird verwendet, wenn Sie einer Person eine Aktion in einem Workflow zuweisen möchten, z. B. einen Bewertungsschritt.

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.

Teilnehmer-Schritt - Konfiguration participant-step-configuration

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

Dialogfeld "Teilnehmer" – Schritt dialog-participant-step

Verwenden Sie eine Dialogfeld "Teilnehmer - Schritt" , um Informationen von dem Benutzer zu erfassen, dem das Arbeitselement zugewiesen ist. Dieser Schritt ist nützlich für die Erfassung kleiner Datenmengen, die später im Workflow verwendet werden.

Nach Abschluss des Schritts wird die Arbeitselement abschließen enthält die Felder, die Sie in Ihrem Dialogfeld definieren. 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 an, der das Arbeitselement zugewiesen werden soll, und den Pfad zum Dialogfeld.

Dialogfeld "Teilnehmer - Schritt - Konfiguration" dialog-participant-step-configuration

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

Dialogfeld "Teilnehmer-Schritt"- Erstellen eines Dialogfelds dialog-participant-step-creating-a-dialog

So erstellen Sie ein Dialogfeld:

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 "Teilnehmer-Schritt"- Dialogfelddefinition dialog-participant-step-dialog-definition

Dynamischer Teilnehmerschritt dynamic-participant-step

Die Dynamischer Teilnehmer - Schritt -Komponente ähnelt Teilnehmer-Schritt mit dem Unterschied, dass der Teilnehmer zur Laufzeit automatisch ausgewählt wird.

Um den Schritt zu konfigurieren, wählen Sie eine Teilnehmerauswahl , der den Teilnehmer identifiziert, dem das Arbeitselement zugewiesen werden soll, zusammen mit einem Dialogfeld.

Dynamischer Teilnehmer - Schritt - Konfiguration dynamic-participant-step-configuration

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

Dynamischer Teilnehmer - 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 den Benutzer (innerhalb einer Gruppe) mit den wenigsten Arbeitselementen auswählen. Sie können eine beliebige Anzahl von Teilnehmerauswahlen erstellen, die mit verschiedenen Instanzen der Dynamischer Teilnehmer - Schritt -Komponente in Ihren Workflow-Modellen.

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

Dynamischer Teilnehmer - Schritt - Beispiel für einen Teilnehmerauswahldienst dynamic-participant-step-example-participant-chooser-service

Die folgende Java-Klasse implementiert die ParticipantStepChooser-Oberfläche. Die Klasse gibt den Namen des Teilnehmers zurück, der den Workflow initiiert hat. Der Code verwendet dieselbe Logik wie das Beispielskript (initator-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 "Teilnehmer" – Schritt form-participant-step

Die Teilnehmer-Schritt des Formulars zeigt ein Formular an, wenn das Arbeitselement geöffnet wird. 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 an, der das Arbeitselement zugewiesen werden soll, und den Pfad zum Formular.

Formularteilnehmerschritt - Konfiguration form-participant-step-configuration

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

Formularteilnehmerschritt - Erstellen des Formulars form-participant-step-creating-the-form

Erstellen Sie ein Formular zur Verwendung mit einer Teilnehmer-Schritt des Formulars als normal. Formulare für einen Formular "Teilnehmer - Schritt"müssen jedoch die folgenden Konfigurationen aufweisen:

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

Die Workflow-Initiator-Teilnehmerauswahl step ist eine Teilnehmerauswahl, die das generierte Arbeitselement dem Benutzer zuordnet, der den Workflow gestartet hat. Es gibt keine anderen Eigenschaften als die Häufig Eigenschaften.

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

Um den Schritt zu konfigurieren, bearbeiten Sie ihn mithilfe der folgenden Registerkarten:

Prozessschritt process-step

A Prozessschritt führt ein ECMAScript aus oder ruft einen OSGi-Dienst auf, um eine automatische Verarbeitung durchzuführen.

Prozessschritt - Konfiguration process-step-configuration

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