Per l'utilizzo dell'interfaccia classica, consultare la documentazione di AEM 6.3 come riferimento.
È possibile creare un modello di flusso di lavoro per definire la serie di passaggi eseguiti quando un utente avvia il flusso di lavoro. Potete inoltre definire le proprietà del modello, ad esempio se il flusso di lavoro è transitorio o utilizza più risorse.
Quando un utente avvia un flusso di lavoro, viene avviata un’istanza; questo è il modello runtime corrispondente, creato quando si Sincronizza le modifiche.
La prima volta che create un nuovo modello di workflow, questo contiene:
Per creare un nuovo flusso di lavoro con l’editor:
Se create modelli a livello di programmazione (utilizzando un pacchetto crx), potete anche creare una sottocartella all'interno di:
/var/workflow/models
Esempio, /var/workflow/models/prototypes
Questa cartella può essere utilizzata per gestire l'accesso ai modelli in quella cartella.
Puoi modificare qualsiasi modello di flusso di lavoro esistente per:
La modifica di un flusso di lavoro Predefinito e/o Legacy (out-of-the-box) dispone di un passaggio aggiuntivo, per garantire che una copia sicura venga eseguita prima di apportare le modifiche.
Al termine degli aggiornamenti al flusso di lavoro, è necessario utilizzare Sync per Generare un modello runtime. Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
La sincronizzazione (a destra nella barra degli strumenti dell'editor) genera un modello runtime. Il modello di runtime è il modello effettivamente utilizzato quando un utente avvia un flusso di lavoro. Se non Sincronizza le modifiche, le modifiche non saranno disponibili in fase di esecuzione.
Quando modificate il flusso di lavoro (o qualsiasi altro utente) dovete utilizzare Sync per generare un modello di runtime, anche quando le singole finestre di dialogo (ad esempio, per i passaggi) dispongono di proprie opzioni di salvataggio.
Quando le modifiche vengono sincronizzate con il modello runtime (salvato), viene visualizzato Sincronizzato.
Alcuni passaggi contengono campi obbligatori e/o sono incorporati nella convalida. Se queste condizioni non sono soddisfatte, quando si tenta di sincronizzare il modello verrà visualizzato un errore. Ad esempio, quando non è stato definito alcun partecipante per un passaggio Participant:
Quando si apre un modello Predefinito e/o Legacy per la modifica:
/libs
/etc
/conf
Per ulteriori informazioni, vedere Locations of Workflow Models.
Sarà necessario aggiungere dei passaggi al modello per rappresentare l'attività da eseguire. Ogni passaggio esegue un'attività specifica. Una selezione di componenti passo è disponibile in un’istanza AEM standard.
Quando si modifica un modello, i passaggi disponibili vengono visualizzati nei vari gruppi del browser Passaggi. Esempio:
Per informazioni sui componenti del passaggio principale installati con AEM, vedere Riferimento passaggi del flusso di lavoro.
Per aggiungere passaggi al modello di workflow:
Aprire un modello di flusso di lavoro esistente per la modifica. Dalla console Modello flussi di lavoro, selezionare il modello richiesto, quindi Modifica.
Aprite il browser Passaggi; utilizzando Attiva/disattiva pannello laterale, all'estrema sinistra della barra degli strumenti superiore. È possibile:
Trascinate i passaggi appropriati nella posizione desiderata nel modello.
Ad esempio, un Passaggio partecipante.
Una volta aggiunto il flusso è possibile configurare il passaggio.
Aggiungi tutti i passaggi necessari o altri aggiornamenti.
In fase di esecuzione, i passaggi vengono eseguiti nell'ordine in cui appaiono nel modello. Dopo aver aggiunto i componenti passo, è possibile trascinarli in un'altra posizione nel modello.
È inoltre possibile copiare, tagliare, incollare, raggruppare o eliminare passaggi esistenti; come con l'editor di pagina.
È inoltre possibile comprimere o espandere i passaggi suddivisi tramite l’opzione della barra degli strumenti:
Confermate le modifiche con Sync (barra degli strumenti dell'editor) per generare il modello runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
È possibile Configurare e personalizzare il comportamento di un passaggio del flusso di lavoro utilizzando le finestre di dialogo Proprietà passaggio.
Per aprire la finestra di dialogo Proprietà passaggio per un passaggio:
Tocca o fai clic sul passaggio* *nel modello di workflow e seleziona Configura dalla barra degli strumenti del componente.
Fare doppio clic sul passaggio.
Per informazioni sui componenti del passaggio principale installati con AEM, vedere Riferimento passaggi del flusso di lavoro.
Configurare le Proprietà passaggio come necessario; le proprietà disponibili dipendono dal tipo di passaggio. Possono essere disponibili anche diverse schede. Ad esempio, il Passo partecipante predefinito, presente in un nuovo flusso di lavoro come Step 1
:
Conferma gli aggiornamenti con un segno di spunta.
Confermate le modifiche con Sync (barra degli strumenti dell'editor) per generare il modello runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
È possibile creare un modello di flusso di lavoro Temporaneo durante la creazione di un nuovo modello o modificando un modello esistente:
Aprire il modello di workflow per modificare.
Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attivare Flusso di lavoro temporaneo (o disattivarlo se necessario):
Confermare la modifica con Save & Close; seguito da Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
Se un modello di workflow è presente nell'interfaccia classica, ma manca nel menu a comparsa di selezione nella barra Timeline dell'interfaccia utente touch, segui la configurazione per renderlo disponibile. Nei passaggi seguenti viene illustrato l'utilizzo del modello di flusso di lavoro denominato Richiesta di attivazione.
Verificate che il modello non sia disponibile nell'interfaccia touch. Accedete a una risorsa utilizzando il percorso /assets.html/content/dam
. Selezionate una risorsa. Aprire Timeline nella barra a sinistra. Fare clic su Avvia flusso di lavoro e confermare che il modello Richiedi attivazione non è presente nell'elenco a comparsa.
Navigare tra Strumenti > Generale > Assegnazione tag. Selezionare Workflow.
Selezionare Crea > Crea tag. Impostare Title come DAM
e Name come dam
. Seleziona Invia.
Passare a Strumenti > Flusso di lavoro > Modelli. Selezionare Request for Activation, quindi selezionare Edit.
Selezionare Modifica, aprire il menu Informazioni pagina, quindi selezionare Apri proprietà e passare alla scheda Base (se non è già aperta).
Aggiungere Workflow : DAM
al campo Tag. Confermare la selezione con il segno di spunta (segno di spunta).
Confermate l'aggiunta del tag con Save & Close.
Completare il processo con Sync. Il flusso di lavoro è ora disponibile nell’interfaccia touch.
È possibile configurare un modello di flusso di lavoro per Supporto risorse multiple durante la creazione di un nuovo modello o modificando uno esistente:
Aprire il modello di workflow per modificare.
Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attivare Supporto risorse multiple (o disattivarlo se necessario):
Confermare la modifica con Save & Close; seguito da Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
Gli stadi del flusso di lavoro consentono di visualizzare l’avanzamento di un flusso di lavoro durante la gestione delle attività.
Se le fasi del flusso di lavoro sono definite in Proprietà pagina, ma non sono utilizzate per nessuna delle fasi del flusso di lavoro, la barra di avanzamento non mostrerà alcun avanzamento (indipendentemente dal passaggio del flusso di lavoro corrente).
Le fasi da rendere disponibili sono definite nei modelli di flusso di lavoro; i modelli di flusso di lavoro esistenti possono essere aggiornati per includere le definizioni degli stadi. Potete definire un numero qualsiasi di fasi per il modello di workflow.
Per definire stadi per il flusso di lavoro:
Aprite il modello di workflow per la modifica.
Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti. Aprite la scheda Stages.
Aggiungete (e posizionate) le fasi richieste. Potete definire un numero qualsiasi di fasi per il modello di workflow.
Esempio:
Fare clic su Salva e chiudi per salvare le proprietà.
Assegnare un passaggio a ciascuno dei passaggi del modello di workflow. Esempio:
Un passaggio può essere assegnato a più passaggi. Esempio:
Incremento | Stadio |
---|---|
Passaggio 1 | Crea |
Passaggio 2 | Crea |
Passaggio 3 | Recensione |
Passaggio 4 | Approva |
Passaggio 5 | Approva |
Passaggio 6 | Completa |
Confermate le modifiche con Sync (barra degli strumenti dell'editor) per generare il modello runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
Per esportare un modello di workflow in un pacchetto:
Create un nuovo pacchetto utilizzando Gestione pacchetti:
Andate a Gestione pacchetti tramite Strumenti, Distribuzione, Pacchetti.
Fare clic su Crea pacchetto.
Specificate il Nome pacchetto e tutti gli altri dettagli richiesti.
Fai clic su OK.
Fate clic su Modifica sulla barra degli strumenti del nuovo pacchetto.
Aprire la scheda Filtri.
Selezionare Aggiungi filtro e specificare il percorso del modello di flusso di lavoro progettazione:
/conf/global/settings/workflow/models/<*your-model-name*>
Fare clic su Fine.
Selezionare Aggiungi filtro e specificare il percorso del modello di flusso di lavoro runtime:
/var/workflow/models/<*your-model-name*>
Fare clic su Fine.
Aggiungere altri filtri per eventuali script personalizzati utilizzati dal modello.
Fare clic su Salva per confermare le definizioni dei filtri.
Selezionate Build dalla barra degli strumenti della definizione del pacchetto.
Selezionate Download dalla barra degli strumenti del pacchetto.
È possibile configurare un modulo da elaborare in base al flusso di lavoro selezionato. Quando gli utenti inviano il modulo, viene creata una nuova istanza di workflow con i dati dell'invio del modulo come payload.
Per configurare il flusso di lavoro da utilizzare con il modulo:
Create una nuova pagina e apritela per la modifica.
Aggiungete un componente Modulo alla pagina.
Configurate il componente Modulo iniziale visualizzato nella pagina.
Utilizzate Avvia flusso di lavoro per selezionare il flusso di lavoro desiderato tra quelli disponibili:
Confermare la nuova configurazione del modulo con il segno di spunta.
È buona prassi, quando si esegue il test di un flusso di lavoro, utilizzare diversi tipi di payload; compresi i tipi diversi da quello per il quale è stato sviluppato. Ad esempio, se intendete gestire il flusso di lavoro con le risorse, verificatene il funzionamento impostando una pagina come payload e accertatevi che non generi errori.
Ad esempio, verificate il nuovo flusso di lavoro come segue:
Avviate il modello di flusso di lavoro dalla console.
Definire il Payload e confermare.
Eseguite le azioni necessarie per continuare il flusso di lavoro.
Monitorare i file di registro mentre il flusso di lavoro è in esecuzione.
È inoltre possibile configurare AEM per visualizzare i messaggi DEBUG nei file di registro. Per ulteriori informazioni, vedere Logging e al termine dello sviluppo, impostare il Livello di registro di nuovo su Info.
Per illustrare alcune delle possibilità di creazione di un flusso di lavoro, nell'esempio seguente viene creata una variante del flusso di lavoro Publish Example
.
Creare un nuovo modello di workflow.
Il nuovo flusso di lavoro conterrà:
Step 1
Elimina Step 1
(in quanto si tratta del tipo di passaggio errato per questo esempio):
Dalla selezione Workflow del browser dei passaggi, trascinare un Passo partecipante nel flusso di lavoro e posizionarlo tra Inizio flusso e Fine flusso.
Per aprire la finestra di dialogo delle proprietà:
Nella scheda Common immettere Validate Content
sia per Title che per Description.
Aprite la scheda Utente/gruppo:
Administrator
( admin
) per il campo Utente/Gruppo.Per inviare le e-mail, i dettagli del servizio e dell'account utente devono essere configurati.
Confermate gli aggiornamenti con il segno di spunta.
Nella panoramica del modello di workflow, il passaggio partecipante verrà rinominato in Validate Content
.
Trascinare un elemento O dividere nel flusso di lavoro e posizionarlo tra Validate Content
e Fine flusso.
Aprire la O Split per la configurazione.
Configurazione:
Comune: specificare il nome della divisione.
Filiale 1: selezionare Percorso predefinito.
Filiale 2: assicurarsi che i router predefiniti non siano selezionati.
Confermate gli aggiornamenti alla OR Split.
Trascinate un passo partecipante sul ramo sinistro, aprite le proprietà, specificate i seguenti valori, quindi confermate le modifiche:
Titolo: Reject Publish Request
Utente/gruppo: ad esempio, projects-administrators
Notifica agli utenti tramite e-mail: Attivate questa opzione per ricevere una notifica tramite e-mail all’utente.
Trascinate un Passaggio processo sul ramo di destra, aprite le proprietà, specificate i seguenti valori, quindi confermate le modifiche:
Titolo: Publish Page as Requested
Processo: selezionare Activate Page
. Questa procedura consente di pubblicare la pagina selezionata nelle istanze dell'editore.
Fare clic su Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
Il nuovo modello di flusso di lavoro sarà simile al seguente:
Applicate questo flusso di lavoro alla pagina, in modo che quando l'utente passa al passaggio Completa Convalida contenuto, possa selezionare se desidera Pubblicare pagina come richiesto o Rifiuta richiesta di pubblicazione.
OPPURE Le fasi iniziali consentono di introdurre percorsi di elaborazione condizionale nel flusso di lavoro.
Per definire una regola OR, procedere come segue:
Creare due script e salvarli nell'archivio, ad esempio in:
/apps/myapp/workflow/scripts
Gli script devono avere una funzione check()
che restituisce un valore booleano.
Modificate il flusso di lavoro e aggiungete OR Split al modello.
Modificare le proprietà di Ramo 1 della OR Split:
Definite questo valore come percorso predefinito impostando il valore Valore su true
.
Come Rule, impostate il percorso dello script. Esempio:
/apps/myapp/workflow/scripts/myscript1.ecma
Se necessario, è possibile cambiare l'ordine del ramo.
Modificare le proprietà della Ramo 2 della OR Split.
Come Rule, imposta il percorso dell'altro script. Esempio:
/apps/myapp/workflow/scripts/myscript2.ecma
Impostare le proprietà dei singoli passaggi in ciascun ramo. Assicurarsi che l'opzione Utente/gruppo sia impostata.
Fare clic su Sincronizza (barra degli strumenti dell'editor) per mantenere le modifiche apportate al modello di runtime.
Per ulteriori informazioni, vedere Sincronizzazione del flusso di lavoro.
Vedere Utilizzo di ECMAScript.
Lo script di esempio seguente restituisce true
se il nodo è un JCR_PATH
situato sotto /content/we-retail/us/en
:
function check() {
if (workflowData.getPayloadType() == "JCR_PATH") {
var path = workflowData.getPayload().toString();
var node = jcrSession.getItem(path);
if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
return true;
} else {
return false;
}
} else {
return false;
}
}
Puoi personalizzare qualsiasi flusso di lavoro predefinito. Per ottenere un comportamento personalizzato, sovrapponete i dettagli del flusso di lavoro appropriato.
Ad esempio, Richiesta di attivazione. Questo flusso di lavoro viene utilizzato per la pubblicazione di pagine all'interno di Sites e viene attivato automaticamente quando un autore di contenuto non dispone dei diritti di replica appropriati. Per ulteriori informazioni, consultate Personalizzazione dell'authoring delle pagine - Personalizzazione del flusso di lavoro di richiesta dell'attivazione.