Referenz für Workflow-Schritte

Workflow-Modelle beinhalten eine Reihe von Schritten unterschiedlichen Typs. Je nach Typ können diese Schritte mit Parametern und Skripten konfiguriert und erweitert werden, um die gewünschten Funktionen und Steuerungsoptionen bereitzustellen.

Schritt-Eigenschaften

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

Schritt-Eigenschaften – Registerkarte „Allgemein“

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

• Titel Der Titel für den Schritt.

• Beschreibung
  Eine Beschreibung des Schritts.

• Workflow-Status

  Eine Dropdown-Auswahl, um eine Stufe auf den Schritt anzuwenden.

• Zeitüberschreitung

  Der Zeitraum, nach dem der Schritt mit der Zeitüberschreitung abgeschlossen wird.
  Sie können zwischen folgenden Optionen auswählen: Aus, Sofort, 1h, 6h, 12h, 24h.

• Zeitüberschreitungs-Handler

  Der Handler, der den Workflow steuert, wenn der Schritt beendet wird; Beispiel:
  Auto Advancer

• Handler-Modus

  Wählen Sie diese Option, um den Workflow automatisch zum nächsten Schritt nach der Ausführung zu verschieben. Wenn diese Option nicht ausgewählt ist, muss das Implementierungsskript den Workflow weiterleiten.

Schritt-Eigenschaften – Registerkarte „Benutzer/Gruppe“

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

• Benachrichtigen Sie den Benutzer per E-Mail

  • Sie können Teilnehmer benachrichtigen, indem Sie eine E-Mail senden, sobald der Workflow einen Schritt erreicht hat.
  • Wenn diese Option aktiviert ist, wird eine E-Mail an den mit der Eigenschaft Benutzer/Gruppe definierten Benutzer oder an alle Mitglieder einer Gruppe (falls definiert) gesendet.

• Benutzer/Gruppe

  • Sie können einen Benutzer oder eine Gruppe aus einem Dropdown-Menü auswählen.
  • Falls Sie den Schritt einem bestimmten Benutzer zuweisen, kann nur dieser Benutzer Aktionen für den Schritt durchführen.
  • Wenn Sie den Schritt einer gesamten Gruppe zuweisen, haben alle Benutzer dieser Gruppe die Aktion in ihrem Workflow-Posteingang, wenn der Workflow diesen Schritt erreicht.
  • Weitere Informationen finden Sie unter Teilnehmen an Workflows.

UND-Teilung

Die Variable AND Split erstellt eine Teilung im Workflow, nach der beide Zweige aktiv sein werden. Sie fügen jeder Verzweigung nach Bedarf Workflow-Schritte hinzu. Mit diesem Schritt können Sie mehrere Prozesspfade in einem Workflow einrichten. Sie können z. B. mehrere Bewertungsschritte parallel zulassen, sodass Sie Zeit sparen.

UND-Teilung – Konfiguration

Zum Konfigurieren der Teilung:

• Bearbeiten Sie die UND-Verzweigungs-Eigenschaften:

  • Name der Teilung: Fügen Sie zur Erläuterung einen Namen ein.
  • Wählen Sie die Anzahl der erforderlichen Verzweigungen aus: 2, 3, 4 oder 5.

• Fügen Sie bei Bedarf Workflow-Schritte zu den Verzweigungen hinzu.

  

Container-Schritt

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äufige Schrittsequenzen zu implementieren. Beispielsweise kann ein Übersetzungs-Workflow-Modell in mehreren Bearbeitungs-Workflows verwendet werden.

Container-Schritt – Konfiguration

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

• Allgemein

• Container

  • Untergeordneter Workflow: Wählen Sie den zu startenden Workflow aus.

Zum Schritt wechseln

Mit Goto Step können Sie den nächsten Schritt angeben, 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 auszuwerten.

• Wenn die angegebene Bedingung "true"lautet, wird der Goto-Schritt abgeschlossen und das Workflow-Engine führt den angegebenen Schritt aus.
• Wenn die angegebene Bedingung nicht "true"lautet, wird der Goto-Schritt abgeschlossen und die normale Routing-Logik bestimmt den nächsten auszuführenden Schritt.

Mit Zum Schritt wechseln können Sie erweiterte Routingstrukturen im Workflow-Modell implementieren. Um beispielsweise eine Schleife zu implementieren, kann der Goto-Schritt definiert werden, um einen vorherigen Arbeitsablaufschritt auszuführen, wobei der Routing-Ausdruck eine Schleifenbedingung auswertet.

Zum Schritt wechseln – Konfiguration

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

• Allgemein

• Prozess

  • Zielgruppe: Wählen Sie den auszuführenden Schritt aus, nachdem Sie die Bedingung für den Routing-Ausdruck ausgewertet haben.

  • Routing Ausdruck: Wählen Sie "Regeldefinition", "Externes Skript"oder ein ECMA-Skript, das bestimmt, ob der Zielgruppe-Schritt ausgeführt werden soll.

    • Regeldefinition: Definieren Sie die Regel mithilfe des Ausdruck- Editors.
    • Externes Skript: Der Pfad des externen Skripts.
    • ECMA-Skript: Das Skript, das bestimmt, ob der Goto-Schritt ausgeführt werden soll.

Simulieren einer for-Schleife

Um eine for-Schleife zu simulieren, müssen Sie die Zahl der erfolgten Schleifeniterationen überwachen:

• Die Zahl steht in der Regel für einen Index der Elemente, für die im Workflow Aktionen erfolgen.
• Die Zahl wird als Beendigungskriterium der Schleife ausgewertet.

Um beispielsweise einen Workflow zu implementieren, der eine Aktion für mehrere JCR-Knoten durchführt, können Sie eine Schleifenzahl als Index für die Knoten verwenden. Um die Anzahl beizubehalten, speichern Sie einen integer-Wert in der Datenzuordnung der Workflow-Instanz. 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;
   }
}

Simulieren einer for-Schleife mithilfe der Regeldefinition

Sie können auch eine for-Schleife simulieren, indem Sie "Regeldefinition"als Routing-Ausdruck verwenden. Erstellen Sie eine ​​ zählbare Variable des Datentyps "Lang". Verwenden Sie Ausdruck als Zuordnungsmodus im Schritt Variable setzen, um den Wert der Variablen count auf count + 1 bei jeder Ausführung des Schritts Variable festlegen einzustellen.

Verwenden Sie unter Gehe zu Schritt Variable als Zielgruppe-Schritt und zählen Sie < 5 als Routing-Ausdruck.

Der Schritt Variable setzen führt wiederholt aus und inkrementiert den Wert der Variablen count bei jeder Ausführung um 1, bis der Wert 5 erreicht.

ODER-Teilung

Mit der ODER-Teilung wird der Workflow so geteilt, dass nur eine Verzweigung aktiv bleibt. Mit diesem Schritt können Sie bedingte Prozesspfade in einem Workflow einrichten. Sie fügen jeder Verzweigung nach Bedarf Workflow-Schritte hinzu.

ODER-Teilung – Konfiguration

Zum Konfigurieren der Teilung:

• Bearbeiten Sie die ODER-Verzweigungs-Eigenschaften:

  • Allgemein

    • Geben Sie den Namen der Teilung an.

  • Zweige (x)

    • hinzufügen Zweig: Hinzufügen weitere Verzweigungen.
    • Routing-Ausdruck auswählen: Wählen Sie den Routing-Ausdruck aus, um die aktive Verzweigung auszuwerten. Mögliche Werte sind: Regeldefinition, externes Skript und ECMA-Skript.
    • Klicken Sie, um Ausdruck zu Hinzufügen: hinzufügen Ausdruck, um die aktive Verzweigung auszuwerten, wenn Sie Regeldefinitionen als Routing-Ausdruck auswählen.
    • Skriptpfad: Der Pfad zu einer Datei, die das Skript enthält, mit dem die aktive Verzweigung ausgewertet werden soll, wenn Sie als Routing-Ausdruck External Scriptas auswählen.
    • Skript: hinzufügen Sie das Skript im Feld, um die aktive Verzweigung auszuwerten, wenn Sie ECMA Scriptas als Routing-Ausdruck auswählen.
    • Standardweg: Bei mehreren Zweigen wird die Standardverzweigung befolgt. Sie können nur eine Verzweigung als Standard festlegen.
  HINWEIS

  • Eine Verzweigung wird zu einem Zeitpunkt auf Grundlage des Routing-Ausdrucks ausgewertet.
  • Die Verzweigungen werden von oben nach unten ausgewertet.
  • Das erste Skript, das "true"ergibt, wird ausgeführt.
  • Wenn keine Verzweigung "true"ergibt, wird der Workflow nicht weitergeleitet.
  HINWEIS

  Weitere Informationen finden Sie unter Definieren einer Regel für eine ODER-Teilung.

• Fügen Sie bei Bedarf Workflow-Schritte zu den Verzweigungen hinzu.

Teilnehmer-Schritte und -Auswahl

Teilnehmer-Schritt

Mit der Option Teilnehmer-Schritt können Sie einer bestimmten Aktion Eigentümerrechte zuweisen. Der Workflow wird nur fortgesetzt, wenn der Benutzer diesen Schritt manuell bestätigt 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-Nutzlast haben.

Teilnehmer-Schritt – Konfiguration

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

• Allgemein
• Benutzer/Gruppe

Dialogfeld „Teilnehmer-Schritt“

Verwenden Sie ein Dialogfeld Teilnehmer-Schritt, um Daten des Benutzers zu erfassen, dem das Arbeitselement zugewiesen wird. Dieser Schritt eignet sich für das Erfassen kleiner Datenmengen, die später im Workflow verwendet werden.

Nach Abschluss des Schritts enthält das Dialogfeld Arbeits-Element fertig stellen die Felder, die Sie für dieses Dialogfeld definiert haben. Die in den Feldern erfassten Daten werden in den Knoten der Workflow-Nutzlast gespeichert. Nachfolgende Workflow-Schritte können die Werte aus dem Repository auslesen.

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

Dialogfeld „Teilnehmer-Schritt“ – Konfiguration

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

• Allgemein

• Benutzer/Gruppe

• Dialogfeld

  • Dialogpfad: Der Pfad zum Knoten "dialog"des von Ihnen erstellten Dialogfelds.

Dialogfeld „Teilnehmer – Schritt“ – Erstellen eines Dialogfelds

Um ein Dialogfeld zu erstellen, müssen Sie wie folgt vorgehen:

• Entscheiden Sie, wo die erfassten Daten in der Nutzlast gespeichert werden.
• Definieren des Dialogs; Hierzu gehört auch die Definition der Felder, die zum Erfassen (und Speichern) der Daten verwendet werden.

Dialogfeld „Teilnehmer-Schritt“ – Speichern von Daten in der Nutzlast

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

• Daten mit der Nutzlast speichern

  • Um Widget-Daten als Eigenschaft der Workflow-Nutzlast zu speichern, verwenden Sie das folgende Format für den Wert der Eigenschaft name des Widget-Knotens:

    ./jcr:content/nodename

  • Die Daten werden in der nodename-Eigenschaft des Nutzlastknotens gespeichert. Falls der Knoten diese Eigenschaft nicht enthält, wird die Eigenschaft erstellt.

  • Wenn Daten mit der Nutzlast gespeichert werden, wird der Wert der Eigenschaft bei nachfolgender Verwendung des Dialogfelds mit derselben Nutzlast überschrieben.

• Daten mit dem Arbeitselement speichern

  • Um Widget-Daten als Eigenschaft der Metadaten des Arbeitselements zu speichern, verwenden Sie das folgende Format für den Wert der name-Eigenschaft:

    nodename

  • Die Daten werden in der Eigenschaft nodename des Arbeitselements metadata gespeichert. Die Daten werden beibehalten, wenn das Dialogfeld anschließend von derselben Nutzlast verwendet wird.

Dialogfeld „Teilnehmer-Schritt“ – Definieren des Dialogfelds

1. Dialogfeldstruktur

   Dialogfelder für das Dialogfeld „Teilnehmer-Schritt" ähneln den Dialogfeldern, die Sie für Bearbeitungskomponenten erstellen. Sie werden gespeichert in:

   /apps/myapp/workflow/dialogs

   Dialogfelder für die Touch-optimierte Standardbenutzeroberfläche weisen folgende Knotenstruktur auf:

   newComponent (cq:Component)
     |- cq:dialog (nt:unstructured)
       |- content
         |- layout
           |- items
             |- column
               |- items
                 |- component0
                 |- component1
                 |- ...
   

   HINWEIS

   Weitere Informationen finden Sie unter Erstellen und Konfigurieren eines Dialogfelds.

2. Eigenschaft „Dialogpfad“

   Der Schritt Dialogfeld-Teilnehmer verfügt über die Eigenschaft Dialogpfad (zusammen mit den Eigenschaften eines Teilnehmerschritts). Der Wert der Eigenschaft Dialogpfad entspricht dem Pfad zum Knoten dialog im Dialogfeld.

   Das Dialogfeld kann sich beispielsweise in einer Komponente mit dem Namen EmailWatch befindet, die im Knoten gespeichert ist:

   /apps/myapp/workflows/dialogs

   Für die Touch-optimierte Benutzeroberfläche wird folgender Wert für die Eigenschaft Dialogpfad verwendet:

   /apps/myapp/workflow/dialogs/EmailWatch/cq:dialog

   

3. Beispiel für eine Dialogfelddefinition

   Das folgende XML-Code-Snippet steht für ein Dialogfeld, bei dem der String-Wert im Knoten watchEmail des Nutzlastinhalts gespeichert wird. Der Titelknoten steht für die TextField-Komponente:

   jcr:primaryType="nt:unstructured"
       jcr:title="Watcher Email Address Dialog"
       sling:resourceType="cq/gui/components/authoring/dialog">
       <content jcr:primaryType="nt:unstructured"
           sling:resourceType="granite/ui/components/foundation/container">
           <layout jcr:primaryType="nt:unstructured"
               margin="false"
               sling:resourceType="granite/ui/components/foundation/layouts/fixedcolumns"
           />
           <items jcr:primaryType="nt:unstructured">
               <column jcr:primaryType="nt:unstructured"
                   sling:resourceType="granite/ui/components/foundation/container">
                   <items jcr:primaryType="nt:unstructured">
                       <title jcr:primaryType="nt:unstructured"
                           fieldLabel="Notification Email Address"
                           name="./jcr:content/watchEmails"
                           sling:resourceType="granite/ui/components/foundation/form/textfield"
                       />
                   </items>
               </column>
           </items>
       </content>
   </cq:dialog>
   

   Bei diesem Beispiel sieht das Dialogfeld für eine Touch-optimierte Benutzeroberfläche wie folgt aus:

   

Dynamischer Teilnehmer – Schritt

Die Komponente Dynamischer Teilnehmer – Schritt ähnelt der Komponente Teilnehmer – Schritt, allerdings wird der Teilnehmer automatisch während der Laufzeit ausgewählt.

Um diesen Schritt zu konfigurieren, wählen Sie eine Teilnehmerauswahl zum Identifizieren des Teilnehmers, dem das Arbeitselement zugewiesen werden soll, und ein Dialogfeld aus.

Dynamischer Teilnehmer – Schritt – Konfiguration

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

• Allgemein

• Teilnehmer-Auswähler

  • Teilnehmer-Auswähler: der Name der Teilnehmerauswahl, den Sie erstellen.
  • Argumente: Alle erforderlichen Argumente.
  • E-Mail: Legt fest, ob eine E-Mail-Benachrichtigung an den Benutzer gesendet werden soll.

• Dialogfeld

  • Dialogpfad: Der Pfad zum Dialogfeldknoten des Dialogfelds, das Sie erstellen (wie beim Dialogfeld „Teilnehmer-Schritt“).

Dynamischer Teilnehmer – Schritt – Entwickeln der Teilnehmerauswahl

Sie erstellen die Teilnehmerauswahl. Dabei können Sie beliebige Logik oder Kriterien für die Auswahl verwenden. Beispielsweise kann die Teilnehmerauswahl den Benutzer (innerhalb einer Gruppe) auswählen, dem die wenigsten Arbeitselemente zugewiesen sind. Sie können eine beliebige Anzahl von Teilnehmerauswahlen für die Verwendung mit verschiedenen Instanzen der Komponente Dynamischer Teilnehmer – Schritt in Ihren Workflow-Modellen erstellen.

Erstellen Sie einen OSGi-Dienst oder ein ECMA-Skript zum Auswählen eines Benutzers, dem das Arbeitselement zugewiesen werden soll.

• ECMA-Skript

  Skripte müssen eine getParticipant-Funktion enthalten, mit der eine Benutzer-ID als String-Wert zurückgegeben wird. Speichern Sie Ihre benutzerdefinierten Skripten beispielsweise im Ordner /apps/myapp/workflow/scripts oder in einem Unterordner.

  Ein Beispielskript ist in einer Standard-AEM-Instanz enthalten:

  /libs/workflow/scripts/initiator-participant-chooser.ecma

  VORSICHT

  Sie dürfen keinerlei Änderungen im Pfad /libs vornehmen.

  Der Grund dafür ist, dass der Inhalt von /libs beim nächsten Aktualisieren der Instanz überschrieben wird (und möglicherweise überschrieben wird, wenn Sie einen Hotfix oder ein Feature Pack anwenden).

  Mit diesem Skript wird der Workflow-Initiator als Teilnehmer ausgewählt:

  function getParticipant() {
      return workItem.getWorkflow().getInitiator();
  }
  

  HINWEIS

  Die Komponente Workflow Initiator Participant Chooser erweitert den Dynamic Participant Step und verwendet dieses Skript als Schrittimplementierung.

• OSGi-Dienst

  Dienste müssen die com.day.cq.workflow.exec.ParticipantStepChooser-Schnittstelle implementieren. Die Schnittstelle definiert die folgenden Mitglieder:

  • SERVICE_PROPERTY_LABEL Feld: Verwenden Sie dieses Feld, um den Namen der Teilnehmerauswahl anzugeben. Der Name wird in einer Liste der verfügbaren Teilnehmerauswahlen in den Eigenschaften Dynamischer Teilnehmer – Schritt angezeigt.

  • getParticipant Methode: Gibt die dynamisch aufgelöste Principal-ID als String Wert zurück.

  VORSICHT

  Die getParticipant-Methode gibt die dynamisch aufgelöste Principal-ID zurück. Dies kann entweder eine Gruppen-ID oder eine Benutzer-ID sein.

  Eine Gruppen-ID kann jedoch nur für eine Komponente Teilnehmer-Schritt verwendet werden, wenn eine Liste der Teilnehmer zurückgegeben wird. Bei einem Schritt des dynamischen Teilnehmers wird eine leere Liste zurückgegeben, die nicht für die Übertragung verwendet werden kann.

  Um die Implementierung für Komponenten Dynamischer Teilnehmer – Schritt verfügbar zu machen, fügen Sie die Java-Klasse zum OSGi-Bundle hinzu, das den Dienst exportiert, und stellen Sie das Bundle auf dem AEM-Server bereit.

  HINWEIS

  Die zufallsbasierte Teilnehmerauswahl ist ein Sampling-Dienst, der willkürlich einen Benutzer auswählt ( com.day.cq.workflow.impl.process.RandomParticipantChooser). Die Sampling-Komponente Zufallsbasierte Teilnehmerauswahl erweitert die Komponente Dynamischer Teilnehmer – Schritt und verwendet diesen Dienst für die Implementierung des Schritts.

Dynamischer Teilnehmer – Schritt – Beispiel für Teilnehmerauswahldienst

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 (initiator-participant-chooser.ecma).

Die Anmerkung @Property setzt den Wert des Felds SERVICE_PROPERTY_LABEL 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 Eigenschaften des dynamischen Teilnehmerschritts enthält die Teilnehmerauswahl-Liste das Element Workflow Initiator Participant Chooser (script), das diesen Dienst darstellt.

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“

Formular „Teilnehmer – Schritt“ 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-Nutzlast gespeichert.

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

Formular „Teilnehmer – Schritt“ – Konfiguration

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

• Allgemein

• Benutzer/Gruppe

• Formular

  • Formularpfad: Der Pfad zum erstellten Formular.

Formular „Teilnehmer – Schritt“ - Erstellen des Formulars

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

• Für den Beginn der Form-Komponente muss die Eigenschaft Aktionstyp auf Edit Workflow Controlled Resource(s) eingestellt sein.

• Die Komponente Beginn von Form muss einen Wert für die Eigenschaft Form Identifier haben.

• Für die Formularkomponenten muss die Eigenschaft Elementname auf den Pfad des Knotens verweisen, in dem die Felddaten gespeichert werden. Der Pfad muss auf einen Knoten im Nutzlastinhalt des Workflows verweisen. Der Wert verwendet das folgende Format:

  ./jcr:content/path_to_node

• Das Formular muss eine Komponente Workflow-Senden-Schaltfläche(n) enthalten. Sie konfigurieren keine Eigenschaften für die Komponente.

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

./jcr:content/redirectTarget

Im folgenden Beispiel werden die Felddaten als Inhalt einer Text-Komponente auf der Nutzlastseite 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 Nutzlastseite eine ​-Komponente mit der ID text_3text_ 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

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

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

• Allgemein

• Argumente

  • Teilnehmer: Gibt die Liste der zur Auswahl stehenden Benutzer an. Um einen Benutzer zur Liste hinzuzufügen, klicken Sie auf Element hinzufügen und geben Sie den Stammpfad des Benutzerknotens oder die Benutzer-ID an. Die Reihenfolge der Benutzer hat keine Auswirkungen auf die Wahrscheinlichkeit, mit der diesen ein Arbeitselement zugeordnet wird.

Workflow-Initiator-Teilnehmerauswahl

Der Schritt Workflow-Initiator-Teilnehmerauswahl bezieht sich auf eine Teilnehmerauswahl, bei der das erzeugte Arbeitselement dem Benutzer zugewiesen wird, der den Workflow gestartet hat. Bei diesem Schritt muss nur die Eigenschaft Allgemein konfiguriert werden.

Workflow-Initiator-Teilnehmerauswahl – Konfiguration

Um diesen Schritt zu konfigurieren, bearbeiten Sie die folgenden Registerkarten:

• Allgemein

Prozessschritt

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

Prozessschritt – Konfiguration

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

• Allgemein

• Prozess

  • Prozess: Die Implementierung des Prozesses, die durchgeführt werden soll. Wählen Sie im Dropdown-Menü den Dienst ECMAScript oder OSGi aus. Informationen:

    • zu den standardmäßigen ECMA-Skripten und OSGi-Diensten finden Sie unter Integrierte Prozesse für Prozessschritte.
    • zum Erstellen von ECMA-Skripten für einen Prozessschritt finden Sie unter Implementieren eines Prozessschritts mit einem ECMA-Skript.
    • zum Erstellen von OSGi-Diensten für einen Prozessschritt finden Sie unter Implementieren eines Prozessschritts mit einer Java-Klasse.

  • Handler-Modus: Wählen Sie diese Option aus, um den Workflow nach der Ausführung automatisch an den nächsten Schritt weiterzuleiten. Wenn diese Option nicht ausgewählt ist, muss das Implementierungsskript den Workflow weiterleiten.

  • Argumente: An den Prozess zu übergebende Argumente.

Variable festlegen

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

Variable festlegen - Konfiguration

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

• Allgemein

• Zuordnung

  • Variable auswählen: Verwenden Sie diese Option, um eine Variable zum Festlegen ihres Werts auszuwählen.

  • Zuordnungsmodus auswählen: Wählen Sie einen Zuordnungsmodus, um den Wert für die Variable festzulegen. Je nach Datentyp der Variablen können Sie die folgenden Optionen verwenden, um den Wert einer Variablen festzulegen:

    • Literal: Verwenden Sie die Option, wenn Sie den genauen, zu spezifizierenden Wert kennen.
    • Ausdruck: Verwenden Sie die Option, wenn der zu verwendende Wert auf einem Ausdruck berechnet wird. Der Ausdruck wird im bereitgestellten Ausdruck-Editor erstellt.
    • JSON-Punktnotiz: Verwenden Sie die Option, um einen Wert aus einer JSON- oder FDM-Typvariablen abzurufen.
    • XPATH: Verwenden Sie die Option, um einen Wert aus einer XML-Typvariablen abzurufen.
    • Relativ zur Nutzlast: Verwenden Sie die Option, wenn der in einer Variablen zu speichernde Wert unter einem Pfad relativ zur Nutzlast verfügbar ist.
    • Absoluter Pfad: Verwenden Sie die Option, wenn der in einer Variablen zu speichernde Wert unter einem absoluten Pfad verfügbar ist.

  • Wert angeben: Geben Sie einen Wert an, der der Variablen zugeordnet werden soll. Der Wert, den Sie in diesem Feld angeben, hängt vom Zuordnungsmodus ab.

  • hinzufügen: Verwenden Sie diese Option, um weitere Zuordnungen hinzuzufügen, um einen Wert für die Variable festzulegen.