Referens för arbetsflödesprocess

Senast uppdaterad: 4 maj 2023

Skapat för:

  • Developer
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

AEM innehåller flera processsteg som kan användas för att skapa arbetsflödesmodeller. Anpassade processsteg kan också läggas till för uppgifter som inte omfattas av de inbyggda stegen (se Skapa arbetsflödesmodeller).

Processegenskaper

Följande egenskaper beskrivs för varje steg i processen.

Java-klass eller ECMA-sökväg

Processstegen definieras antingen av en Java-klass eller av ett ECMAScript.

  • För Java-klassprocesserna anges det fullständiga, kvalificerade klassnamnet.
  • För ECMAScript-processerna anges sökvägen till skriptet.

Nyttolast

Nyttolasten är den enhet som en arbetsflödesinstans agerar på. Nyttolasten väljs implicit av den kontext i vilken en arbetsflödesinstans startas.

Om ett arbetsflöde till exempel används på en AEM sida P sedan P överförs från steg till steg när arbetsflödet utvecklas, där varje steg kan utföras efter P på något sätt.

I det vanligaste fallet är nyttolasten en JCR-nod i databasen (till exempel en AEM eller resurs). En JCR-nodnyttolast skickas som en sträng som antingen är en JCR-sökväg eller en JCR-identifierare (UUID). I vissa fall kan nyttolasten vara en JCR-egenskap (skickas som en JCR-sökväg), en URL, ett binärt objekt eller ett generiskt Java-objekt. Enskilda processsteg som fungerar på nyttolasten förväntar sig vanligtvis en nyttolast av en viss typ, eller fungerar på olika sätt beroende på nyttolasttypen. För varje process som beskrivs nedan beskrivs den förväntade nyttolasttypen, om sådan finns,.

Argument

Vissa arbetsflödesprocesser accepterar argument som administratören anger när arbetsflödessteget ställs in.

Argument anges som en enskild sträng i Processargument -egenskapen i Egenskaper i arbetsflödesredigeraren. För varje process som beskrivs nedan beskrivs argumentsträngens format i en enkel EBNF-grammatik. Följande indikerar till exempel att argumentsträngen består av ett eller flera kommaavgränsade par, där varje par består av ett namn (som är en sträng) och ett värde, avgränsade med ett dubbelkolon:

    args := name '::' value [',' name '::' value]*
    name := /* A string */
    value := /* A string */

Timeout

Efter den här tidsgränsen är arbetsflödessteget inte längre i drift. Vissa arbetsflödesprocesser respekterar tidsgränsen, medan andra inte gäller och ignoreras.

Behörigheter

Sessionen som skickades till WorkflowProcess backas upp av tjänstanvändaren för arbetsflödets processtjänst, som har följande behörigheter i arkivets rot:

  • jcr:read
  • rep:write
  • jcr:versionManagement
  • jcr:lockManagement
  • crx:replicate

Om behörighetsuppsättningen inte är tillräcklig för WorkflowProcess måste den använda en session med nödvändig behörighet.

Det rekommenderade sättet att göra detta är att använda en tjänstanvändare som har skapats med den nödvändiga, men minimala, underuppsättningen behörigheter som krävs.

CAUTION
Om du uppgraderar från en tidigare version än AEM 6.2 kan du behöva uppdatera implementeringen.
I tidigare versioner skickades administratörssessionen till WorkflowProcess implementeringar och kunde sedan ha fullständig åtkomst till databasen utan att behöva definiera specifika åtkomstkontrollistor.
Behörigheterna definieras nu enligt ovan (Behörigheter). Som den metod som rekommenderas för att uppdatera implementeringen.
En kortsiktig lösning finns också tillgänglig för bakåtkompatibla syften när kodändringar inte är möjliga:

  • Använda webbkonsolen ( /system/console/configMgr leta upp Konfigurationstjänst för arbetsflöde för Adobe Granite

  • aktivera Läge för äldre arbetsflödesprocess

Detta återgår till det gamla beteendet att ge en administratörssession till WorkflowProcess implementering och ge obegränsad åtkomst till hela databasen igen.

Processer för arbetsflödeskontroll

Följande processer utför inga åtgärder på innehåll. De styr själva arbetsflödet.

AbsoluteTimeAutoAdvance (autoförskott för absolut tid)

The AbsoluteTimeAutoAdvancer (Absolut tid för automatiskt avancerat) fungerar likadant som AutoAdvcer, förutom att den timeout inträffar vid en viss tidpunkt och ett visst datum, i stället för efter en viss tid.

  • Java-klass: com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
  • Nyttolast: Ingen.
  • Argument: Ingen.
  • Timeout: Bearbetningstiderna är slut när den angivna tiden och datumet nås.

AutoAdvantager (automatiskt avancerat)

The AutoAdvancer processen flyttar automatiskt arbetsflödet till nästa steg. Om det finns mer än ett möjligt nästa steg (till exempel om det finns en OR-delning) kommer den här processen att flytta fram arbetsflödet längs standardflöde, om en sådan har angetts, annars kommer arbetsflödet inte att avanceras.

  • Java-klass: com.adobe.granite.workflow.console.timeout.autoadvance.AutoAdvancer

  • Nyttolast: Ingen.

  • Argument: Ingen.

  • Timeout: Bearbetningstiderna är slut efter angiven tidslängd.

ProcessAssembler (Process Assembler)

The ProcessAssembler kör flera underprocesser sekventiellt i ett enda arbetsflödessteg. Så här använder du ProcessAssemblerskapar du ett enda steg av den här typen i arbetsflödet och anger dess argument för att ange namn och argument för de underprocesser som du vill köra.

  • Java-klass: com.day.cq.workflow.impl.process.ProcessAssembler

  • Nyttolast: En DAM-resurs, AEM sida eller ingen nyttolast (beror på underprocessernas krav).

  • Argument:

        args := arg [',' arg]
        arg := processname ['::' processargs]
        processname := /* A fully qualified Java Class or absolute
        repository path to an ECMAScript */
        processargs := processarg [';' processarg]*
        processarg := '[' nobracketprocessarg ']' | nobracketprocessarg
        nobracketprocessarg := listitem [':' listitem]*
        listitem := /* A string */
  • Timeout: Respekt.

Till exempel:

  • Extrahera metadata från resursen.
  • Skapa tre miniatyrbilder av de tre angivna storlekarna.
  • Skapa en JPEG-bild från resursen, förutsatt att resursen ursprungligen varken är en GIF eller en PNG-bild (då skapas ingen JPEG).
  • Ange det senast ändrade datumet för tillgången.
com.day.cq.dam.core.process.ExtractMetadataProcess,
    com.day.cq.dam.core.process.CreateThumbnailProcess::[140:100];[48:48];[319:319:false],
    com.day.cq.dam.core.process.CreateWebEnabledImageProcess::dimension:1280:1280;mimetype:image/jpeg,
    com.day.cq.dam.core.process.AssetSetLastModifiedProcess

Grundläggande processer

Följande processer utför enkla uppgifter eller fungerar som exempel.

CAUTION
Du måste ändrar ingenting i /libs bana.
Detta beror på innehållet i /libs skrivs över nästa gång du uppgraderar din instans (och kan skrivas över när du använder en snabbkorrigering eller ett funktionspaket).

delete

Objektet vid den angivna sökvägen tas bort.

  • ECMAScript-sökväg: /libs/workflow/scripts/delete.ecma

  • Nyttolast: JCR-sökväg

  • Argument: Ingen

  • Timeout: Ignorerad

noop

Detta är null-processen. Ingen åtgärd utförs, men ett felsökningsmeddelande loggas.

  • ECMAScript-sökväg: /libs/workflow/scripts/noop.ecma

  • Nyttolast: Ingen

  • Argument: Ingen

  • Timeout: Ignorerad

rule-false

Detta är en null-process som returnerar false på check() -metod.

  • ECMAScript-sökväg: /libs/workflow/scripts/rule-false.ecma

  • Nyttolast: Ingen

  • Argument: Ingen

  • Timeout: Ignorerad

exempel

Detta är ett exempel på ECMAScript-process.

  • ECMAScript-sökväg: /libs/workflow/scripts/sample.ecma

  • Nyttolast: Ingen

  • Argument: Ingen

  • Timeout: Ignorerad

urlcaller

Det här är en enkel arbetsflödesprocess som anropar den angivna URL:en. Vanligtvis är URL:en en referens till en JSP (eller annan servermotsvarighet) som utför en enkel åtgärd. Denna process bör endast användas under utveckling och demonstrationer och inte i en produktionsmiljö. Argumenten anger URL, inloggning och lösenord.

  • ECMAScript-sökväg: /libs/workflow/scripts/urlcaller.ecma

  • Nyttolast: Ingen

  • Argument:

        args := url [',' login ',' password]
        url := /* The URL to be called */
        login := /* The login to access the URL */
        password := /* The password to access the URL */

Till exempel: http://localhost:4502/my.jsp, mylogin, mypassword

  • Timeout: Ignorerad

LockProcess

Låser arbetsflödets nyttolast.

  • Java-klass: com.day.cq.workflow.impl.process.LockProcess

  • Nyttolast: JCR_PATH och JCR_UID

  • Argument: Ingen

  • Timeout: Ignorerad

Stegen har ingen effekt under följande omständigheter:

  • Nyttolasten är redan låst
  • Noden nyttload innehåller inte en underordnad jcr:content-nod

UnlockProcess

Låser upp arbetsflödets nyttolast.

  • Java-klass: com.day.cq.workflow.impl.process.UnlockProcess

  • Nyttolast: JCR_PATH och JCR_UID

  • Argument: Ingen

  • Timeout: Ignorerad

Stegen har ingen effekt under följande omständigheter:

  • Nyttolasten är redan upplåst
  • Noden nyttload innehåller inte en underordnad jcr:content-nod

Versionshantering

Följande process utför en versionsrelaterad uppgift.

CreateVersionProcess

Skapar en ny version av arbetsflödets nyttolast (AEM eller DAM-resurs).

  • Java, klass: com.day.cq.wcm.workflow.process.CreateVersionProcess

  • Nyttolast: En JCR-sökväg eller UUID som refererar till en sida eller en DAM-resurs

  • Argument: Ingen

  • Timeout: Respekt

Föregående sida
Nästa sida

Experience Manager