Per l'utilizzo dell'interfaccia classica, consulta la documentazione AEM 6.3 come riferimento.
Puoi creare un modello di flusso di lavoro per 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 Sincronizza le modifiche.
Quando crei un nuovo modello di flusso di lavoro, questo contiene:
Per creare un nuovo flusso di lavoro con l’editor:
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 gestire l'accesso ai modelli in quella cartella.
Puoi modificare qualsiasi modello di flusso di lavoro esistente in modo da:
La modifica di un flusso di lavoro Predefinito e/o Legacy (preconfigurato) ha un passaggio aggiuntivo, per garantire che venga effettuata una copia sicura prima di apportare le modifiche.
Al termine degli aggiornamenti del flusso di lavoro, è necessario utilizzare Sincronizza per Generare un modello runtime. Per ulteriori informazioni, consulta Sincronizza il 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, queste non saranno disponibili in fase di esecuzione.
Quando apporti modifiche al flusso di lavoro (o a qualsiasi altro utente) devi utilizzare Sincronizza 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 vengono sincronizzate con il modello di runtime (salvato), viene visualizzato Sincronizzato.
Alcuni passaggi dispongono di campi obbligatori e/o di una convalida integrata. Quando queste condizioni non vengono soddisfatte, viene visualizzato un errore quando si tenta di Sincronizzare il modello. Ad esempio, quando non è stato definito alcun partecipante per un passaggio Partecipante:
Quando si apre un modello Predefinito e/o Legacy per la modifica:
/libs
/etc
/conf
Per ulteriori informazioni, consulta Posizioni dei modelli di flussi di lavoro .
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 modifichi un modello, i passaggi disponibili vengono visualizzati nei vari gruppi del browser Passaggi. Esempio:
Per informazioni sui componenti del passaggio principale installati con AEM, consulta Riferimento passaggi flusso di lavoro.
Per aggiungere passaggi al modello di flusso di lavoro:
Apri un modello di flusso di lavoro esistente da modificare. Dalla console Modello flussi di lavoro, seleziona il modello richiesto, quindi Modifica.
Apri il browser Passaggi; utilizzando Attiva/disattiva pannello laterale, all'estrema sinistra della barra degli strumenti superiore. È possibile:
Trascina i passaggi appropriati nella posizione desiderata nel modello.
Ad esempio, un Passaggio partecipante.
Una volta aggiunto al flusso, puoi configurare il passaggio.
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 l' editor di pagine.
È inoltre possibile comprimere/espandere i passaggi suddivisi utilizzando l’opzione della barra degli strumenti:
Conferma le modifiche con Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il 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 flusso di lavoro e seleziona Configura dalla barra degli strumenti del componente.
Fare doppio clic sul passaggio.
Per informazioni sui componenti del passaggio principale installati con AEM, consulta Riferimento passaggi flusso di lavoro.
Configura le Proprietà passaggio come richiesto; 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
:
Conferma gli aggiornamenti con il segno di spunta.
Conferma le modifiche con Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il flusso di lavoro .
Puoi creare un modello di flusso di lavoro Transitent quando crei un nuovo modello o modificane uno esistente:
Apri il modello di flusso di lavoro per modificare.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attiva Flusso di lavoro transitorio (o disattiva se necessario):
Conferma la modifica con Salva e chiudi; seguita da Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il flusso di lavoro .
Se un modello di flusso di lavoro è 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. I passaggi seguenti illustrano l'utilizzo del modello di flusso di lavoro denominato Richiesta di attivazione.
Verifica che il modello non sia disponibile nell’interfaccia utente touch. Accedi a una risorsa utilizzando il percorso /assets.html/content/dam
. Seleziona una risorsa. Apri 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.
Passa a Strumenti > Generale > Assegnazione tag. Seleziona Flusso di lavoro.
Seleziona Crea > Crea tag. Imposta Titolo come DAM
e Nome come dam
. Seleziona Invia.
Passa a Strumenti > Flusso di lavoro > Modelli. Seleziona Richiesta di attivazione, quindi seleziona Modifica.
Seleziona Modifica, apri il menu Informazioni pagina e da lì seleziona Apri proprietà e vai alla scheda Base (se non è già aperta).
Aggiungi Workflow : DAM
al campo Tag . Conferma la selezione con il segno di spunta (segno di spunta).
Conferma l’aggiunta del tag con Salva e chiudi.
Completa il processo con Sincronizza. Il flusso di lavoro è ora disponibile nell’interfaccia touch.
Puoi configurare un modello di flusso di lavoro per Supporto risorse multiple durante la creazione di un nuovo modello o modificandone uno esistente:
Apri il modello di flusso di lavoro per modificare.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attiva Supporto risorse multiple (o disattiva se necessario):
Conferma la modifica con Salva e chiudi; seguita da Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il 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 vengono utilizzate per nessuno dei 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 degli stadi. Puoi definire un numero qualsiasi di fasi per il modello di flusso di lavoro.
Per definire Stadi per il flusso di lavoro:
Apri il modello di flusso di lavoro per la modifica.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti. Quindi apri la scheda Stadi .
Aggiungi (e posiziona) i Stadi richiesti. Puoi definire un numero qualsiasi di fasi per il modello di flusso di lavoro.
Esempio:
Fai clic su Salva e chiudi per salvare le proprietà.
Assegna un passaggio a ciascuno dei passaggi del modello di flusso di lavoro. 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 |
Conferma le modifiche con Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il flusso di lavoro .
Per esportare un modello di flusso di lavoro in un pacchetto:
Crea un nuovo pacchetto utilizzando Gestione pacchetti:
Passa a Gestione pacchetti tramite Strumenti, Implementazione, Pacchetti.
Fai clic su Crea pacchetto.
Specifica il Nome pacchetto e tutti gli altri dettagli richiesti.
Fai clic su OK.
Fai clic su Modifica sulla barra degli strumenti del nuovo pacchetto.
Apri la scheda Filtri .
Seleziona Aggiungi filtro e specifica il percorso del modello di flusso di lavoro progettazione:
/conf/global/settings/workflow/models/<*your-model-name*>
Fare clic su Fine.
Seleziona Aggiungi filtro e specifica il percorso del modello di flusso di lavoro runtime:
/var/workflow/models/<*your-model-name*>
Fare clic su Fine.
Aggiungi altri filtri per gli script personalizzati utilizzati dal modello.
Fai clic su Salva per confermare le definizioni dei filtri.
Seleziona Build dalla barra degli strumenti della definizione del pacchetto.
Seleziona Scarica dalla barra degli strumenti del pacchetto.
È 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:
Crea una nuova pagina e aprila per la modifica.
Aggiungete un componente Modulo alla pagina.
Configura il componente Modulo iniziale visualizzato nella pagina.
Utilizza Avvia flusso di lavoro per selezionare il flusso di lavoro desiderato tra quelli disponibili:
Confermare la nuova configurazione del modulo con un segno di spunta.
È 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:
Avvia il modello di flusso di lavoro dalla console.
Definisci il Payload e conferma.
Esegui le azioni necessarie affinché il flusso di lavoro proceda.
Monitora 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, consulta Logging e al termine dello sviluppo, reimposta il Livello di log 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
.
Crea un nuovo modello di flusso di lavoro.
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 Flusso di lavoro del browser dei passaggi, trascina un Passaggio partecipante nel flusso di lavoro e posizionalo tra Inizio flusso e Fine flusso.
Per aprire la finestra di dialogo delle proprietà:
Nella scheda Comune immetti Validate Content
sia per Titolo che per Descrizione.
Apri la scheda Utente/gruppo :
Administrator
( admin
) per il campo Utente/Gruppo.Per inviare e-mail, è necessario configurare i dettagli del servizio e dell'account utente .
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
.
Trascina un elemento O Split nel flusso di lavoro e posizionalo tra Validate Content
e Fine flusso.
Apri 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.
Conferma gli aggiornamenti di OR Split.
Trascina un Passaggio partecipante nel ramo a sinistra, apri le proprietà, specifica i seguenti valori, quindi conferma le modifiche:
Titolo: Reject Publish Request
Utente/gruppo: ad esempio, projects-administrators
Invia una notifica all’utente via e-mail: Attiva per ricevere notifiche dall’utente tramite e-mail.
Trascina un Passaggio processo nel ramo di destra, apri le proprietà, specifica i seguenti valori, quindi conferma le modifiche:
Titolo: Publish Page as Requested
Processo: seleziona Activate Page
. Questa procedura pubblica la pagina selezionata alle istanze dell’editore.
Fai clic su Sincronizza (barra degli strumenti dell'editor) per generare il modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il flusso di lavoro .
Il nuovo modello di flusso di lavoro sarà simile al seguente:
Applica 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.
I passaggi iniziali o parziali consentono di introdurre nel flusso di lavoro i percorsi di elaborazione condizionale.
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.
Modifica il flusso di lavoro e aggiungi OR Split al modello.
Modifica le proprietà di Ramo 1 di O Dividi:
Definiscilo come Percorso predefinito impostando il valore Valore su true
.
Come Regola, imposta il percorso dello script. Esempio:
/apps/myapp/workflow/scripts/myscript1.ecma
Se necessario, puoi cambiare l’ordine del ramo.
Modifica le proprietà della Ramo 2 del O Dividi.
Come Regola, imposta il percorso dell'altro script. Esempio:
/apps/myapp/workflow/scripts/myscript2.ecma
Imposta le proprietà dei singoli passaggi in ciascun ramo. Assicurati che il valore Utente/Gruppo sia impostato.
Fai clic su Sincronizza (barra degli strumenti dell'editor) per mantenere le modifiche al modello di runtime.
Per ulteriori informazioni, consulta Sincronizza il flusso di lavoro .
Vedere Uso di ECMAScript.
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;
}
}
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 di pagine all’interno di Sites e viene attivato automaticamente quando un autore di contenuti non dispone dei diritti di replica appropriati. Per ulteriori informazioni, consulta Personalizzazione dell’authoring delle pagine - Personalizzazione della richiesta di attivazione del flusso di lavoro .