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 del paso tiene un cuadro de diálogo Propiedades del paso que le permite definir y editar las propiedades requeridas.

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

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

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

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

División Y and-split

AND Split 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 le 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 Goto le permite implementar estructuras de enrutamiento avanzadas en sus modelos de flujo de trabajo. Por ejemplo, para implementar un bucle, el Paso Goto 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 valor 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, use el script del Paso Goto.

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 una variable count de tipo de datos Long. Use Expression como modo de asignación en el paso Establecer variable para establecer el valor de la variable count en count + 1 en cada ejecución del paso Establecer variable.

En el Paso Goto, use Establecer variable como Paso de destino y count < 5 como expresión de enrutamiento.

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

División O or-split

OR Split crea una división en el flujo de trabajo, después de 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

Un Paso de participante le permite asignar la propiedad de una acción en particular. 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

Use un Paso de participante del cuadro 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.

Una vez completado el paso, el cuadro de diálogo Completar elemento de trabajo contiene los campos definidos 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 de la propiedad name 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 componente Paso de participante dinámico es similar a Paso 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 identifique 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 componente Paso de participante dinámico en sus 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 la interfaz ParticipantStepChooser. 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).

La anotación @Property establece el valor del campo SERVICE_PROPERTY_LABEL en 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 cuadro de diálogo de propiedades de Paso de participante dinámico, la lista de Selector de participantes 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, el usuario admin 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

Paso 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

Cree un formulario para utilizarlo con un Paso de participante del 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 una propiedad Element Name almacena datos de campo como el valor de la propiedad redirectTarget del nodo jcr:content:

./jcr:content/redirectTarget

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

./jcr:content/par/text_3/text

El primer ejemplo se puede utilizar para cualquier página que procese el componente cq:Page. El segundo ejemplo solo se puede usar cuando la página de carga útil incluye un componente Text con un identificador 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 paso Selector aleatorio de participantes es un selector de participantes que asigna el elemento de trabajo generado a un usuario que se ha seleccionado 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 paso Selector de participantes de iniciador de flujo de trabajo 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 las propiedades Common.

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

Un paso de proceso ejecuta un ECMAScript o llama a un servicio OSGi para realizar el 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: