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

I modelli di flusso di lavoro sono composti 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 la funzionalità e il controllo necessari.

Proprietà passaggio step-properties

Ogni componente passo ha un Proprietà passaggio che consente di definire e modificare le proprietà richieste.

Proprietà del passaggio - Scheda comune step-properties-common-tab

Per la maggior parte dei componenti dei passaggi del flusso di lavoro è disponibile una combinazione delle seguenti proprietà, nella sezione Comune scheda della finestra di dialogo delle proprietà:

Proprietà passaggio - Scheda Utente/Gruppo step-properties-user-group-tab

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

Suddivisione E and-split

La Divisione AND crea una suddivisione nel flusso di lavoro, dopodiché entrambi i rami saranno attivi. Puoi aggiungere i passaggi del flusso di lavoro a ogni ramo in base alle tue 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.

AND Split - Configurazione and-split-configuration

Passaggio contenitore container-step

A Contenitore inizia un altro modello di flusso di lavoro che viene eseguito come flusso di lavoro secondario.

Questo Contenitore consente 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

La Passaggio Vai a consente di specificare il passaggio successivo nel modello di flusso di lavoro da eseguire, in base al risultato di uno script ECMAScript:

La Passaggio Vai a consente di implementare strutture di routing avanzate nei modelli di flusso di lavoro. Ad esempio, per implementare un ciclo, la Passaggio Vai a può essere definito per eseguire un passaggio precedente nel flusso di lavoro, con lo script che valuta una condizione di ciclo.

Passaggio di Go - Configurazione goto-step-configuration

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

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

Per simulare un ciclo for è necessario 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 integer nella mappa dati dell’istanza del flusso di lavoro. Utilizza lo script del Passaggio Vai a per incrementare il conteggio e confrontare il conteggio con i criteri di uscita.

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;
   }
}

Suddivisione O or-split

La Divisione OR crea una suddivisione nel flusso di lavoro, dopodiché sarà attivo un solo ramo. Questo passaggio ti consente di introdurre i percorsi di elaborazione condizionale nel flusso di lavoro. Puoi aggiungere i passaggi del flusso di lavoro a ogni ramo in base alle tue esigenze.

Divisione OR - Configurazione or-split-configuration

Passaggi e scelte dei partecipanti participant-steps-and-choosers

Passaggio partecipante participant-step

A Passaggio partecipante consente di assegnare la proprietà per una particolare azione. Il flusso di lavoro procederà solo quando l’utente ha riconosciuto manualmente il passaggio. Viene utilizzato quando desideri che un utente esegua un’azione sul flusso di lavoro; ad esempio, un passaggio di revisione.

Sebbene non sia direttamente correlata, l’autorizzazione utente deve essere presa in considerazione al momento dell’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 utilizzate più avanti nel flusso di lavoro.

Al completamento del passaggio, la Elemento di lavoro completo 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 dal repository.

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:

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

Puoi memorizzare i dati dei widget nel payload del flusso di lavoro o nei metadati dell’elemento di lavoro. Il formato del name La proprietà del nodo del widget determina la posizione in cui vengono memorizzati i dati.

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

Passaggio partecipante dinamico dynamic-participant-step

La Passaggio partecipante dinamico è simile a Passaggio partecipante con la differenza che il partecipante viene selezionato automaticamente in fase di esecuzione.

Per configurare il passaggio , seleziona una Selettore partecipante 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 del partecipante dynamic-participant-step-developing-the-participant-chooser

Si crea il selettore dei partecipanti. Pertanto, puoi utilizzare qualsiasi logica o criterio di selezione. Ad esempio, il selettore dei partecipanti può selezionare l'utente (all'interno di un gruppo) con il minor numero di elementi di lavoro. È possibile creare un numero qualsiasi di partecipanti che scelgono di utilizzare con diverse istanze del Passaggio partecipante dinamico nei modelli di flusso di lavoro.

Creare un servizio OSGi o un codice ECMAScript che seleziona un utente a cui assegnare l'elemento di lavoro.

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

La seguente classe Java implementa il ParticipantStepChooser interfaccia. La classe restituisce il nome del partecipante che ha avviato il flusso di lavoro. Il codice utilizza la stessa logica dello script di esempio ( initator-participant-chooser.ecma) utilizza .

La @Property l’annotazione imposta il valore della 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 finestra di dialogo delle proprietà Selettore partecipante include l'elemento Workflow Initiator Participant Chooser (script), che rappresenta questo servizio.

"All’avvio del modello di flusso di lavoro, il registro indica l’ID dell’utente che ha avviato il flusso di lavoro e a cui è stato assegnato l’elemento di lavoro. In questo esempio, la 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

La Passaggio partecipante modulo presenta un modulo all’apertura dell’elemento di lavoro. Quando l’utente compila e invia il modulo, i dati del campo 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 normale. Tuttavia, i moduli per un Passaggio partecipante a un modulo devono avere le seguenti configurazioni:

I requisiti del flusso di lavoro determinano dove 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 memorizza i dati del campo come valore del redirectTarget proprietà jcr:content nodo:

./jcr:content/redirectTarget

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

./jcr:content/par/text_3/text

"Il primo esempio può essere utilizzato per qualsiasi pagina che cq:Page rendering dei componenti. Il secondo esempio può essere utilizzato solo quando la pagina del payload include un Testo componente con ID di text_3.

Il modulo può trovarsi in qualsiasi punto dell’archivio, tuttavia gli utenti del flusso di lavoro devono essere autorizzati a leggere il modulo.

Selettore casuale partecipanti random-participant-chooser

La Selettore casuale partecipante step è un selettore dei 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

La Selettore partecipante iniziatore flusso di lavoro step è un selettore dei 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 al processo esegue un ECMAScript o chiama un servizio OSGi per eseguire l'elaborazione automatica.

Passaggio del processo: configurazione process-step-configuration

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