Guida di riferimento per il processo dei flusso di lavoro workflow-process-reference
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 process-characteristics
Per ogni fase del processo sono descritte le seguenti caratteristiche.
Percorso classe Java o ECMA java-class-or-ecma-path
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 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 arguments
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 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 permissions
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.
WorkflowProcess
implementazioni e potrebbero quindi avere accesso completo all'archivio senza dover definire ACL specifici.-
Utilizzo della console Web (
/system/console/configMgr
individua Servizio di configurazione del flusso di lavoro di Adobe Granite -
abilita Modalità Legacy del processo di workflow
WorkflowProcess
e garantire nuovamente l'accesso illimitato all'intero archivio.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 (Advancer automatico del tempo assoluto) absolutetimeautoadvancer-absolute-time-auto-advancer
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) 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) processassembler-process-assembler
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.
Ad 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 basic-processes
I processi seguenti eseguono operazioni semplici o fungono da esempi.
/libs
percorso./libs
viene sovrascritto la prossima volta che aggiorni l’istanza (e può essere sovrascritto quando applichi un hotfix o un feature pack).elimina delete
L'elemento nel percorso specificato viene eliminato.
-
Percorso ECMAScript:
/libs/workflow/scripts/delete.ecma
-
Payload: Percorso JCR
-
Argomenti: Nessuno
-
Timeout: Ignorato
nocciolo noop
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 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 sample
Questo è un esempio di processo ECMAScript.
-
Percorso ECMAScript:
/libs/workflow/scripts/sample.ecma
-
Payload: Nessuno
-
Argomenti: Nessuno
-
Timeout: Ignorato
urlcaller urlcaller
Si tratta di un semplice processo di flusso di lavoro che chiama l’URL specificato. In genere l’URL è un riferimento a un JSP (o altro servlet equivalente) che esegue un’attività semplice. Questo processo deve 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: Nessuno
-
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 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 unlockprocess
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 versioning-processes
Il processo seguente esegue un’attività relativa alla versione.
CreateVersionProcess 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