Creazione di modelli di flussi di lavoro

ATTENZIONE

Per l’utilizzo dell’interfaccia classica, consulta Documentazione di AEM 6.3 di riferimento.

Crea un modello di flusso di lavoro definire la serie di passaggi eseguiti quando un utente avvia il flusso di lavoro. Puoi anche definire le proprietà del modello, ad esempio se il flusso di lavoro è transitorio o se utilizza più risorse.

Quando un utente avvia un flusso di lavoro, viene avviata un’istanza; si tratta del modello runtime corrispondente, creato quando Sincronizzazione le modifiche.

Creazione di un nuovo flusso di lavoro

Quando crei un nuovo modello di flusso di lavoro, 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/rimossi.
  • Un esempio Partecipante passaggio denominato Passaggio 1.
    Questo passaggio è configurato per assegnare un elemento di lavoro all’iniziatore del flusso di lavoro. Modifica o elimina questo passaggio e aggiungi i passaggi necessari.

Per creare un nuovo flusso di lavoro con l’editor:

  1. Apri Modelli di flusso di lavoro console; tramite Strumenti, Flusso di lavoro, Modelli o, ad esempio: https://localhost:4502/aem/workflow
  2. Seleziona Crea, quindi Crea modello.
  3. La Aggiungi modello flusso di lavoro viene visualizzata la finestra di dialogo . Inserisci il Titolo e Nome (facoltativo) prima di selezionare Fine.
  4. Il nuovo modello è elencato nella Modelli di flusso di lavoro console.
  5. Seleziona il nuovo flusso di lavoro, quindi utilizza Modifica per aprirlo alla configurazione:
    wf-01
NOTA

Se crei modelli a livello di programmazione (utilizzando un pacchetto crx) puoi anche creare una sottocartella in:

/var/workflow/models

Esempio, /var/workflow/models/prototypes

Questa cartella può quindi essere utilizzata per gestione dell’accesso ai modelli in quella cartella.

Modifica di un flusso di lavoro

Puoi modificare qualsiasi modello di flusso di lavoro esistente in modo da:

Modifica di un Predefinito e/o legacy Flusso di lavoro predefinito dispone di un ulteriore passaggio per garantire che copia sicura viene eseguito prima delle modifiche.

Quando gli aggiornamenti al flusso di lavoro sono completi devi utilizzare Sincronizzazione a Generare un modello runtime. Vedi Sincronizza il flusso di lavoro per i dettagli.

Sincronizza il flusso di lavoro - Genera un modello runtime

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 Sincronizzazione le modifiche apportate non saranno quindi disponibili in fase di esecuzione.

Quando apporti modifiche al flusso di lavoro (o a qualsiasi altro utente) devi utilizzare Sincronizzazione per generare un modello di runtime, anche quando le singole finestre di dialogo (ad esempio, per i passaggi) dispongono di opzioni di salvataggio personalizzate.

Quando le modifiche sono sincronizzate con il modello runtime (salvato), Sincronizzato viene invece visualizzato.

Alcuni passaggi dispongono di campi obbligatori e/o di una convalida integrata. Quando queste condizioni non sono soddisfatte, viene visualizzato un errore quando si tenta di Sincronizzazione il modello. Ad esempio, quando non è stato definito alcun partecipante per un Partecipante passo:

wf-21

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

Quando si apre un Modello predefinito e/o legacy per la modifica:

  • Il browser Passaggi non è disponibile (lato sinistro).
  • C'è un Modifica nella barra degli strumenti (a destra).
  • Inizialmente il modello e le sue proprietà vengono presentate 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
      Selezione
      Modifica :
  • acquisire una copia del flusso di lavoro in /conf
  • rendere disponibile il browser Passaggi
  • consente di apportare modifiche
NOTA

Vedi Posizioni dei modelli di flussi di lavoro per ulteriori informazioni.

wf-22

Aggiunta di un passaggio a un modello

Sarà necessario aggiungere 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 modificate un modello, i passaggi disponibili vengono visualizzati nei vari gruppi della Browser dei passaggi. Esempio:

wf-10

NOTA

Per informazioni sui componenti del passaggio principale installati con AEM, consulta Riferimento passaggi del flusso di lavoro.

Per aggiungere passaggi al modello di flusso di lavoro:

  1. Apri un modello di flusso di lavoro esistente da modificare. Da Modello flussi di lavoro console, selezionate il modello desiderato, quindi Modifica.

  2. Apri il browser Passaggi; utilizzo Attiva/Disattiva pannello laterale all’estrema sinistra della barra degli strumenti superiore. È possibile:

    • Filtro per passaggi specifici.
    • Utilizza il selettore a discesa per limitare la selezione a un gruppo specifico di passaggi.
    • Seleziona l’icona Mostra descrizione wf-stepinfo-icon per visualizzare ulteriori dettagli sul passaggio appropriato.

    wf-02

  3. Trascina i passaggi appropriati nella posizione desiderata nel modello.

    Ad esempio, un Passaggio partecipante.

    Una volta aggiunto al flusso puoi configurare il passaggio.

    wf-03

  4. Aggiungi tutti i passaggi necessari o altri aggiornamenti.

    In fase di esecuzione, i passaggi vengono eseguiti nell’ordine in cui compaiono nel modello. Dopo aver aggiunto i componenti passo, potete trascinarli in una posizione diversa nel modello.

    È inoltre possibile copiare, tagliare, incollare, raggruppare o eliminare i passaggi esistenti; come con il editor di pagine.

    È inoltre possibile comprimere/espandere i passaggi suddivisi utilizzando l’opzione della barra degli strumenti: wf-comprimere-expand-toolbar-icon

  5. Conferma le modifiche con Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

Configurazione di un passaggio del flusso di lavoro

È possibile Configura e personalizzare il comportamento di un passaggio del flusso di lavoro utilizzando Proprietà passaggio finestre di dialogo.

  1. Per aprire Proprietà passaggio per un passaggio:

    • Tocca o fai clic sul passaggio* nel modello di flusso di lavoro e seleziona Configura dalla barra degli strumenti del componente.

    • Fare doppio clic sul passaggio.

    NOTA

    Per informazioni sui componenti del passaggio principale installati con AEM, consulta Riferimento passaggi del flusso di lavoro.

  2. Configura le Proprietà passaggio se necessario; le proprietà disponibili dipendono dal tipo di passaggio, possono essere disponibili anche diverse schede. Ad esempio, il valore predefinito Passaggio partecipante, presente in un nuovo flusso di lavoro come Step 1:

    wf-11

  3. Conferma gli aggiornamenti con il segno di spunta.

  4. Conferma le modifiche con Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

Creazione di un flusso di lavoro transitorio

Puoi creare una Transiente modello di flusso di lavoro durante la creazione di un nuovo modello o modificando un modello esistente:

  1. Apri il modello di flusso di lavoro per modifica.

  2. Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.

  3. Nella finestra di dialogo attiva Flusso di lavoro transitorio (o disattivalo se necessario):

    wf-07

  4. Conferma la modifica con Salva e chiudi; seguito da Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

NOTA

Quando esegui un flusso di lavoro in transient la modalità AEM non memorizza alcuna cronologia del flusso di lavoro. Pertanto, Timeline non visualizza alcuna informazione relativa a quel flusso di lavoro.

Rendere disponibili i modelli di flusso di lavoro nell’interfaccia utente touch

Se un modello di flusso di lavoro è presente nell’interfaccia classica, ma manca nel menu a comparsa di selezione nella Timeline barra dell’interfaccia utente touch, quindi segui la configurazione per renderla disponibile. I passaggi seguenti illustrano l’utilizzo del modello di flusso di lavoro denominato Richiesta di attivazione.

  1. Verifica che il modello non sia disponibile nell’interfaccia utente touch. Accedere a una risorsa utilizzando /assets.html/content/dam percorso. Seleziona una risorsa. Apri Timeline nella barra a sinistra. Fai clic su Avvia flusso di lavoro e confermare che Richiesta di attivazione modello non presente nell'elenco popup.

  2. Passa a Strumenti > Generale > Assegnazione tag. Seleziona Flusso di lavoro.

  3. Seleziona Crea > Crea tag. Imposta Titolo come DAM e Nome come dam. Seleziona Invia.
    Crea tag nel modello di flusso di lavoro

  4. Passa a Strumenti > Flusso di lavoro > Modelli. Seleziona Richiesta di attivazione, quindi seleziona Modifica.

  5. Seleziona Modifica, apri Informazioni pagina e da lì selezionare Apri proprietà e vai al Base (se non è già aperto).

  6. Aggiungi Workflow : DAM a Tag campo . Conferma la selezione con il segno di spunta (segno di spunta).

  7. Conferma l’aggiunta del tag con Salva e chiudi.
    Modifica proprietà pagina del modello

  8. Completa il processo con Sincronizzazione. Il flusso di lavoro è ora disponibile nell’interfaccia touch.

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

Puoi configurare un modello di flusso di lavoro per Supporto per più risorse durante la creazione di un nuovo modello o modificando un modello esistente:

  1. Apri il modello di flusso di lavoro per modifica.

  2. Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.

  3. Nella finestra di dialogo attiva Supporto per più risorse (o disattivalo se necessario):

    wf-08

  4. Conferma la modifica con Salva e chiudi; seguito da Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

Configurazione delle fasi del flusso di lavoro (che mostrano l’avanzamento del flusso di lavoro)

Fasi del flusso di lavoro aiuta a visualizzare l’avanzamento di un flusso di lavoro durante la gestione delle attività.

ATTENZIONE

Se le fasi del flusso di lavoro sono definite in Proprietà pagina, ma non utilizzato per nessuno dei passaggi del flusso di lavoro, la barra di avanzamento non mostrerà alcun progresso (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. Puoi definire un numero qualsiasi di fasi per il modello di flusso di lavoro.

Per definire Fasi per il flusso di lavoro:

  1. Apri il modello di flusso di lavoro per la modifica.

  2. Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti. Quindi apri la Fasi scheda .

  3. Aggiungi (e posiziona) il tuo Fasi. Puoi definire un numero qualsiasi di fasi per il modello di flusso di lavoro.

    Esempio:

    wf-08-1

  4. Fai clic su Salva e chiudi per salvare le proprietà.

  5. Assegna un passaggio a ciascuno dei passaggi del modello di flusso di lavoro. Esempio:

    wf-09

    Un passaggio può essere assegnato a più passaggi. Esempio:

    Incremento Stadio
    Passaggio 1 Creare
    Passaggio 2 Creare
    Passaggio 3 Recensione
    Passaggio 4 Approva
    Passaggio 5 Approva
    Passaggio 6 Completa
  6. Conferma le modifiche con Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

Esportazione di un modello di flusso di lavoro in un pacchetto

Per esportare un modello di flusso di lavoro in un pacchetto:

  1. Crea un nuovo pacchetto utilizzando Gestione pacchetti:

    1. Passa a Gestione pacchetti tramite Strumenti, Distribuzione, Pacchetti.

    2. Fai clic su Crea pacchetto.

    3. Specifica la Nome pacchetto, e tutti gli altri dettagli richiesti.

    4. Fai clic su OK.

  2. Fai clic su Modifica sulla barra degli strumenti del nuovo pacchetto.

  3. Apri Filtri scheda .

  4. Seleziona Aggiungi filtro e specifica il percorso del modello di flusso di lavoro progettazione:

    /conf/global/settings/workflow/models/<*your-model-name*>

    Fai clic su Fine.

  5. Seleziona Aggiungi filtro e specifica il percorso del runtime modello di flusso di lavoro:

    /var/workflow/models/<*your-model-name*>

    Fai clic su Fine.

  6. Aggiungi altri filtri per gli script personalizzati utilizzati dal modello.

  7. Fai clic su Salva per confermare le definizioni dei filtri.

  8. Seleziona Crea dalla barra degli strumenti della definizione del pacchetto.

  9. Seleziona Scarica dalla barra degli strumenti del pacchetto.

Utilizzo dei flussi di lavoro per elaborare gli invii di moduli

È possibile configurare un modulo da elaborare dal flusso di lavoro selezionato. Quando gli utenti inviano il modulo, viene creata una nuova istanza di flusso di lavoro con i dati dell’invio del modulo come payload.

Per configurare il flusso di lavoro da utilizzare con il modulo:

  1. Crea una nuova pagina e aprila per la modifica.

  2. Aggiungete un componente Modulo alla pagina.

  3. Configura la Inizio modulo componente visualizzato nella pagina.

  4. Utilizzo Avvia flusso di lavoro per selezionare il flusso di lavoro desiderato tra quelli disponibili:

    wf-12

  5. Confermare la nuova configurazione del modulo con un segno di spunta.

Verifica dei flussi di lavoro

È buona prassi testare un flusso di lavoro per utilizzare diversi tipi di payload; compresi i tipi diversi da quello per il quale è stato sviluppato. Ad esempio, se vuoi che il flusso di lavoro gestisca le risorse, testalo impostando una pagina come payload e accertati che non generi errori.

Ad esempio, verifica il nuovo flusso di lavoro come segue:

  1. Avvia il modello di flusso di lavoro dalla console.

  2. Definisci la Payload e confermare.

  3. Esegui le azioni necessarie affinché il flusso di lavoro proceda.

  4. Monitora i file di registro mentre il flusso di lavoro è in esecuzione.

Puoi anche configurare AEM da visualizzare DEBUG nei file di registro. Vedi Registrazione per ulteriori informazioni e al termine dello sviluppo, imposta la Livello di log torna a Info.

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, l’esempio seguente crea una variante del Publish Example workflow.

  1. Creare un nuovo modello di flusso di lavoro.

    Il nuovo flusso di lavoro conterrà:

    • Avvio del flusso
    • Step 1
    • Fine del flusso
  2. Elimina Step 1 (in quanto si tratta di un tipo di passaggio errato per questo esempio):

    • Fai clic sul passaggio e seleziona Elimina dalla barra degli strumenti del componente. Conferma l’azione.
  3. Da Flusso di lavoro selezione del browser dei passaggi, trascinare un Passaggio partecipante nel flusso di lavoro e posizionalo tra Inizio flusso e Fine flusso.

  4. Per aprire la finestra di dialogo delle proprietà:

    • Fai clic sul passaggio del partecipante e seleziona Configura dalla barra degli strumenti del componente.
    • Fare doppio clic sul passaggio del partecipante.
  5. In Comune inserisci Validate Content per entrambi Titolo e Descrizione.

  6. Apri Utente/gruppo scheda:

    • Attiva Notifica all’utente via e-mail.
    • Seleziona Administrator ( admin) per Utente/gruppo campo .
  7. Conferma gli aggiornamenti con il segno di spunta.

    Verrai riportato alla panoramica del modello di flusso di lavoro, in cui il passaggio del partecipante sarà stato rinominato in Validate Content.

  8. Trascina un O Divisione nel flusso di lavoro e posizionalo tra Validate Content e Fine flusso.

  9. Apri O Divisione per la configurazione.

  10. Configurare:

    • Comune: specificare il nome della divisione.

    • Filiale 1: select Percorso predefinito.

    • Filiale 2: assicurare Percorso predefinito non è selezionato.

  11. Conferma gli aggiornamenti di Divisione OR.

  12. Trascina un Passaggio partecipante al ramo a sinistra, apri le proprietà, specifica i seguenti valori, quindi conferma le modifiche:

    • Titolo: Reject Publish Request

    • Utente/gruppo: ad esempio, projects-administrators

    • Notifica all’utente via e-mail: Attiva per ricevere notifiche dall’utente tramite e-mail.

  13. Trascina un Passaggio al processo al ramo di destra, apri le proprietà, specifica i seguenti valori, quindi conferma le modifiche:

    • Titolo: Publish Page as Requested

    • Processo: select Activate Page. Questa procedura pubblica la pagina selezionata alle istanze dell’editore.

  14. Fai clic su Sincronizzazione (barra degli strumenti dell’editor) per generare il modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

    Il nuovo modello di flusso di lavoro sarà simile al seguente:

    wf-13

  15. Applica questo flusso di lavoro alla pagina, in modo che quando l’utente si sposta in Completa la Convalida contenuto possono scegliere se desiderano Pubblica pagina come richiesto oppure Rifiuta richiesta di pubblicazione.

    chlimage_1-72

Esempio: Definizione di una regola per una divisione OR utilizzando lo script ECMA

Divisione OR i passaggi ti consentono di introdurre percorsi di elaborazione condizionale nel flusso di lavoro.

Per definire una regola OR, procedere come segue:

  1. Creare due script e salvarli nell'archivio, ad esempio in:

    /apps/myapp/workflow/scripts

    NOTA

    Gli script devono avere un Funzione check() che restituisce un valore booleano.

  2. Modifica il flusso di lavoro e aggiungi il Divisione OR al modello.

  3. Modifica le proprietà di Filiale 1 del Divisione OR:

    • Definisci questo come Percorso predefinito impostando Valore a true.

    • Come Regola, imposta il percorso dello script. Esempio:

      /apps/myapp/workflow/scripts/myscript1.ecma

    NOTA

    Se necessario, puoi cambiare l’ordine del ramo.

  4. Modifica le proprietà del Filiale 2 del Divisione OR.

    • Come Regola, imposta il percorso dell'altro script. Esempio:

      /apps/myapp/workflow/scripts/myscript2.ecma

  5. Imposta le proprietà dei singoli passaggi in ciascun ramo. Assicurati che Utente/gruppo è impostato.

  6. Fai clic su Sincronizzazione (barra degli strumenti dell’editor) per mantenere le modifiche apportate al modello di runtime.

    Vedi Sincronizza il flusso di lavoro per i dettagli.

Funzione Check()

Il seguente script di esempio 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;
     }
}

Esempio: Richiesta di attivazione personalizzata

Puoi personalizzare uno qualsiasi dei flussi di lavoro predefiniti. Per ottenere un comportamento personalizzato sovrapponi i dettagli del flusso di lavoro appropriato.

Ad esempio: Richiesta di attivazione. Questo flusso di lavoro viene utilizzato per la pubblicazione delle pagine all’interno di Sites e viene attivato automaticamente quando un autore di contenuti non dispone dei diritti di replica appropriati. Vedi Personalizzazione dell’authoring delle pagine - Personalizzazione del flusso di lavoro di richiesta di attivazione per ulteriori dettagli.

In questa pagina