Referencia de pasos de flujo de trabajo workflow-step-reference

Los modelos de flujo de trabajo constan de una serie de pasos de varios tipos. Según el tipo, estos pasos se pueden configurar y ampliar con parámetros y secuencias de comandos para proporcionar la funcionalidad y el control necesarios.

Propiedades del paso step-properties

Cada componente de paso tiene un Propiedades del paso que permite definir y editar las propiedades necesarias.

Propiedades del paso: pestaña Común step-properties-common-tab

Una combinación de las siguientes propiedades están disponibles para la mayoría de los componentes de paso de flujo de trabajo, en la Común pestaña del cuadro de diálogo propiedades:

Propiedades del paso: pestaña Usuario/grupo step-properties-user-group-tab

Las siguientes propiedades están disponibles para muchos componentes de paso de flujo de trabajo, en la Usuario/grupo pestaña del cuadro de diálogo propiedades:

División Y and-split

El División Y crea una división en el flujo de trabajo, tras la cual ambas ramas están activas. Los pasos del flujo de trabajo se agregan a cada rama según sea necesario. Este paso permite introducir varias rutas de procesamiento en el flujo de trabajo. Por ejemplo, puede permitir que ciertos pasos de revisión se produzcan en paralelo, lo que ahorra tiempo.

División AND: configuración and-split-configuration

Para configurar la división:

Etapa del contenedor container-step

Un paso de contenedor inicia otro modelo de flujo de trabajo que se ejecuta como flujo de trabajo secundario.

Este contenedor puede permitirle reutilizar los modelos de flujo de trabajo para implementar secuencias comunes de pasos. Por ejemplo, un modelo del flujo de trabajo de traducción se puede utilizar en varios flujos de trabajo de edición.

Paso del contenedor: configuración container-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Ir a la etapa goto-step

El Paso Ir a permite especificar el siguiente paso que se ejecutará en el modelo de flujo de trabajo. Puede especificar una definición de regla, un script externo o un script ECMA como expresión de enrutamiento para evaluar el siguiente paso del modelo de flujo de trabajo.

El Paso Ir a permite implementar estructuras de enrutamiento avanzadas en los modelos de flujo de trabajo. Por ejemplo, para implementar un bucle, la variable Paso Ir a se puede definir para ejecutar un paso anterior en el flujo de trabajo, con la expresión de enrutamiento evaluando una condición de bucle.

Paso Ir a: Configuración goto-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Simulación de un bucle for simulating-a-for-loop

La simulación de un "bucle for" requiere que mantenga un recuento del número de iteraciones de bucle que se han producido:

Por ejemplo, para implementar un flujo de trabajo que realice una acción en varios nodos JCR, puede utilizar un contador de bucle como índice para los nodos. Para mantener el recuento, almacene un integer en la asignación de datos de la instancia de flujo de trabajo. Para incrementar el recuento y comparar el recuento con los criterios de salida, utilice la secuencia de comandos del Paso Ir a.

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

Simulación de un bucle for mediante la definición de regla simulateforloop

También puede simular un bucle for utilizando la definición de regla como expresión de enrutamiento. Crear un count variable del tipo de datos Long. Uso Expresión como modo de asignación en la Establecer variable paso para establecer el valor de count variable a count + 1 en cada ejecución de Establecer variable paso.

En el Paso Ir a, use Establecer variable como el Paso de destino y recuento < 5 como la expresión de enrutamiento.

El Establecer variable Este paso se ejecuta repetidamente, incrementando el valor de count por 1 en cada ejecución hasta que el valor alcance 5.

División O or-split

El División O crea una división en el flujo de trabajo, tras la cual solo una rama está activa. Este paso le permite introducir rutas de procesamiento condicionales en su flujo de trabajo. Los pasos del flujo de trabajo se agregan a cada rama según sea necesario.

OR Split - Configuración or-split-configuration

Para configurar la división:

Pasos y selectores de participantes participant-steps-and-choosers

Etapa de participante participant-step

A Etapa de participante permite asignar la propiedad de una acción concreta. El flujo de trabajo se ejecuta únicamente cuando el usuario ha reconocido manualmente el paso. Este flujo de trabajo se utiliza cuando desea que alguien actúe en él. Por ejemplo, un paso de revisión.

Aunque no está directamente relacionado, la autorización de usuario debe tenerse en cuenta al asignar una acción; el usuario debe tener acceso a la página que es la carga útil del flujo de trabajo.

Etapa de participante: configuración participant-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Etapa de participante de cuadro de diálogo dialog-participant-step

Utilice un Etapa de participante de diálogo para recopilar información del usuario que tiene asignado el elemento de trabajo. Este paso es útil para recopilar pequeñas cantidades de datos que se utilizan más adelante en el flujo de trabajo.

Al completar el paso, la variable Completar elemento de trabajo El cuadro de diálogo contiene los campos que define en el cuadro de diálogo. Los datos recopilados en los campos se almacenan en los nodos de la carga útil del flujo de trabajo. Los pasos posteriores del flujo de trabajo pueden leer el valor desde el repositorio.

Para configurar el paso, especifique el grupo o usuario al que asignar el elemento de trabajo y la ruta al cuadro de diálogo.

Paso de participante del diálogo: configuración dialog-participant-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Paso de participante del diálogo: Creación de un cuadro de diálogo dialog-participant-step-creating-a-dialog

Para crear un cuadro de diálogo, debe crearlo:

Paso de participante del cuadro de diálogo: Almacenamiento de datos en la carga útil dialog-participant-step-storing-data-in-the-payload

Puede almacenar datos de widget en la carga útil de flujo de trabajo o en los metadatos del elemento de trabajo. El formato del name La propiedad del nodo del widget determina dónde se almacenan los datos.

Paso de participante del cuadro de diálogo: definición del cuadro de diálogo dialog-participant-step-dialog-definition

Etapa de participante dinámica dynamic-participant-step

El Etapa de participante dinámica el componente es similar a Etapa de participante con la diferencia de que el participante se selecciona automáticamente en tiempo de ejecución.

Para configurar el paso, seleccione un Selector de participantes que identifica al participante al que asignar el elemento de trabajo, junto con un cuadro de diálogo.

Etapa de participante dinámica: configuración dynamic-participant-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Etapa de participante dinámica: desarrollo del selector de participantes dynamic-participant-step-developing-the-participant-chooser

Puede crear el selector de participantes. Por lo tanto, puede utilizar cualquier lógica o criterio de selección. Por ejemplo, el selector de participantes puede seleccionar el usuario (dentro de un grupo) que tenga menos elementos de trabajo. Puede crear cualquier número de selectores de participantes para utilizarlos con diferentes instancias del Etapa de participante dinámica en los modelos de flujo de trabajo.

Cree un servicio OSGi o un ECMAScript que seleccione un usuario al que asignar el elemento de trabajo.

Etapa de participante dinámica: ejemplo de servicio de selector de participantes dynamic-participant-step-example-participant-chooser-service

La siguiente clase Java™ implementa el ParticipantStepChooser interfaz. La clase devuelve el nombre del participante que inició el flujo de trabajo. El código utiliza la misma lógica que el script de ejemplo (initiator-participant-chooser.ecma) utiliza.

El @Property La anotación define el valor de SERVICE_PROPERTY_LABEL field 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;
 }
}

En el Etapa de participante dinámica diálogo de propiedades, el Selector de participantes La lista incluye el elemento Workflow Initiator Participant Chooser (script), que representa este servicio.

Cuando se inicia el modelo de flujo de trabajo, el registro indica el ID del usuario que inició el flujo de trabajo y a quién se asigna el elemento de trabajo. En este ejemplo, la variable admin El usuario inició el flujo de trabajo.

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

Etapa de participante de formulario form-participant-step

El Etapa de participante de formulario presenta un formulario cuando se abre el elemento de trabajo. Cuando el usuario rellena y envía el formulario, los datos de campo se almacenan en los nodos de la carga útil del flujo de trabajo.

Para configurar el paso, especifique el grupo o usuario al que asignar el elemento de trabajo y la ruta al formulario.

Paso de participante de formulario: configuración form-participant-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Paso de participante del formulario: creación del formulario form-participant-step-creating-the-form

Crear un formulario para utilizarlo con una Etapa de participante de formulario como de costumbre. Sin embargo, los formularios de un paso de participante de formulario deben tener las siguientes configuraciones:

Los requisitos del flujo de trabajo determinan dónde se deben almacenar los datos de campo. Por ejemplo, los datos de campo se pueden utilizar para configurar las propiedades del contenido de la página. El siguiente valor de un Nombre de elemento La propiedad almacena datos de campo como el valor de redirectTarget propiedad del jcr:content nodo:

./jcr:content/redirectTarget

En el ejemplo siguiente, los datos de campo se utilizan como contenido de un Texto en la página de carga útil:

./jcr:content/par/text_3/text

El primer ejemplo se puede utilizar para cualquier página que tenga el valor cq:Page procesamientos de componentes. El segundo ejemplo solo se puede utilizar cuando la página de carga útil incluye un Texto componente que tiene un ID de text_3.

El formulario se puede encontrar en cualquier lugar del repositorio, pero los usuarios del flujo de trabajo deben tener autorización para leer el formulario.

Selector aleatorio de participantes random-participant-chooser

El Selector aleatorio de participantes Este paso es un selector participante que asigna el elemento de trabajo generado a un usuario que se selecciona aleatoriamente de una lista.

Selector aleatorio de participantes - Configuración random-participant-chooser-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Selector de participantes del lanzador de flujo de trabajo workflow-initiator-participant-chooser

El Selector de participantes del iniciador de flujo de trabajo step es un selector de participantes que asigna el elemento de trabajo generado al usuario que inició el flujo de trabajo. No hay propiedades que configurar que no sean Común propiedades.

Selector de participantes del iniciador de flujo de trabajo - Configuración workflow-initiator-participant-chooser-configuration

Para configurar el paso, edite utilizando las siguientes pestañas:

Etapa del proceso process-step

A Etapa del proceso ejecuta un ECMAScript o llama a un servicio OSGi para realizar un procesamiento automático.

Etapa del proceso: configuración process-step-configuration

Para configurar el paso, edite y utilice las siguientes pestañas:

Establecer variable set-variable

El paso Establecer variable permite establecer el valor de una variable y definir el orden en que se configuran los valores. La variable se configura en el orden en que se enumeran las asignaciones de variables en el paso Establecer variable.

Establecer variable - Configuración setvariable

Para configurar el paso, edite y utilice las siguientes pestañas: