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 dialogruta för stegegenskaper där du kan definiera och redigera nödvändiga egenskaper.

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

En kombination av följande egenskaper är tillgängliga för de flesta arbetsflödesstegkomponenter på fliken Allmänt i dialogrutan för egenskaper:

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

Följande egenskaper är tillgängliga för många arbetsflödesstegkomponenter på fliken Användare/grupp i dialogrutan för egenskaper:

OCH dela and-split

AND-delning skapar en delning i arbetsflödet, efter vilken båda grenarna är aktiva. Du kan lägga till arbetsflödessteg i varje gren efter behov. I det här steget kan du lägga in flera bearbetningssökvägar i arbetsflödet. Du kan till exempel tillåta att vissa granskningssteg utförs parallellt, vilket sparar tid.

AND Split - Configuration and-split-configuration

Så här konfigurerar du delningen:

Behållarsteg container-step

Ett behållarsteg startar en annan arbetsflödesmodell som körs som ett underordnat arbetsflöde.

Med den här behållaren 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

Med Gå till steg kan du ange nästa steg som ska köras i arbetsflödesmodellen. Du kan ange en regeldefinition, ett externt skript eller ett ECMA-skript som routningsuttryck för att utvärdera nästa steg för arbetsflödesmodellen.

Med Gå till steg kan du implementera avancerade routningsstrukturer i dina arbetsflödesmodeller. Om du till exempel vill implementera en slinga kan du definiera Gå till steg så att du kan köra ett föregående steg i arbetsflödet, där routningsuttrycket 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

Simulering av en for-slinga kräver att du håller reda på 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. Om du vill behålla antalet lagrar du ett integer-värde i datamappningen för arbetsflödesinstansen. Använd skriptet för Gå till steg om du vill öka antalet och 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;
   }
}

Simulera en for-slinga med hjälp av regeldefinition simulateforloop

Du kan också simulera en for-slinga med hjälp av Regeldefinition som routningsuttryck. Skapa en count-variabelmed datatypen Long. Använd Uttryck som mappningsläge i steget Ange variabel för att ange värdet för variabeln count till count + 1 för varje körning av steget Ange variabel .

I Gå till steg använder du Ange variabel som målsteg och antal < 5 som routningsuttryck.

Stegen Ange variabel körs upprepade gånger och värdet för variabeln count ökas med 1 i varje körning tills värdet når 5.

ELLER Dela or-split

ELLER Dela skapar en delning i arbetsflödet, efter vilken endast en gren är 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

Så här konfigurerar du delningen:

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

Deltagarsteg participant-step

Med ett deltagarsteg kan du tilldela ägarskap för en viss åtgärd. Arbetsflödet fortsätter bara när användaren har bekräftat steget manuellt. Det här arbetsflödet används när du vill att någon ska arbeta med arbetsflödet. 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 ett dialogdeltagarsteg för att samla in information från den användare som har tilldelats arbetsposten. 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 innehåller dialogrutan Slutför arbetsuppgift de fält som du har definierat 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

Om du vill skapa en dialogruta måste du skapa den:

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 för egenskapen name för widgetnoden avgör var data lagras.

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

Dynamiskt deltagarsteg dynamic-participant-step

Komponenten Dynamiskt deltagarsteg liknar Deltagarsteg med skillnaden att deltagaren väljs automatiskt vid körning.

Om du vill konfigurera steget väljer du en deltagarväljare 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 deltagare som du kan använda med olika instanser av komponenten Dynamic Deltagare Step 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 gränssnittet ParticipantStepChooser. Klassen returnerar namnet på deltagaren som initierade arbetsflödet. Koden använder samma logik som exempelskriptet (initiator-participant-chooser.ecma) använder.

Anteckningen @Property ställer in värdet för fältet SERVICE_PROPERTY_LABEL 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 dialogrutan Dynamiskt deltagarsteg innehåller listan Deltagarväljare objektet Workflow Initiator Participant Chooser (script), som representerar den här tjänsten.

När arbetsflödesmodellen startas anger loggen ID:t för användaren som initierade arbetsflödet och vem som tilldelats arbetsposten. I det här exemplet startade användaren admin 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

Formulärdeltagarsteget visar ett formulär när arbetsobjektet ö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 ett formulärdeltagarsteg 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 egenskapen Elementnamn lagrar fältdata som värdet för egenskapen redirectTarget för noden jcr:content:

./jcr:content/redirectTarget

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

./jcr:content/par/text_3/text

Det första exemplet kan användas för alla sidor som återges av komponenten cq:Page. Det andra exemplet kan bara användas när nyttolastsidan innehåller en Text-komponent som har ID:t 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

Steget Slumpmässig deltagarväljare är en deltagarväljare som tilldelar det genererade arbetsobjektet 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

Steget Deltagare i arbetsflödesinitieraren är en deltagarväljare som tilldelar det genererade arbetsobjektet till användaren som startade arbetsflödet. Det finns inga andra egenskaper att konfigurera än Common -egenskaperna.

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

Ett processteg 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:

Ange variabel set-variable

Med steget Ange variabel kan du ange ett värde för en variabel och definiera i vilken ordning värdena ska anges. Variabeln ställs in i den ordning som variabelmappningarna visas i steget Ange variabel.

Ange variabel - konfiguration setvariable

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