Referens för arbetsflödessteg workflow-step-reference

Arbetsflödesmodeller består av en serie steg av olika typer. Beroende på typ kan dessa steg konfigureras och utökas med parametrar och skript för att ge den funktionalitet och kontroll som du behöver.

Stegegenskaper step-properties

Varje stegkomponent har en Step Properties som gör att du kan definiera och redigera de önskade egenskaperna.

Stegegenskaper - fliken Allmänt step-properties-common-tab

En kombination av följande egenskaper är tillgängliga för de flesta arbetsflödesstegkomponenter på Common i egenskapsdialogrutan:

Stegegenskaper - fliken Användare/grupp step-properties-user-group-tab

Följande egenskaper är tillgängliga för många arbetsflödesstegkomponenter på User/Group i egenskapsdialogrutan:

OCH dela and-split

The AND Split skapar en delning i arbetsflödet, varefter båda grenarna blir aktiva. Du kan lägga till arbetsflödessteg i varje gren efter behov. I det här steget kan du införa flera bearbetningssökvägar i arbetsflödet. Du kan t.ex. tillåta att vissa granskningssteg utförs parallellt, vilket sparar tid.

AND Split - Configuration and-split-configuration

Behållarsteg container-step

A Container startar en annan arbetsflödesmodell som körs som ett underordnat arbetsflöde.

Detta Container I kan du återanvända arbetsflödesmodeller för att implementera vanliga stegsekvenser. En arbetsflödesmodell för översättning kan till exempel användas i flera redigeringsarbetsflöden.

Behållarsteg - konfiguration container-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Gå till steg goto-step

The Goto Step I kan du ange nästa steg i arbetsflödesmodellen som ska köras, beroende på resultatet av ett ECMAScript:

The Goto Step I kan du implementera avancerade routningsstrukturer i dina arbetsflödesmodeller. Om du till exempel vill implementera en slinga Goto Step kan definieras för att köra ett föregående steg i arbetsflödet, där skriptet utvärderar ett slingvillkor.

Gå till steg - konfiguration goto-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Simulera en for-slinga simulating-a-for-loop

När du simulerar en for-slinga måste du behålla antalet upprepningar av slingor som har inträffat:

Om du till exempel vill implementera ett arbetsflöde som utför en åtgärd på flera JCR-noder kan du använda en loopräknare som index för noderna. Spara ett integer värdet i datamappningen för arbetsflödesinstansen. Använd skriptet för Goto Step om du vill öka antalet samt jämföra antalet med avslutningskriterierna.

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

ELLER Dela or-split

The OR Split skapar en delning i arbetsflödet, varefter endast en gren blir aktiv. I det här steget kan du lägga in sökvägar för villkorlig bearbetning i arbetsflödet. Du kan lägga till arbetsflödessteg i varje gren efter behov.

Eller delad - konfiguration or-split-configuration

Deltagarsteg och väljare participant-steps-and-choosers

Deltagarsteg participant-step

A Participant Step I kan du tilldela ägarskap för en viss åtgärd. Arbetsflödet fortsätter bara när användaren har bekräftat steget manuellt. Detta används när du vill att någon ska vidta en åtgärd i arbetsflödet; till exempel ett granskningssteg.

Även om det inte är direkt relaterat måste användarauktorisering beaktas när en åtgärd tilldelas. användaren måste ha åtkomst till sidan som är arbetsflödets nyttolast.

Deltagarsteg - konfiguration participant-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Steg för dialogdeltagare dialog-participant-step

Använd en Dialog Participant Step för att samla in information från den användare som har tilldelats arbetsuppgiften. Det här steget är användbart när du vill samla in små mängder data som används senare i arbetsflödet.

När du är klar med steget Complete Work Item -dialogrutan innehåller de fält som du definierar i dialogrutan. De data som samlas in i fälten lagras i noder i arbetsflödets nyttolast. Efterföljande arbetsflödessteg kan sedan läsa värdet från databasen.

Om du vill konfigurera steget anger du vilken grupp eller användare som arbetsposten ska tilldelas till och sökvägen till dialogrutan.

Steg för dialogdeltagare - konfiguration dialog-participant-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Steg för dialogdeltagare - Skapa en dialogruta dialog-participant-step-creating-a-dialog

Så här skapar du en dialogruta:

Steg för dialogdeltagare - lagra data i nyttolasten dialog-participant-step-storing-data-in-the-payload

Du kan lagra widgetdata i arbetsflödets nyttolast eller i arbetsobjektets metadata. Formatet på name widgetnodens egenskap avgör var data lagras.

Steg för dialogdeltagare - Dialogrutedefinition dialog-participant-step-dialog-definition

Dynamiskt deltagarsteg dynamic-participant-step

The Dynamic Participant Step -komponenten liknar Participant Step med skillnaden att deltagaren väljs automatiskt vid körning.

Om du vill konfigurera steget väljer du en Participant Chooser som identifierar deltagaren som arbetsposten ska tilldelas till, tillsammans med en dialogruta.

Dynamiskt deltagarsteg - konfiguration dynamic-participant-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Dynamiskt deltagarsteg - Utveckla deltagarväljaren dynamic-participant-step-developing-the-participant-chooser

Du skapar deltagarväljaren. Därför kan du använda valfri urvalslogik eller valfria villkor. Din deltagarväljare kan t.ex. välja den användare (i en grupp) som har minst arbetsobjekt. Du kan skapa valfritt antal deltagaralternativ som du kan använda med olika instanser av Dynamiskt deltagarsteg i dina arbetsflödesmodeller.

Skapa en OSGi-tjänst eller ett ECMAScript-skript som väljer en användare att tilldela arbetsposten till.

Dynamiskt deltagarsteg - Exempel på deltagarväljartjänst dynamic-participant-step-example-participant-chooser-service

Följande Java-klass implementerar ParticipantStepChooser gränssnitt. Klassen returnerar namnet på deltagaren som initierade arbetsflödet. Koden använder samma logik som exempelskriptet ( initator-participant-chooser.ecma).

The @Property anteckningen anger värdet för SERVICE_PROPERTY_LABEL fält till 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;
 }
}

I Dynamic Participant Step egenskapsdialogrutan, Participant Chooser listan innehåller objektet Workflow Initiator Participant Chooser (script), som representerar den här tjänsten.

"När arbetsflödesmodellen startas visar loggen ID:t för den användare som initierade arbetsflödet och som tilldelats arbetsposten. I det här exemplet admin användaren startade arbetsflödet.

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

Steg för formulärdeltagare form-participant-step

The Form Participant Step visar ett formulär när arbetsuppgiften öppnas. När användaren fyller i och skickar formuläret lagras fältdata i noderna i arbetsflödets nyttolast.

Om du vill konfigurera steget anger du vilken grupp eller användare som arbetsposten ska tilldelas till och sökvägen till formuläret.

Steg för formulärdeltagare - Konfiguration form-participant-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Steg för formulärdeltagare - Skapa formuläret form-participant-step-creating-the-form

Skapa ett formulär som ska användas med en Form Participant Step som vanligt. Formulär för ett steg för formulärdeltagare måste dock ha följande konfigurationer:

Arbetsflödets krav avgör var fältdata ska lagras. Fältdata kan till exempel användas för att konfigurera egenskaper för sidinnehåll. Följande värde för en Element Name egenskapen lagrar fältdata som värdet för redirectTarget egenskapen för jcr:content nod:

./jcr:content/redirectTarget

I följande exempel används fältdata som innehåll i en Text på nyttolastsidan:

./jcr:content/par/text_3/text

"Det första exemplet kan användas för alla sidor som cq:Page komponentåtergivning. Det andra exemplet kan bara användas när nyttolastsidan innehåller en Text -komponent som har ett ID för text_3.

Formuläret kan finnas var som helst i databasen, men arbetsflödesanvändare måste ha behörighet att läsa formuläret.

Slumpmässig deltagarväljare random-participant-chooser

The Random Participant Chooser är en deltagarväljare som tilldelar den genererade arbetsposten till en användare som väljs slumpmässigt från en lista.

Slumpmässig deltagarväljare - konfiguration random-participant-chooser-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar:

Väljare för deltagare i arbetsflödesinitieraren workflow-initiator-participant-chooser

The Workflow Initiator Participant Chooser är en deltagarväljare som tilldelar den genererade arbetsposten till användaren som startade arbetsflödet. Det finns inga andra egenskaper att konfigurera än Common egenskaper.

Väljare för deltagare i arbetsflödesinitiering - Konfiguration workflow-initiator-participant-chooser-configuration

Om du vill konfigurera steget redigerar du på följande flikar:

Processsteg process-step

A Process Step kör ett ECMAScript eller anropar en OSGi-tjänst för att utföra automatisk bearbetning.

Processsteg - Konfiguration process-step-configuration

Om du vill konfigurera steget redigerar du och använder följande flikar: