Creazione di modelli di flussi di lavoro creating-workflow-models

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CAUTION

Per utilizzare l’interfaccia classica, consulta Documentazione di AEM 6.3 per riferimento.

Si crea un modello di flusso di lavoro per definire la serie di passaggi eseguiti all’avvio del flusso di lavoro da parte di un utente. Puoi anche 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 di runtime corrispondente, creato quando Sincronizza le tue modifiche.

Creazione di un nuovo flusso di lavoro creating-a-new-workflow

La prima volta che crei un modello di flusso di lavoro, contiene:

I passaggi, Inizio flusso e Fine flusso.
Questi rappresentano l’inizio e la fine del flusso di lavoro. Questi passaggi sono necessari 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 richiesti.

Per creare un flusso di lavoro con l’editor:

Apri Modelli flusso di lavoro console; tramite Strumenti, Flusso di lavoro, Modelli o, ad esempio: https://localhost:4502/aem/workflow
Seleziona Crea, quindi Crea modello.
Il Aggiungi modello flusso di lavoro viene visualizzata. Inserisci il Titolo e Nome (facoltativo) prima di selezionare Fine.
Il nuovo modello è elencato nel Modelli flusso di lavoro console.
Seleziona il nuovo flusso di lavoro, quindi utilizza Modifica per aprirlo per la configurazione:

NOTE

Se crei modelli a livello di programmazione (utilizzando un pacchetto crx), puoi anche creare una sottocartella all’interno di:

/var/workflow/models

Ad esempio /var/workflow/models/prototypes

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

Modifica di un flusso di lavoro editing-a-workflow

Puoi modificare qualsiasi modello di flusso di lavoro esistente in:

definire i passaggi e i loro parametri
configurare le proprietà del flusso di lavoro, tra cui stadi, se il flusso di lavoro è transitorio e/o utilizza più risorse

Modifica di un Predefinito e/o legacy flusso di lavoro (preconfigurato) dispone di un passaggio aggiuntivo per garantire che copia sicura viene eseguita prima delle modifiche.

Una volta completati gli aggiornamenti del flusso di lavoro, devi utilizzare Sincronizza a Generare un modello runtime. Consulta Sincronizza il flusso di lavoro per i dettagli.

Sincronizzare il flusso di lavoro - Generare un modello di runtime sync-your-workflow-generate-a-runtime-model

Sincronizza (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. In caso contrario Sincronizza le modifiche, quindi non saranno disponibili in fase di runtime.

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 proprie.

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

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

wf-21

Modifica di un flusso di lavoro predefinito o legacy per la prima volta editing-a-default-or-legacy-workflow-for-the-first-time

All'apertura di un Modello predefinito e/o legacy per la modifica:

Il browser Passaggi non è disponibile (lato sinistro).
È presente un Modifica nella barra degli strumenti (a destra).
Inizialmente il modello e le relative proprietà vengono presentati in modalità di sola lettura come:
- I flussi di lavoro predefiniti sono in /libs
- I flussi di lavoro legacy sono in /etc
  Selezione Modifica consente di:
copia del flusso di lavoro in /conf
rendere disponibile il browser Passaggi
consente di apportare modifiche

NOTE

Consulta Posizioni dei modelli di workflow per ulteriori informazioni.

wf-22

Aggiunta di un passaggio a un modello adding-a-step-to-a-model

Aggiungi i passaggi al modello per rappresentare l’attività da eseguire: ogni passaggio esegue un’attività specifica. Una selezione di componenti step è disponibile in un’istanza AEM standard.

Quando modificate un modello, i passi disponibili vengono visualizzati nei vari gruppi della Browser Passaggi. Ad esempio:

wf-10

NOTE

Per informazioni sui componenti della fase 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 per la modifica. Dalla sezione 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:
- Filtro per passaggi specifici.
- Utilizza il selettore a discesa per limitare la selezione a un gruppo specifico di passaggi.
- Seleziona l’icona Mostra descrizione per visualizzare ulteriori dettagli sul passaggio appropriato.
Trascinate i passi appropriati nella posizione desiderata nel modello.

Ad esempio, un Passaggio partecipante.

Una volta aggiunto al flusso è possibile: configurare il passaggio.
Aggiungi tutti i passaggi, o altri aggiornamenti, necessari.

In fase di esecuzione, i passi vengono eseguiti nell'ordine in cui vengono visualizzati nel modello. Dopo aver aggiunto i componenti del passo, potete trascinarli in una posizione diversa nel modello.

È inoltre possibile copiare, tagliare, incollare, raggruppare o eliminare passaggi esistenti, come con Editor pagina.

I passaggi di suddivisione possono anche essere compressi o espansi utilizzando l’opzione della barra degli strumenti:
Conferma le modifiche con Sincronizza (barra degli strumenti dell’editor) per generare il modello runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

Configurazione di un passaggio del flusso di lavoro configuring-a-workflow-step

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

Per aprire Proprietà passaggio per un passaggio:

Fai clic sul passaggio* *nel modello di flusso di lavoro e seleziona Configura dalla barra degli strumenti del componente.
Fare doppio clic sul passaggio.

note note
NOTE
Per informazioni sui componenti della fase principale installati con AEM, consulta Riferimento passaggi flusso di lavoro.

Configurare Proprietà passaggio se necessario; le proprietà disponibili dipendono dal tipo di passaggio, potrebbero anche essere disponibili diverse schede. Ad esempio, il valore predefinito Passaggio partecipante, presente in un nuovo flusso di lavoro come Step 1:
Conferma gli aggiornamenti selezionando.
Conferma le modifiche con Sincronizza (barra degli strumenti dell’editor) per generare il modello runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

Creazione di un flusso di lavoro transitorio creating-a-transient-workflow

Puoi creare una Transitorio modello di flusso di lavoro durante la creazione di un modello o modificandone uno esistente:

Apri il modello di flusso di lavoro per modifica.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attiva Flusso di lavoro transitorio (o disattivarla, se necessario):
Conferma la modifica con Salva e chiudi; seguito da Sincronizza (barra degli strumenti dell’editor) per generare il modello runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

NOTE

Quando esegui un flusso di lavoro in transitorio modalità AEM non memorizza alcuna cronologia del flusso di lavoro. Pertanto, Timeline non visualizza alcuna informazione correlata a tale flusso di lavoro.

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

Se un modello di flusso di lavoro è presente nell’interfaccia classica, ma non è presente nel menu a comparsa di selezione nella Timeline 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.

Verifica che il modello non sia disponibile nell’interfaccia utente touch. Accedere a una risorsa tramite /assets.html/content/dam percorso. Seleziona una risorsa. Apri Timeline nella barra a sinistra. Clic Avvia flusso di lavoro e confermare che Richiesta di attivazione il modello non è presente nell’elenco a comparsa.
Naviga Strumenti > Generale > Assegnazione tag. Seleziona Flusso di lavoro.
Seleziona Crea > Crea tag. Imposta Titolo as DAM e Nome as dam. Seleziona Invia.
Accedi a Strumenti > Workflow > Modelli. Seleziona Richiesta di attivazione, quindi seleziona Modifica.
Seleziona Modifica, apri Informazioni pagina e da qui selezionare Apri proprietà e vai al Base (se non è già aperta).
Aggiungi Workflow : DAM a Tag campo. Conferma la selezione selezionando (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 utente touch.

Configurazione di un flusso di lavoro per il supporto di più risorse configuring-a-workflow-for-multi-resource-support

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

Apri il modello di flusso di lavoro per modifica.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti.
Nella finestra di dialogo attiva Supporto di più risorse (o disattivarla, se necessario):
Conferma la modifica con Salva e chiudi; seguito da Sincronizza (barra degli strumenti dell’editor) per generare il modello runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

Configurazione delle fasi del flusso di lavoro (che mostrano l’avanzamento del flusso di lavoro) configuring-workflow-stages-that-show-workflow-progress

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

CAUTION

Se le fasi del flusso di lavoro sono definite Proprietà pagina, ma non viene utilizzato per nessuno dei passaggi del flusso di lavoro, la barra di avanzamento non mostra 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 delle fasi. È possibile definire un numero qualsiasi di fasi per il modello di flusso di lavoro.

Per definire Fasi per il workflow:

Apri il modello di flusso di lavoro per la modifica.
Seleziona Proprietà modello flusso di lavoro dalla barra degli strumenti. Quindi apri la Fasi scheda.
Aggiungi (e posiziona) il necessario Fasi. È possibile definire un numero qualsiasi di fasi per il modello di flusso di lavoro.

Ad esempio:
Clic Salva e chiudi per salvare le proprietà.

Assegna una fase a ciascuno dei passaggi nel modello di flusso di lavoro. Ad esempio:

wf-09

È possibile assegnare una fase a più fasi. Ad esempio:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Passaggio	Fase
Passaggio 1	Creare
Passaggio 2	Creare
Passaggio 3	Rivedi
Passaggio 4	Approva
Passaggio 5	Approva
Passaggio 6	Completato

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

Consulta Sincronizza il flusso di lavoro per i dettagli.

Esportazione di un modello di flusso di lavoro in un pacchetto exporting-a-workflow-model-in-a-package

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

Creare un pacchetto utilizzando Gestione pacchetti:
1. Passa a Gestione pacchetti tramite Strumenti, Distribuzione, Pacchetti.
2. Clic Crea pacchetto.
3. Specifica la Nome pacchetto, ed eventuali altri dettagli richiesti.
4. Fai clic su OK.
Clic Modifica sulla barra degli strumenti del nuovo pacchetto.
Apri Filtri scheda.
Seleziona Aggiungi filtro e specifica il percorso del modello di flusso di lavoro progettazione:

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

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

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

Clic Fine.
Aggiungi altri filtri per gli script personalizzati utilizzati dal modello.
Clic Salva per confermare le definizioni dei filtri.
Seleziona Genera dalla barra degli strumenti della definizione del pacchetto.
Seleziona Scarica dalla barra degli strumenti del pacchetto.

Utilizzo dei flussi di lavoro per elaborare gli invii dei moduli using-workflows-to-process-form-submissions

È possibile configurare un modulo da elaborare tramite il 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 pagina e aprila per la modifica.
Aggiungi un Modulo alla pagina.
Configura il Inizio modulo componente visualizzato nella pagina.
Utilizzare Avvia flusso di lavoro per selezionare il flusso di lavoro desiderato tra quelli disponibili:
Conferma la nuova configurazione del modulo selezionando.

Verifica dei flussi di lavoro testing-workflows

È buona prassi quando si esegue il test di un flusso di lavoro per utilizzare diversi tipi di payload, inclusi quelli diversi da quello per cui è stato sviluppato. Ad esempio, se desideri che il flusso di lavoro gestisca le risorse, testa impostando una pagina come payload e assicurati che non generi errori.

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

Avvia il modello di flusso di lavoro dalla console.
Definisci il Payload e confermare.
Intraprende le azioni necessarie in modo che il flusso di lavoro proceda.
Monitora i file di registro durante l’esecuzione del flusso di lavoro.

Puoi anche configurare l’AEM per la visualizzazione DEBUG messaggi nei file di registro. Consulta Registrazione per ulteriori informazioni e al termine dello sviluppo, impostare Livello registro torna a Info.

Esempi examples

Esempio: creazione di un flusso di lavoro (semplice) per accettare o rifiutare una richiesta di pubblicazione example-creating-a-simple-workflow-to-accept-or-reject-a-request-for-publication

Per illustrare alcune delle possibilità di creazione di un flusso di lavoro, nell'esempio seguente viene creata una variante di Publish Example flusso di lavoro.

Creare un modello di flusso di lavoro.

Il nuovo flusso di lavoro conterrà:
- Inizio flusso
- Step 1
- Fine flusso
Elimina Step 1 (in quanto si tratta del tipo di passaggio errato per questo esempio):
- Fai clic sul passaggio e seleziona Elimina dalla barra degli strumenti del componente. Conferma l’azione.
Dalla sezione Flusso di lavoro selezione dei passaggi, trascina un Passaggio partecipante nel flusso di lavoro e posizionarlo tra Inizio flusso e Fine flusso.
Per aprire la finestra di dialogo delle proprietà:
- Fai clic sul passaggio partecipante e seleziona Configura dalla barra degli strumenti del componente.
- Fare doppio clic sul passaggio partecipante.
In Comune scheda immetti Validate Content per entrambi i Titolo e Descrizione.

Apri Utente/Gruppo scheda:

Attiva Notifica all'utente via e-mail.
Seleziona Administrator ( admin) per Utente/Gruppo campo.

note note
NOTE
Per l’invio delle e-mail, è necessario configurare il servizio di posta e i dettagli dell'account utente.

Conferma gli aggiornamenti selezionando.

Tornerai alla panoramica del modello di flusso di lavoro. Il passaggio partecipante sarà stato rinominato in Validate Content.
Trascina una Suddivisione O nel flusso di lavoro e posizionarlo tra Validate Content e Fine flusso.
Apri Suddivisione O per la configurazione.
Configurare:
- Comune: specifica il nome della divisione.
- Ramo 1: seleziona Percorso predefinito.
- Ramo 2: assicurare Percorso predefinito non è selezionato.
Conferma gli aggiornamenti a Suddivisione O.
Trascina un Passaggio partecipante nel ramo sinistro, 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 questa opzione per inviare all’utente una notifica via e-mail.
Trascina un Passaggio processo nel ramo destro, apri le proprietà, specifica i seguenti valori, quindi conferma le modifiche:
- Titolo: Publish Page as Requested
- Processo: seleziona Activate Page. Questo processo pubblica la pagina selezionata nelle istanze dell’editore.
Clic Sincronizza (barra degli strumenti dell’editor) per generare il modello runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

Il nuovo modello di flusso di lavoro sarà simile al seguente:
Applica questo flusso di lavoro alla pagina, in modo che quando l’utente si sposta in Completa il Convalida contenuto , è possibile scegliere se Pubblica pagina come richiesto, o Rifiuta richiesta di pubblicazione.

Esempio: definizione di una regola per una suddivisione OR utilizzando lo script ECMA defineruleecmascript

Suddivisione O I passaggi ti consentono di introdurre nel flusso di lavoro i percorsi di elaborazione condizionale.

Per definire una regola OR, procedere come segue:

Crea due script e salvali nell’archivio, ad esempio, in:

/apps/myapp/workflow/scripts

note note
NOTE
Gli script devono avere funzione `check()` che restituisce un valore booleano.

Modifica il flusso di lavoro e aggiungi Suddivisione O al modello.

Modifica le proprietà di Ramo 1 del Suddivisione O:

Definisci come Percorso predefinito impostando Valore a true.
As Regola, imposta il percorso dello script. Ad esempio:

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

note note
NOTE
Se necessario, puoi cambiare l’ordine della filiale.

Modifica le proprietà del Ramo 2 del Suddivisione O.
- As Regola, imposta il percorso dell'altro script. Ad esempio:
  
  /apps/myapp/workflow/scripts/myscript2.ecma
Imposta le proprietà dei singoli passaggi in ciascun ramo. Assicurati che le Utente/Gruppo è impostato.
Clic Sincronizza (barra degli strumenti dell’editor) per mantenere le modifiche apportate al modello di runtime.

Consulta Sincronizza il flusso di lavoro per i dettagli.

Function Check() function-check

NOTE

Consulta Utilizzo di ECMAScript.

Lo script di esempio seguente restituisce true se il nodo è un 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 di attivazione personalizzata example-customized-request-for-activation

Puoi personalizzare qualsiasi flusso di lavoro predefinito. Per ottenere un comportamento personalizzato, puoi sovrapporre i dettagli del flusso di lavoro appropriato.

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2