Guida di riferimento per il processo dei flusso di lavoro workflow-process-reference

L’AEM fornisce diverse fasi del processo che possono essere utilizzate per creare modelli di flusso di lavoro. È inoltre possibile aggiungere passaggi di processo personalizzati per attività non incluse nei passaggi predefiniti (vedere Creazione di modelli di flussi di lavoro).

Caratteristiche del processo process-characteristics

Per ogni fase del processo, vengono descritte le seguenti caratteristiche.

Java™ Class o percorso ECMA java-class-or-ecma-path

I passaggi del processo sono definiti da una classe Java™ o da un ECMAScript.

Payload payload

Il payload è l’entità su cui agisce un’istanza del flusso di lavoro. Il payload viene selezionato in modo implicito dal contesto all’interno del quale viene avviata un’istanza di 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 con l'avanzare del flusso di lavoro, con ogni passaggio che può facoltativamente agire su P in qualche modo.

Nel caso più comune, il payload è un nodo JCR nell’archivio (ad esempio, una pagina o una risorsa AEM). Un payload del nodo JCR viene passato come stringa costituita da un percorso JCR o da un identificatore JCR (UUID). A volte il payload può essere una proprietà JCR (passata come percorso JCR), un URL, un oggetto binario o un oggetto Java™ generico. Singoli passaggi del processo che agiscono sul payload solitamente si aspettano un payload di un determinato tipo, oppure agiscono in modo diverso a seconda del tipo di payload. Per ogni processo descritto di seguito, viene descritto il tipo di payload previsto, se presente.

Argomenti arguments

Alcuni processi di workflow accettano gli argomenti specificati dall'amministratore durante la configurazione del passaggio del workflow.

Gli argomenti vengono immessi come stringa singola nella proprietà Argomenti processo nel riquadro Proprietà dell'editor del flusso di lavoro. Per ogni processo descritto di seguito, il formato della stringa di 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 ogni coppia è costituita da un nome (che è una stringa) e da un valore, separati da due punti:

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

Timeout 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 per altri non si applica e viene ignorato.

Autorizzazioni permissions

La sessione passata a WorkflowProcess è supportata dall'utente del servizio per il servizio del processo del flusso di lavoro, che dispone delle seguenti autorizzazioni nella radice dell'archivio:

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

A tale scopo, si consiglia di utilizzare un utente del servizio creato con il sottoinsieme di autorizzazioni necessario, ma minimo.

Processi di controllo del flusso di lavoro workflow-control-processes

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

AbsoluteTimeAutoAdvancer (Avanzamento automatico tempo assoluto) absolutetimeautoadvancer-absolute-time-auto-advancer

Il processo AbsoluteTimeAutoAdvancer (Avanzamento automatico tempo assoluto) si comporta in modo identico a Avanzamento automatico, tranne per il fatto che si interrompe in un determinato momento e in una data specificata, anziché dopo un determinato periodo di tempo.

Avanzamento automatico (Avanzamento automatico) autoadvancer-auto-advancer

Il processo AutoAdvancer avanza automaticamente il flusso di lavoro al passaggio successivo. Se esiste più di un possibile passaggio successivo (ad esempio, se è presente una suddivisione OR), questo processo farà avanzare il flusso di lavoro lungo la route predefinita, se ne è stato specificato uno, altrimenti il flusso di lavoro non verrà avanzato.

ProcessAssembler (Assemblatore processi) processassembler-process-assembler

Il processo ProcessAssembler esegue più processi secondari in sequenza in un singolo passaggio del flusso di lavoro. Per utilizzare ProcessAssembler, creare un singolo passaggio di questo tipo nel flusso di lavoro e impostarne gli argomenti per indicare i nomi e gli argomenti dei processi secondari che si desidera eseguire.

        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 */

Ad esempio:

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 basic-processes

I processi seguenti eseguono attività semplici o fungono da esempi.

elimina delete

L’elemento nel percorso specificato viene eliminato.

noop noop

Processo nullo. Non esegue alcuna operazione, ma registra un messaggio di debug.

rule-false rule-false

Processo null che restituisce false nel metodo check().

esempio sample

Questo è un esempio di processo ECMAScript.

BloccaProcesso lockprocess

Blocca il payload del workflow.

La fase non ha alcun effetto nelle seguenti circostanze:

UnlockProcess unlockprocess

Sblocca il payload del flusso di lavoro.

La fase non ha alcun effetto nelle seguenti circostanze:

Processi di controllo delle versioni versioning-processes

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

CreateVersionProcess createversionprocess

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