Riferimento processo flusso di lavoro

AEM fornisce diversi passaggi di processo che possono essere utilizzati per creare modelli di workflow. Per le attività non incluse nei passaggi predefiniti è inoltre possibile aggiungere passaggi di processo personalizzati (vedere Creazione di modelli di workflow).

Caratteristiche del processo

Per ogni fase del processo sono descritte le seguenti caratteristiche.

Classe Java o percorso ECMA

I passaggi di processo sono definiti da una classe Java o ECMAScript.

• Per i processi di classe Java, viene fornito il nome completo della classe.
• Per i processi ECMAScript viene fornito il percorso dello script.

Payload

Il payload è l'entità su cui agisce un'istanza del flusso di lavoro. Il payload viene selezionato in modo implicito dal contesto in cui viene avviata un'istanza del flusso di lavoro.

Ad esempio, se un flusso di lavoro viene applicato a una pagina AEM P, P viene passato da un passaggio all'altro man mano che il flusso di lavoro avanza, con ogni passaggio che agisce facoltativamente su P in qualche modo.

Nel caso più comune, il payload è un nodo JCR nella directory archivio (ad esempio, una pagina o una risorsa AEM). Un payload del nodo JCR viene passato come una stringa che è un percorso JCR o un identificatore JCR (UUID). In alcuni casi, il payload può essere una proprietà JCR (passata come percorso JCR), un URL, un oggetto binario o un oggetto Java generico. I singoli passaggi del processo che agiscono sul payload in genere prevedono un payload di un certo tipo o agiscono in modo diverso a seconda del tipo di payload. Per ogni processo descritto di seguito, viene descritto l'eventuale tipo di payload previsto.

Argomenti

Alcuni processi del flusso di lavoro accettano argomenti specificati dall'amministratore al momento della configurazione del passaggio del flusso di lavoro.

Gli argomenti vengono immessi come una singola stringa nella proprietà Argomenti processo nel riquadro Proprietà dell'editor del flusso di lavoro. Per ogni processo descritto di seguito, il formato della stringa dell'argomento è descritto in una semplice grammatica EBNF. Ad esempio, quanto segue indica che la stringa dell'argomento è costituita da una o più coppie delimitate da virgole, in cui ciascuna coppia è costituita da un nome (una stringa) e un valore, separati da due punti:

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

Timeout

Dopo questo periodo di timeout, il passaggio del flusso di lavoro non è più operativo. Alcuni processi del flusso di lavoro rispettano il timeout, mentre altri non vengono applicati e vengono ignorati.

Autorizzazioni

La sessione passata al WorkflowProcess viene sostenuta dall'utente del servizio per il servizio di elaborazione del flusso di lavoro, che dispone delle seguenti autorizzazioni alla radice del repository:

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

Se tale insieme di autorizzazioni non è sufficiente per l'implementazione WorkflowProcess, deve utilizzare una sessione con le autorizzazioni richieste.

Il modo consigliato per eseguire questa operazione è utilizzare un utente di servizio creato con il sottoinsieme necessario, ma minimo, di autorizzazioni.

Processi di controllo del flusso di lavoro

I processi seguenti non eseguono alcuna azione sul contenuto. Servono a controllare il comportamento del flusso di lavoro stesso.

AbsoluteTimeAutoAdvancer (Absolute Time Auto Advancer)

Il processo AbsoluteTimeAutoAdvancer (Absolute Time Auto Advancer) si comporta in modo identico a AutoAdvancer, ma si verifica un timeout in un dato momento e in una data, anziché dopo un determinato periodo di tempo.

• Classe Java: com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
• Payload: Nessuno.
• Argomenti: Nessuno.
• Timeout: Timeout del processo quando vengono raggiunti l'ora e la data impostate.

AutoAdvancer (Auto Advancer)

Il processo AutoAdvancer sposta automaticamente il flusso di lavoro al passaggio successivo. Se è possibile eseguire più passaggi successivi (ad esempio, in presenza di una divisione OR), questo processo porterà avanti il flusso di lavoro lungo la route predefinita, se specificata, altrimenti il flusso di lavoro non verrà anticipato.

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

• Payload: Nessuno.

• Argomenti: Nessuno.

• Timeout: Timeout del processo dopo la durata impostata.

ProcessAssembler (Process Assembler)

Il processo ProcessAssembler esegue più processi secondari in sequenza in un singolo passaggio del flusso di lavoro. Per utilizzare il ProcessAssembler, create un singolo passaggio di questo tipo nel flusso di lavoro e impostate i relativi argomenti per indicare i nomi e gli argomenti dei processi secondari che desiderate eseguire.

• Classe Java: com.day.cq.workflow.impl.process.ProcessAssembler

• Payload: Una risorsa DAM, AEM pagina o nessun payload (dipende dai requisiti dei sottoprocessi).

• Argomenti:

        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: Rispettato.

Esempio:

• Estraete i metadati dalla risorsa.
• Create tre miniature delle tre dimensioni specificate.
• Create un’immagine JPEG dalla risorsa, partendo dal presupposto che la risorsa non sia originariamente né GIF né PNG (nel qual caso non viene creato alcun file JPEG).
• Imposta la data dell’ultima modifica sulla risorsa.

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

Processi di base

I processi seguenti eseguono operazioni semplici o fungono da esempi.

delete

L’elemento nel percorso specificato viene eliminato.

• Percorso ECMAScript: /libs/workflow/scripts/delete.ecma

• Payload: Percorso JCR

• Argomenti: None

• Timeout: Ignorato

noop

Questo è il processo null. Non esegue alcuna operazione, ma registra un messaggio di debug.

• Percorso ECMAScript: /libs/workflow/scripts/noop.ecma

• Payload: None

• Argomenti: None

• Timeout: Ignorato

rule-false

Si tratta di un processo null che restituisce false sul metodo check().

• Percorso ECMAScript: /libs/workflow/scripts/rule-false.ecma

• Payload: None

• Argomenti: None

• Timeout: Ignorato

esempio

Si tratta di un esempio di processo ECMAScript.

• Percorso ECMAScript: /libs/workflow/scripts/sample.ecma

• Payload: None

• Argomenti: None

• Timeout: Ignorato

urlcaller

Si tratta di un semplice processo di workflow che richiama l’URL specificato. In genere, l’URL è un riferimento a una JSP (o altro servlet equivalente) che esegue un’attività semplice. Questo processo dovrebbe essere utilizzato solo durante lo sviluppo e le dimostrazioni e non in un ambiente di produzione. Gli argomenti specificano l'URL, il login e la password.

• Percorso ECMAScript: /libs/workflow/scripts/urlcaller.ecma

• Payload: None

• Argomenti:

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

Esempio: http://localhost:4502/my.jsp, mylogin, mypassword

• Timeout: Ignorato

LockProcess

Blocca il payload del flusso di lavoro.

• Classe Java: com.day.cq.workflow.impl.process.LockProcess

• Payload: JCR_PATH e JCR_UID

• Argomenti: None

• Timeout: Ignorato

La fase non ha effetto nelle seguenti circostanze:

• Il payload è già bloccato
• Il nodo payload non contiene un nodo figlio jcr:content

Sblocca processo

Sblocca il payload del flusso di lavoro.

• Classe Java: com.day.cq.workflow.impl.process.UnlockProcess

• Payload: JCR_PATH e JCR_UID

• Argomenti: None

• Timeout: Ignorato

La fase non ha effetto nelle seguenti circostanze:

• Il payload è già sbloccato
• Il nodo payload non contiene un nodo figlio jcr:content

Processi di gestione delle versioni

Il seguente processo esegue un'attività relativa alla versione.

CreateVersionProcess

Crea una nuova versione del payload del flusso di lavoro (AEM pagina o risorsa DAM).

• Classe Java: com.day.cq.wcm.workflow.process.CreateVersionProcess

• Payload: Un percorso JCR o un UUID che fa riferimento a una pagina o a una risorsa DAM

• Argomenti: None

• Timeout: Rispettato