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 Proprietà passaggio che consente di definire e modificare le proprietà richieste.

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

Per la maggior parte dei componenti del passaggio del flusso di lavoro, nella sezione Comune scheda della finestra di dialogo proprietà:

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

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

Suddivisione E and-split

Il Divisione AND crea una suddivisione 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 Vai al passaggio 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 Vai al passaggio consente di implementare strutture di routing avanzate nei modelli di flusso di lavoro. Ad esempio, per implementare un ciclo, il Vai al passaggio può essere definito per eseguire un passaggio precedente nel flusso di lavoro, con l’espressione di indirizzamento che valuta una condizione di loop.

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, memorizza un integer nella mappa dati dell’istanza del flusso di lavoro. Per incrementare il conteggio e confrontarlo con i criteri di uscita, utilizza lo script del Vai al passaggio.

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 un count variabile del tipo di dati Long. Utilizzare Espressione come modalità di mappatura in Imposta variabile passaggio per impostare il valore del count variabile a count + 1 a ogni esecuzione del Imposta variabile passaggio.

In Vai al passaggio, utilizza Imposta variabile come Passaggio di destinazione e count < 5 come espressione di indirizzamento.

Il Imposta variabile viene eseguito ripetutamente, incrementando il valore di count variabile di 1 a ogni esecuzione fino a quando il valore raggiunge 5.

Suddivisione O or-split

Il Suddivisione O crea una suddivisione 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

A Passaggio partecipante consente di assegnare la proprietà di una particolare 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, il 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 del name proprietà del nodo del 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 Passaggio partecipante dinamico il componente è simile a Passaggio partecipante con la differenza che il partecipante viene selezionato automaticamente in fase di runtime.

Per configurare il passaggio, seleziona una 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 diverse istanze del 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 ParticipantStepChooser di rete. La classe restituisce il nome del partecipante che ha avviato il workflow. Il codice utilizza la stessa logica dello script di esempio (initiator-participant-chooser.ecma) utilizza.

Il @Property annotation imposta il valore di SERVICE_PROPERTY_LABEL campo a 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;
 }
}

In Passaggio partecipante dinamico proprietà, la finestra di dialogo Selettore partecipanti l'elenco 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, la proprietà admin l'utente 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 visualizza 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

Creare un modulo da utilizzare con un 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 seguente valore di un Nome elemento la proprietà memorizza i dati del campo come valore della proprietà redirectTarget proprietà del jcr:content nodo:

./jcr:content/redirectTarget

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

./jcr:content/par/text_3/text

Il primo esempio può essere utilizzato per qualsiasi pagina che cq:Page rendering del componente. Il secondo esempio può essere utilizzato solo quando la pagina di payload include Testo componente 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 Selettore casuale partecipanti il passaggio è un selettore partecipanti che assegna l'elemento di lavoro generato a un utente selezionato in modo casuale 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 Selettore partecipante iniziatore flusso di lavoro il passaggio è un selettore partecipanti che assegna l'elemento di lavoro generato all'utente che ha avviato il flusso di lavoro. Non sono disponibili proprietà da configurare diverse da Comune proprietà.

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

A 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: