Guida di riferimento per i passaggi dei flussi di lavoro workflow-step-reference

I modelli di flusso di lavoro sono costituiti da una serie di passaggi di vari tipi. A seconda del tipo, questi passaggi possono essere configurati ed estesi con parametri e script per fornire le funzionalità e il controllo necessari.

Proprietà passaggio step-properties

Ogni componente del passaggio ha una finestra di dialogo Proprietà passaggio che consente di definire e modificare le proprietà richieste.

Proprietà passaggio: scheda Comune step-properties-common-tab

Nella scheda Comune della finestra di dialogo delle proprietà è disponibile una combinazione delle seguenti proprietà per la maggior parte dei componenti del passaggio del flusso di lavoro:

Proprietà passaggio: scheda Utente/gruppo step-properties-user-group-tab

Le seguenti proprietà sono disponibili per molti componenti del passaggio del flusso di lavoro, nella scheda Utente/Gruppo della finestra di dialogo delle proprietà:

Suddivisione E and-split

La [0}divisione AND crea una [PROD143]e nel flusso di lavoro, dopo la quale entrambi i rami sono attivi. Puoi aggiungere i passaggi del flusso di lavoro a ogni ramo in base alle esigenze. Questo passaggio ti consente di introdurre più percorsi di elaborazione nel flusso di lavoro. Ad esempio, puoi consentire che determinati passaggi di revisione si verifichino in parallelo, risparmiando tempo.

Suddivisione AND - Configurazione and-split-configuration

Per configurare la suddivisione:

Passaggio contenitore container-step

Un passaggio contenitore avvia un altro modello di flusso di lavoro che viene eseguito come flusso di lavoro figlio.

Questo contenitore può consentire di riutilizzare i modelli di flusso di lavoro per implementare sequenze di passaggi comuni. Ad esempio, un modello di flusso di lavoro di traduzione può essere utilizzato in più flussi di lavoro di modifica.

Passaggio contenitore - Configurazione container-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Passaggio goto-step

Il passaggio Vai a consente di specificare il passaggio successivo da eseguire nel modello di flusso di lavoro. È possibile specificare una definizione di regola, uno script esterno o uno script ECMA come espressione di indirizzamento per valutare il passaggio successivo per il modello di flusso di lavoro.

Il passaggio Vai a consente di implementare strutture di routing avanzate nei modelli di flusso di lavoro. Ad esempio, per implementare un ciclo, è possibile definire il passaggio Goto per eseguire un passaggio precedente nel flusso di lavoro, con l'espressione di routing che valuta una condizione di ciclo.

Passaggio - Configurazione goto-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Simulazione di un ciclo for simulating-a-for-loop

La simulazione di un ciclo "for" richiede di mantenere un conteggio del numero di iterazioni del ciclo che si sono verificate:

Ad esempio, per implementare un flusso di lavoro che esegue un’azione su più nodi JCR, puoi utilizzare un contatore di loop come indice per i nodi. Per mantenere il conteggio, memorizzare un valore integer nella mappa dati dell'istanza del flusso di lavoro. Per incrementare il conteggio e confrontare il conteggio con i criteri di uscita, utilizzare lo script del Passaggio a destinazione.

function check(){
   var count=0;
   var keyname="loopcount"
   try{
      if (workflowData.getMetaDataMap().containsKey(keyname)){
        log.info("goto script: found loopcount key");
        count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
      }

     workflowData.getMetaDataMap().put(keyname,count);

     }catch(err) {
         log.info(err.message);
         return false;
    }
   if (parseInt(count) <7){
       return true;
   } else {
      return false;
   }
}

Simulazione di un ciclo for tramite la definizione della regola simulateforloop

Potete anche simulare un ciclo for utilizzando Definizione regola (Rule Definition) come espressione di instradamento. Creare una variabile count di tipo di dati Long. Utilizza Espressione come modalità di mappatura nel passaggio Imposta variabile per impostare il valore della variabile count su count + 1 a ogni esecuzione del passaggio Imposta variabile.

Nel Passaggio destinazione, utilizza Imposta variabile come Passaggio destinazione e conteggio < 5 come espressione di routing.

Il passaggio Imposta variabile viene eseguito ripetutamente, incrementando il valore della variabile count di 1 a ogni esecuzione fino a raggiungere il valore 5.

Suddivisione O or-split

La divisione OR crea una divisione nel flusso di lavoro, dopo la quale è attivo un solo ramo. Questo passaggio ti consente di introdurre nel flusso di lavoro i percorsi di elaborazione condizionale. Puoi aggiungere i passaggi del flusso di lavoro a ogni ramo in base alle esigenze.

Suddivisione OR - Configurazione or-split-configuration

Per configurare la suddivisione:

Passaggi e selettori partecipanti participant-steps-and-choosers

Passaggio partecipante participant-step

Un Passaggio partecipante consente di assegnare la proprietà per una determinata azione. Il flusso di lavoro procede solo quando l’utente ha riconosciuto manualmente il passaggio. Questo flusso di lavoro viene utilizzato quando si desidera che un utente lo utilizzi. Ad esempio, un passaggio di revisione.

Anche se non direttamente correlata, l’autorizzazione dell’utente deve essere considerata durante l’assegnazione di un’azione; l’utente deve avere accesso alla pagina che è il payload del flusso di lavoro.

Passaggio partecipante - Configurazione participant-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Passaggio partecipante finestra di dialogo dialog-participant-step

Utilizza un Passaggio partecipante finestra di dialogo per raccogliere informazioni dall'utente a cui è assegnato l'elemento di lavoro. Questo passaggio è utile per raccogliere piccole quantità di dati da utilizzare successivamente nel flusso di lavoro.

Al termine del passaggio, la finestra di dialogo Completa elemento di lavoro contiene i campi definiti nella finestra di dialogo. I dati raccolti nei campi vengono memorizzati nei nodi del payload del flusso di lavoro. I passaggi successivi del flusso di lavoro possono quindi leggere il valore dall’archivio.

Per configurare il passaggio, specificare il gruppo o l'utente a cui assegnare l'elemento di lavoro e il percorso della finestra di dialogo.

Passaggio partecipante finestra di dialogo - Configurazione dialog-participant-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Passaggio partecipante finestra di dialogo - Creazione di una finestra di dialogo dialog-participant-step-creating-a-dialog

Per creare una finestra di dialogo, è necessario creare la finestra di dialogo:

Passaggio partecipante finestra di dialogo - Memorizzazione dei dati nel payload dialog-participant-step-storing-data-in-the-payload

Puoi memorizzare i dati del widget nel payload del flusso di lavoro o nei metadati dell’elemento di lavoro. Il formato della proprietà name del nodo widget determina dove vengono memorizzati i dati.

Passaggio partecipante finestra di dialogo - Definizione finestra di dialogo dialog-participant-step-dialog-definition

Passaggio partecipante dinamico dynamic-participant-step

Il componente Passaggio partecipante dinamico è simile al Passaggio partecipante con la differenza che il partecipante viene selezionato automaticamente in fase di esecuzione.

Per configurare il passaggio, selezionare un Selettore partecipanti che identifica il partecipante a cui assegnare l'elemento di lavoro, insieme a una finestra di dialogo.

Passaggio partecipante dinamico - Configurazione dynamic-participant-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Passaggio partecipante dinamico: sviluppo del selettore partecipanti dynamic-participant-step-developing-the-participant-chooser

Puoi creare il selettore partecipanti. Pertanto, puoi utilizzare qualsiasi logica o criterio di selezione. Ad esempio, il selettore partecipanti può selezionare l'utente (all'interno di un gruppo) con il minor numero di elementi di lavoro. Puoi creare un numero qualsiasi di selettori partecipanti da utilizzare con istanze diverse del componente Passaggio partecipante dinamico nei modelli di flusso di lavoro.

Crea un servizio OSGi o un ECMAScript che seleziona un utente a cui assegnare l’elemento di lavoro.

Passaggio partecipante dinamico - Esempio di servizio Selettore partecipanti dynamic-participant-step-example-participant-chooser-service

La classe Java™ seguente implementa l'interfaccia ParticipantStepChooser. La classe restituisce il nome del partecipante che ha avviato il workflow. Il codice utilizza la stessa logica utilizzata dallo script di esempio (initiator-participant-chooser.ecma).

L'annotazione @Property imposta il valore del campo SERVICE_PROPERTY_LABEL su Workflow Initiator Participant Chooser.

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;

@Component
@Service
@Properties({
        @Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
        @Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public String getParticipant(WorkItem arg0, WorkflowSession arg1,
   MetaDataMap arg2) throws WorkflowException {

  String initiator = arg0.getWorkflow().getInitiator();
  logger.info("Assigning Dynamic Participant Step work item to {}",initiator);

  return initiator;
 }
}

Nella finestra di dialogo delle proprietà Passaggio partecipante dinamico, l'elenco Selettore partecipanti include l'elemento Workflow Initiator Participant Chooser (script), che rappresenta questo servizio.

All'avvio del modello di workflow, il log indica l'ID dell'utente che ha avviato il workflow e a cui è assegnato l'elemento di lavoro. In questo esempio, l'utente admin ha avviato il flusso di lavoro.

13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin

Passaggio partecipante modulo form-participant-step

Il passaggio Partecipante modulo presenta un modulo all'apertura dell'elemento di lavoro. Quando l’utente compila e invia il modulo, i dati dei campi vengono memorizzati nei nodi del payload del flusso di lavoro.

Per configurare il passaggio, specificare il gruppo o l'utente a cui assegnare l'elemento di lavoro e il percorso del modulo.

Passaggio partecipante modulo - Configurazione form-participant-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Passaggio partecipante modulo: creazione del modulo form-participant-step-creating-the-form

Crea un modulo da utilizzare con Passaggio partecipante modulo come normale. Tuttavia, i moduli per un passaggio Partecipante modulo devono avere le seguenti configurazioni:

I requisiti del flusso di lavoro determinano la posizione in cui memorizzare i dati dei campi. Ad esempio, i dati dei campi possono essere utilizzati per configurare le proprietà del contenuto della pagina. Il valore seguente di una proprietà Nome elemento memorizza i dati del campo come valore della proprietà redirectTarget del nodo jcr:content:

./jcr:content/redirectTarget

Nell'esempio seguente, i dati del campo vengono utilizzati come contenuto di un componente Text nella pagina del payload:

./jcr:content/par/text_3/text

Il primo esempio può essere utilizzato per qualsiasi pagina di cui viene eseguito il rendering del componente cq:Page. Il secondo esempio può essere utilizzato solo quando la pagina di payload include un componente Text con ID text_3.

Il modulo può trovarsi in qualsiasi punto del repository, tuttavia gli utenti del flusso di lavoro devono essere autorizzati a leggerlo.

Selettore casuale partecipanti random-participant-chooser

Il passaggio Selettore casuale partecipanti è un selettore partecipanti che assegna l'elemento di lavoro generato a un utente selezionato casualmente da un elenco.

Selettore casuale partecipanti - Configurazione random-participant-chooser-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Selettore partecipante iniziatore flusso di lavoro workflow-initiator-participant-chooser

Il passaggio Selettore partecipante iniziatore flusso di lavoro è un selettore partecipanti che assegna l'elemento di lavoro generato all'utente che ha avviato il flusso di lavoro. Nessuna proprietà da configurare diversa dalle proprietà Common.

Selettore partecipante iniziatore flusso di lavoro - Configurazione workflow-initiator-participant-chooser-configuration

Per configurare il passaggio, modifica utilizzando le seguenti schede:

Passaggio processo process-step

Un passaggio processo esegue un ECMAScript o chiama un servizio OSGi per eseguire l'elaborazione automatica.

Passaggio processo - Configurazione process-step-configuration

Per configurare il passaggio, modifica e utilizza le seguenti schede:

Imposta variabile set-variable

Il passaggio Imposta variabile consente di impostare il valore di una variabile e definire l'ordine in cui i valori vengono impostati. La variabile viene impostata nell'ordine in cui le mappature delle variabili sono elencate nel passaggio Imposta variabile.

Imposta variabile - Configurazione setvariable

Per configurare il passaggio, modifica e utilizza le seguenti schede: