Show Menu
ARGOMENTI×

Creazione di modelli di flussi di lavoro

Per l’utilizzo dell’interfaccia classica, consulta la documentazione di AEM 6.3 per riferimento.
Potete creare un modello di workflow 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; si tratta del modello runtime corrispondente, creato al momento della sincronizzazione delle modifiche.

Creazione di un nuovo flusso di lavoro

La prima volta che create un nuovo modello di workflow, questo contiene:
  • I passaggi, Inizio ​flusso e Fine ​flusso.
    che rappresentano l’inizio e la fine del flusso di lavoro. Questi passaggi sono obbligatori e non possono essere modificati o rimossi.
  • Esempio di passaggio partecipante denominato Passaggio 1 .
    Questo passaggio è configurato per assegnare un elemento di lavoro all’iniziatore del flusso di lavoro. Modificate o eliminate questo passaggio e aggiungete i passaggi richiesti.
Per creare un nuovo flusso di lavoro con l’editor:
  1. Aprire la console Modelli ​flusso di lavoro; tramite Strumenti , Workflow , Modelli o, ad esempio:
  2. Select Create , then Create Model .
  3. Viene visualizzata la finestra di dialogo Aggiungi modello flusso di lavoro. Immettete Titolo e Nome (facoltativo) prima di selezionare Fine .
  4. Il nuovo modello è elencato nella console Modelli di workflow.
  5. Selezionate il nuovo flusso di lavoro, quindi utilizzate Modifica :
Se create modelli a livello di programmazione (utilizzando un pacchetto crx), potete anche creare una sottocartella all'interno di:
/var/workflow/models
Ad esempio: /var/workflow/models/prototypes
Questa cartella può quindi essere utilizzata per gestire l’accesso ai modelli presenti nella cartella .

Modifica di un flusso di lavoro

Puoi modificare qualsiasi modello di flusso di lavoro esistente per:
La modifica di un flusso di lavoro (out-of-the-box) prevede un passaggio aggiuntivo, per garantire che venga effettuata una copia Posizioni - Modelli di workflow sicura prima che vengano apportate le modifiche.
Al termine degli aggiornamenti al flusso di lavoro, è necessario utilizzare la sincronizzazione per generare un modello runtime. Consultate Sincronizzazione del flusso di lavoro .

Sincronizzazione del flusso di lavoro - Generazione di un modello runtime

La sincronizzazione (a destra nella barra degli strumenti dell'editor) genera un modello Modello runtime runtime. Il modello di runtime è il modello effettivamente utilizzato quando un utente avvia un flusso di lavoro. Se non sincronizzate le modifiche, queste non saranno disponibili in fase di esecuzione.
Quando modificate il flusso di lavoro (o qualsiasi altro utente) dovete usare Sincronizza per generare un modello di runtime, anche quando le singole finestre di dialogo (ad esempio, per i passaggi) hanno le proprie opzioni di salvataggio.
Quando le modifiche vengono sincronizzate con il modello runtime (salvato), viene visualizzata la sincronizzazione .
Alcuni passaggi contengono campi obbligatori e/o sono incorporati nella convalida. Se queste condizioni non sono soddisfatte, quando tentate di sincronizzare il modello verrà visualizzato un errore. Ad esempio, quando non è stato definito alcun partecipante per un passaggio Partecipante :

Modifica di un flusso di lavoro predefinito o legacy per la prima volta

Quando si apre un modello Tipi di flussi di lavoro Predefinito e/o Legacy per la modifica:
  • Il browser Passaggi non è disponibile (lato sinistro).
  • È disponibile un’azione Modifica nella barra degli strumenti (a destra).
  • Inizialmente il modello e le relative proprietà vengono presentati in modalità di sola lettura come segue:
    • I flussi di lavoro predefiniti si trovano in /libs
    • I flussi di lavoro legacy si trovano in /etc
Selezionando Modifica :
  • acquisire una copia del flusso di lavoro /conf
  • rendere disponibile il browser Passi
  • consente di apportare modifiche
Per ulteriori informazioni, consulta Posizioni dei modelli di flussi di lavoro.

Aggiunta di un passaggio a un modello

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 standard di AEM.
Quando modificate un modello, i passaggi disponibili vengono visualizzati nei vari gruppi del browser Passaggi . Ad esempio:
Per informazioni sui componenti del passaggio principale installati con AEM, consultate Riferimento per i passaggi del flusso di lavoro.
Per aggiungere un passaggio a un modello :
  1. Aprire un modello di flusso di lavoro esistente per la modifica. Dalla console Modello ​flussi di lavoro, selezionare il modello desiderato, quindi Modifica .
  2. Aprire il browser Passi ; tramite Attiva/Disattiva pannello laterale, all’estrema sinistra della barra degli strumenti superiore. È possibile:
    • Filtrare per passaggi specifici.
    • Utilizzate il selettore a discesa per limitare la selezione a un gruppo specifico di passaggi.
    • Selezionate l’icona Mostra descrizione per visualizzare ulteriori dettagli sul passaggio appropriato.
  3. Trascinate i passaggi appropriati nella posizione desiderata nel modello.
    Ad esempio, un Passaggio ​partecipante.
    Una volta aggiunto al flusso, puoi configurare il passaggio .
  4. 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 pagina.
    È inoltre possibile comprimere o espandere i passaggi suddivisi tramite l’opzione della barra degli strumenti: wf-
  5. Confermate le modifiche con Sincronizzazione (barra degli strumenti dell'editor) per generare il modello runtime.

Configurazione di un passaggio del flusso di lavoro

È possibile configurare e personalizzare il comportamento di un passaggio di workflow utilizzando le finestre di dialogo Proprietà ​passaggio.
  1. Per aprire la finestra di dialogo Proprietà ​passaggio per un passaggio:
    • Toccate il passaggio nel modello di workflow e selezionate Configura dalla barra degli strumenti del componente.
    • Fare doppio clic sul passaggio.
    Per informazioni sui componenti del passaggio principale installati con AEM, consultate Riferimento per i passaggi del flusso di lavoro.
  2. Configurare le proprietà del passo come necessario; le proprietà disponibili dipendono dal tipo di passaggio. Possono essere disponibili anche diverse schede. Ad esempio, il Passaggio ​partecipante predefinito, presente in un nuovo flusso di lavoro come Step 1 :
  3. Conferma gli aggiornamenti con un segno di spunta.
  4. Confermate le modifiche con Sincronizzazione (barra degli strumenti dell'editor) per generare il modello runtime.

Creazione di un flusso di lavoro transitorio

È possibile creare un modello di flusso di lavoro transitorio quando si crea un nuovo modello, oppure modificando un modello esistente:
  1. Aprite il modello di workflow per la modifica .
  2. Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti.
  3. Nella finestra di dialogo, attivate Flusso di lavoro transitorio (o disattivate se necessario):
  4. Confermare la modifica con Save & Close ; seguita da Sincronizzazione (barra degli strumenti dell'editor) per generare il modello runtime.
Quando eseguite un flusso di lavoro in modalità temporanea , AEM non memorizza alcuna cronologia del flusso di lavoro. Pertanto, la timeline non visualizza alcuna informazione relativa a tale flusso di lavoro. Timeline

Rendere disponibili i modelli di workflow nell'interfaccia utente touch

Se un modello di flusso di lavoro è presente nell’interfaccia classica, ma manca nel menu a comparsa di selezione nella barra Timeline dell’interfaccia touch, seguite la configurazione per renderlo disponibile. Nei passaggi seguenti viene illustrato l'utilizzo del modello di workflow denominato Richiesta di attivazione .
  1. Verificate che il modello non sia disponibile nell'interfaccia touch. Accedete a una risorsa utilizzando il /assets.html/content/dam percorso. Selezionate una risorsa. Aprite Timeline nella parte sinistra. Fare clic su Avvia flusso di lavoro e confermare che il modello Richiedi attivazione non è presente nell'elenco a comparsa.
  2. Passare a Strumenti > Generale > Assegnazione tag . Selezionate Flusso di lavoro .
  3. Selezionare Crea > Crea tag . Impostate Titolo come DAM e Nome come dam . Seleziona Invia .
  4. Selezionare Strumenti > Flusso di lavoro > Modelli . Selezionate Richiedi attivazione , quindi selezionate Modifica .
  5. Selezionare Modifica , quindi aprire Proprietà modello flusso di lavoro . Passate alla scheda Base .
  6. Aggiungere Workflow : DAM al campo Tag . Confermare la selezione con il segno di spunta (segno di spunta).
  7. Confermate l'aggiunta del tag con Salva e chiudi .
  8. Completate il processo con Sync . Il flusso di lavoro è ora disponibile nell’interfaccia touch.

Configurazione di un flusso di lavoro per il supporto di più risorse

È possibile configurare un modello di flusso di lavoro per il supporto di risorse multiple quando si crea un nuovo modello, oppure modificando uno esistente:
  1. Aprite il modello di workflow per la modifica .
  2. Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti.
  3. Nella finestra di dialogo, attivate Supporto risorse multiple (o disattivate se necessario):
  4. Confermare la modifica con Save & Close ; seguita da Sincronizzazione (barra degli strumenti dell'editor) per generare il modello runtime.

Configurazione delle fasi del flusso di lavoro (che mostrano lo stato del flusso di lavoro)

Le fasi 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 i passaggi 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 di fase. Potete definire un numero qualsiasi di fasi per il modello di workflow.
Per definire i passaggi del flusso di lavoro:
  1. Aprite il modello di workflow per la modifica.
  2. Selezionare Proprietà modello flusso di lavoro dalla barra degli strumenti. Quindi aprite la scheda Stadi .
  3. Aggiungi (e posiziona) le fasi richieste. Potete definire un numero qualsiasi di fasi per il modello di workflow.
    Ad esempio:
  4. Fate clic su Salva e chiudi per salvare le proprietà.
  5. Assegnare un passaggio a ciascuno dei passaggi del modello di workflow. Ad esempio:
    Un passaggio può essere assegnato a più passaggi. Ad esempio:
    Incremento
    Stadio
    Passaggio 1
    Crea
    Passaggio 2
    Crea
    Passaggio 3
    Recensione
    Passaggio 4
    Approva
    Passaggio 5
    Approva
    Passaggio 6
    Completa
  6. Confermate le modifiche con Sincronizzazione (barra degli strumenti dell'editor) per generare il modello runtime.

Esportazione di un modello di flusso di lavoro in un pacchetto

  1. Create un nuovo pacchetto utilizzando Gestione pacchetti :
    1. Passa a Gestione pacchetti tramite Strumenti , Distribuzione e Pacchetti .
    2. Fate clic su Crea pacchetto .
    3. Specificate il Nome ​pacchetto e tutti gli altri dettagli richiesti.
    4. Fai clic su OK .
  2. Fate clic su Modifica nella barra degli strumenti del nuovo pacchetto.
  3. Open the Filters tab.
  4. Selezionate Aggiungi filtro e specificate il percorso della progettazione del modello di workflow:
    /conf/global/settings/workflow/models/<*your-model-name*>
    Fate clic su Fine .
  5. Selezionate Aggiungi filtro e specificate il percorso del modello di flusso di lavoro runtime :
    /var/workflow/models/<*your-model-name*>
    Fate clic su Fine .
  6. Aggiungere altri filtri per eventuali script personalizzati utilizzati dal modello.
  7. Fate clic su Salva per confermare le definizioni dei filtri.
  8. Selezionate Genera dalla barra degli strumenti della definizione del pacchetto.
  9. Selezionate Scarica dalla barra degli strumenti del pacchetto.

Utilizzo dei flussi di lavoro per elaborare gli invii dei moduli

È 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:
  1. Create una nuova pagina e apritela per la modifica.
  2. Aggiungete un componente Modulo alla pagina.
  3. Configurare il componente Inizio ​modulo visualizzato nella pagina.
  4. Utilizzate Avvia flusso di lavoro per selezionare il flusso di lavoro desiderato tra quelli disponibili:
  5. Confermare la nuova configurazione del modulo con il segno di spunta.

Verifica dei flussi di lavoro

È 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:
  1. Avviate il modello di workflow dalla console.
  2. Definire il payload e confermare.
  3. Eseguite le azioni necessarie per continuare il flusso di lavoro.
  4. Monitorare i file di registro mentre il flusso di lavoro è in esecuzione.
Potete anche configurare AEM per visualizzare i messaggi DEBUG nei file di registro. Per ulteriori informazioni, consulta Registrazione e al termine dello sviluppo, reimpostare il livello di registro su Informazioni .

Esempi

Esempio: Creazione di un flusso di lavoro (semplice) per accettare o rifiutare una richiesta di pubblicazione

Per illustrare alcune delle possibilità di creazione di un flusso di lavoro, nell’esempio seguente viene creata una variante del Publish Example flusso di lavoro.
  1. Il nuovo flusso di lavoro conterrà:
    • Avvio del flusso
    • Step 1
    • Fine del flusso
  2. Elimina Step 1 (il tipo di passaggio errato per questo esempio):
    • Fate clic sul passaggio e selezionate Elimina dalla barra degli strumenti del componente. Conferma l’azione.
  3. Dalla selezione Workflow del browser dei passaggi, trascinate un passo ​partecipante nel flusso di lavoro e posizionatelo tra Inizio ​flusso e **Fineflusso**.
  4. Per aprire la finestra di dialogo delle proprietà:
    • Fate clic sul passaggio partecipante e selezionate Configura dalla barra degli strumenti del componente.
    • Fate doppio clic sul passaggio del partecipante.
  5. Nella scheda Comune immettere Validate Content sia il Titolo che la Descrizione .
  6. Aprite la scheda Utente/Gruppo :
    • Activate Notify user via email .
    • Selezionare Administrator ( admin ) per il campo Utente/Gruppo .
    Per inviare le e-mail, è necessario configurare Configurazione delle notifiche e-mail i dettagli del servizio e dell'account utente.
  7. Conferma gli aggiornamenti con il segno di spunta.
    Nella panoramica del modello di workflow, il passaggio partecipante verrà rinominato in Validate Content .
  8. Trascinate un elemento O diviso nel flusso di lavoro e posizionatelo tra Validate Content e fine ​flusso.
  9. Aprite il file OR Split per la configurazione.
  10. Configura:
    • Comune : seleziona 2 rami
    • Filiale 1 : selezionare Percorso ​predefinito.
    • Filiale 2 : assicurarsi che l'opzione Route ​predefinita non sia selezionata.
  11. Confermate gli aggiornamenti a OR Split .
  12. 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.
  13. Trascinare un passo ​di processo sul ramo a destra, aprire le proprietà, specificare i valori seguenti, quindi confermare le modifiche:
    • Titolo : Publish Page as Requested
    • Processo : selezionare Activate Page . Questa procedura consente di pubblicare la pagina selezionata nelle istanze dell'editore.
  14. Fate clic su Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
    Il nuovo modello di flusso di lavoro sarà simile al seguente:
  15. Applicate questo flusso di lavoro alla pagina, in modo che quando l’utente passa al passaggio Completa la convalida del contenuto , possa selezionare se desidera pubblicare la pagina come richiesto o rifiutare la richiesta di pubblicazione.

Esempio: Definizione di una regola per una divisione OR

I passaggi Dividi consentono di introdurre percorsi di elaborazione condizionale nel flusso di lavoro.
Per definire una regola OR:
  1. Creare due script e salvarli nell'archivio, ad esempio in:
    /apps/myapp/workflow/scripts
    Gli script devono avere una funzione che restituisce un valore booleano.
  2. Modificate il flusso di lavoro e aggiungete la divisione OR al modello.
  3. Modificare le proprietà del ramo 1 della divisione OR :
    • Definite questa opzione come route ​predefinita impostando il valore su true .
    • Come regola , imposta il percorso dello script. Ad esempio:
      /apps/myapp/workflow/scripts/myscript1.ecma
    Se necessario, è possibile cambiare l'ordine del ramo.
  4. Modificare le proprietà del ramo 2 della divisione OR .
    • Come regola , imposta il percorso dell'altro script. Ad esempio:
      /apps/myapp/workflow/scripts/myscript2.ecma
  5. Impostare le proprietà dei singoli passaggi in ciascun ramo. Accertatevi che Utente/Gruppo sia impostato.
  6. Fate clic su Sincronizza (barra degli strumenti dell'editor) per mantenere le modifiche apportate al modello di runtime.

Function Check()

Lo script di esempio seguente restituisce true se il nodo è JCR_PATH situato in /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;
     }
}

Esempio: Richiesta personalizzata di attivazione

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 in Siti 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 di attivazione.