Guida di riferimento per il processo dei flusso di lavoro

AEM fornisce diversi passaggi del processo che possono essere utilizzati per creare modelli di flusso di lavoro. È inoltre possibile aggiungere fasi di processo personalizzate per attività non coperte dai passaggi incorporati (vedi Creazione di modelli di flussi di lavoro).

Caratteristiche del processo

Per ogni fase del processo sono descritte le seguenti caratteristiche.

Percorso classe Java o ECMA

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

• Per i processi della 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 di flusso di lavoro. Il payload viene selezionato implicitamente dal contesto in cui viene avviata un’istanza di flusso di lavoro.

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

Nel caso più comune, il payload è un nodo JCR nell’archivio (ad esempio, una pagina AEM o una risorsa). Un payload del nodo JCR viene passato come 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 si aspettano un payload di un determinato 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 gli argomenti specificati dall’amministratore durante la configurazione del passaggio del flusso di lavoro.

Gli argomenti vengono immessi come una singola stringa nel Argomenti del processo nella Proprietà nell’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 lo applicano e vengono ignorati.

Autorizzazioni

La sessione passata al WorkflowProcess viene supportato dall’utente del servizio per il servizio di processo del flusso di lavoro, che dispone delle seguenti autorizzazioni nella directory principale dell’archivio:

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

Se quel set di autorizzazioni non è sufficiente per il tuo WorkflowProcess implementazione, quindi deve utilizzare una sessione con le autorizzazioni richieste.

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

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 (Advancer automatico del tempo assoluto)

La AbsoluteTimeAutoAdvancer Il processo di avanzamento automatico del tempo assoluto si comporta in modo identico a AutoAdvancer, tranne per il fatto che scade 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: Il processo scade quando viene raggiunta l’ora e la data impostate.

AutoAdvancer (Auto Advancer)

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

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

• Payload: Nessuno.

• Argomenti: Nessuno.

• Timeout: Il processo si interrompe una volta impostato il tempo.

ProcessAssembler (Assembler del processo)

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

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

• Payload: Una risorsa DAM, AEM pagina o nessun payload (a seconda dei 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:

• Estrai i metadati dalla risorsa.
• Crea tre miniature delle tre dimensioni specificate.
• Crea un’immagine di JPEG dalla risorsa, partendo dal presupposto che la risorsa non sia originariamente né un GIF né un PNG (nel qual caso non viene creato alcun 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: Nessuno

• Timeout: Ignorato

nocciolo

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

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

• Payload: Nessuno

• Argomenti: Nessuno

• Timeout: Ignorato

rule-false

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

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

• Payload: Nessuno

• Argomenti: Nessuno

• Timeout: Ignorato

esempio

Questo è un esempio di processo ECMAScript.

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

• Payload: Nessuno

• Argomenti: Nessuno

• Timeout: Ignorato

LockProcess

Blocca il payload del flusso di lavoro.

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

• Payload: JCR_PATH e JCR_UUID

• Argomenti: Nessuno

• Timeout: Ignorato

Il passaggio non ha effetto nelle seguenti circostanze:

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

SbloccaProcesso

Sblocca il payload del flusso di lavoro.

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

• Payload: JCR_PATH e JCR_UUID

• Argomenti: Nessuno

• Timeout: Ignorato

Il passaggio non ha effetto nelle seguenti circostanze:

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

Processi di gestione delle versioni

Il processo seguente 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 UID che fa riferimento a una pagina o a una risorsa DAM

• Argomenti: Nessuno

• Timeout: Rispettato