Los modelos de flujo de trabajo constan de una serie de pasos de varios tipos. Según el tipo, estos pasos pueden configurarse y ampliarse con parámetros y secuencias de comandos para proporcionar la funcionalidad y el control que necesite.
Esta sección trata los pasos estándar del flujo de trabajo.
Para ver los pasos específicos del módulo, consulte también:
Cada componente de paso tiene un cuadro de diálogo Propiedades del paso que permite definir y editar las propiedades requeridas.
Hay una combinación de las siguientes propiedades disponibles para la mayoría de los componentes de paso del flujo de trabajo, en la ficha Common del cuadro de diálogo de propiedades:
Título
Título del paso.
Descripción
Descripción del paso.
Fase del flujo de trabajo
Un selector desplegable para aplicar un escenario al paso.
Tiempo de espera
Período después del cual se "agotó el tiempo de espera" del paso.
Puede seleccionar entre: Desactivado, Inmediato, 1h, 6h, 12h, 24h.
Controlador de tiempo de espera
El controlador que controlará el flujo de trabajo cuando se agote el tiempo de espera; por ejemplo:
Auto Advancer
Avance de controlador
Seleccione esta opción para avanzar automáticamente el flujo de trabajo al paso siguiente después de la ejecución. Si no se selecciona, la secuencia de comandos de implementación debe gestionar el avance del flujo de trabajo.
Las siguientes propiedades están disponibles para muchos componentes de paso de flujo de trabajo, en la ficha Usuario/Grupo del cuadro de diálogo de propiedades:
Notificar al usuario a través del correo electrónico
Usuario/grupo
La división AND crea una división en el flujo de trabajo, tras la cual ambas ramas estarán activas. Puede agregar pasos de flujo de trabajo a cada rama según sea necesario. Este paso le 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.
Edite las propiedades AND Split:
Añada los pasos del flujo de trabajo a las ramas según sea necesario.
Un paso Contenedor inicio otro modelo de flujo de trabajo que se ejecuta como flujo de trabajo secundario.
Este Contenedor le permite reutilizar modelos de flujo de trabajo para implementar secuencias comunes de pasos. Por ejemplo, un modelo de flujo de trabajo de traducción podría utilizarse en varios flujos de trabajo de edición.
Para configurar el paso, edite y utilice las fichas siguientes:
Contenedor
El Paso Goto permite especificar el siguiente paso en el modelo de flujo de trabajo que se va a ejecutar, según el resultado de un ECMAScript:
true
:: Se completa Ir a pasos y el motor de flujos de trabajo ejecuta el paso especificado.
false
:: Se completan las fases Goto y la lógica de enrutamiento normal determina el siguiente paso que se va a ejecutar.
El Paso Goto le permite implementar estructuras de enrutamiento avanzadas en los modelos de flujo de trabajo. Por ejemplo, para implementar un bucle, se puede definir el paso Goto para ejecutar un paso anterior en el flujo de trabajo, con la secuencia de comandos evaluando una condición de bucle.
Para configurar el paso, edite y utilice las fichas siguientes:
Proceso
Especifique la Ruta de secuencia de comandos o Secuencia de comandos. Ambas opciones no se pueden usar al mismo tiempo. Si especifica valores para ambas propiedades, el paso utiliza la Ruta de secuencia de comandos.
Para simular un bucle for es necesario mantener un recuento del número de iteraciones de bucle que se han producido:
Por ejemplo, para implementar un flujo de trabajo que realiza 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 el mapa de datos de la instancia de flujo de trabajo. Utilice la secuencia de comandos de Goto Step para incrementar el recuento y comparar el recuento con los criterios de salida.
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;
}
}
La división O crea una división en el flujo de trabajo, tras la cual sólo una rama estará activa. Este paso le permite introducir rutas de procesamiento condicionales en el flujo de trabajo. Puede agregar pasos de flujo de trabajo a cada rama según sea necesario.
Para obtener información adicional sobre la creación de una división O, consulte: https://helpx.adobe.com/es/experience-manager/using/aem64_workflow_servlet.html
Edite las propiedades O Split:
Común
Rama: x>
Hay una ficha separada para cada rama:
Especifique la Ruta de secuencia de comandos o Secuencia de comandos. Ambas opciones no se pueden usar al mismo tiempo. Si especifica valores para ambas propiedades, el paso utiliza la Ruta de secuencia de comandos.
Añada los pasos del flujo de trabajo a las ramas según sea necesario.
Un paso de participante le permite asignar la propiedad para una acción en particular. El flujo de trabajo sólo se realizará cuando el usuario haya reconocido manualmente el paso. Se utiliza cuando se desea que alguien realice una acción en el flujo de trabajo; por ejemplo, un paso de revisión.
Aunque no está directamente relacionada, la autorización del 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.
Para configurar el paso, edite y utilice las fichas siguientes:
El iniciador del flujo de trabajo siempre recibe una notificación cuando:
Es necesario configurar algunas propiedades para habilitar las notificaciones por correo electrónico. También puede personalizar la plantilla de correo electrónico o agregar una plantilla de correo electrónico para un nuevo idioma. Consulte Configuración de la notificación por correo electrónico para configurar las notificaciones por correo electrónico en AEM.
Utilice un paso del participante en el cuadro de diálogo para recopilar información del usuario al que se asignó el elemento de trabajo. Este paso resulta útil para recopilar pequeñas cantidades de datos que se utilizan más adelante en el flujo de trabajo.
Al completar el paso, el cuadro de diálogo Completar elemento de trabajo contiene los campos que se definen en el cuadro de diálogo. Los datos recopilados en los campos se almacenan en nodos de la carga útil del flujo de trabajo. Los siguientes pasos del flujo de trabajo pueden leer el valor del repositorio.
Para configurar el paso, especifique el grupo o usuario al que desea asignar el elemento de trabajo y la ruta al cuadro de diálogo.
Para configurar el paso, edite y utilice las fichas siguientes:
Cuadro de diálogo
Para crear un cuadro de diálogo:
Puede almacenar datos de utilidades en la carga útil del 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.
Almacenar datos con la carga útil
Para almacenar datos de utilidades como propiedad de la carga útil del flujo de trabajo, utilice el siguiente formato para el valor de la propiedad name del nodo de la utilidad:
./jcr:content/nodename
Los datos se almacenan en la propiedad nodename
del nodo de carga útil. Si el nodo no contiene esa propiedad, se crea la propiedad.
Cuando se almacena con la carga útil, los usos posteriores del cuadro de diálogo con la misma carga útil sobrescriben el valor de la propiedad.
Almacenar datos con el elemento de trabajo
Para almacenar datos de utilidades como propiedad de los metadatos del elemento de trabajo, utilice el siguiente formato para el valor de la propiedad name:
nodename
Los datos se almacenan en la propiedad nodename
del elemento de trabajo metadata
. Los datos se conservan si el cuadro de diálogo se utiliza posteriormente con la misma carga útil.
Estructura de cuadro de diálogo
Los cuadros de diálogo Pasos de los participantes son similares a los cuadros de diálogo que se crean para la creación de componentes. Se almacenan en:
/apps/myapp/workflow/dialogs
Los cuadros de diálogo para la IU estándar con capacidad táctil tienen la siguiente estructura de nodos:
newComponent (cq:Component)
|- cq:dialog (nt:unstructured)
|- content
|- layout
|- items
|- column
|- items
|- component0
|- component1
|- ...
Para obtener más información, consulte Creación y configuración de un cuadro de diálogo.
Propiedad de ruta de cuadro de diálogo
El paso del participante en el cuadro de diálogo tiene la propiedad Ruta de diálogo (junto con las propiedades de un paso del participante). El valor de la propiedad Dialog Path es la ruta al nodo dialog
del cuadro de diálogo.
Por ejemplo, el cuadro de diálogo está contenido en un componente denominado EmailWatch
que se almacena en el nodo:
/apps/myapp/workflows/dialogs
Para la IU táctil, se utiliza el siguiente valor para la propiedad Ruta de diálogo:
/apps/myapp/workflow/dialogs/EmailWatch/cq:dialog
Ejemplo de definición de cuadro de diálogo
El siguiente fragmento de código XML representa un cuadro de diálogo que almacena un valor String
en el nodo watchEmail
del contenido de la carga útil. El nodo title representa el componente TextField:
jcr:primaryType="nt:unstructured"
jcr:title="Watcher Email Address Dialog"
sling:resourceType="cq/gui/components/authoring/dialog">
<content jcr:primaryType="nt:unstructured"
sling:resourceType="granite/ui/components/foundation/container">
<layout jcr:primaryType="nt:unstructured"
margin="false"
sling:resourceType="granite/ui/components/foundation/layouts/fixedcolumns"
/>
<items jcr:primaryType="nt:unstructured">
<column jcr:primaryType="nt:unstructured"
sling:resourceType="granite/ui/components/foundation/container">
<items jcr:primaryType="nt:unstructured">
<title jcr:primaryType="nt:unstructured"
fieldLabel="Notification Email Address"
name="./jcr:content/watchEmails"
sling:resourceType="granite/ui/components/foundation/form/textfield"
/>
</items>
</column>
</items>
</content>
</cq:dialog>
En este ejemplo, en el caso de la IU táctil, se mostrará un cuadro de diálogo como:
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.
Para configurar el paso, edite y utilice las fichas siguientes:
Selector de participantes
Cuadro de diálogo
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 la menor cantidad de elementos de trabajo. Puede crear cualquier número de usuarios que desee utilizar con distintas instancias del componente Paso de participante dinámico 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.
ECMAscript
Las secuencias de comandos deben incluir una función denominada getParticipant que devuelve un ID de usuario como un valor String
. Almacene las secuencias de comandos personalizadas en, por ejemplo, la carpeta /apps/myapp/workflow/scripts
o una subcarpeta.
Se incluye una secuencia de comandos de ejemplo en una instancia de AEM estándar:
/libs/workflow/scripts/initiator-participant-chooser.ecma
Usted no debe cambiar nada en la ruta /libs
.
Esto se debe a que el contenido de /libs
se sobrescribe la próxima vez que actualice la instancia (y puede sobrescribirse al aplicar una revisión o un paquete de funciones).
Esta secuencia de comandos selecciona el iniciador del flujo de trabajo como participante:
function getParticipant() {
return workItem.getWorkflow().getInitiator();
}
El componente Selector de participantes del iniciador de flujo de trabajo amplía el paso de participante dinámico y utiliza esta secuencia de comandos como implementación de paso.
Servicio OSGi
Los servicios deben implementar la interfaz com.day.cq.workflow.exec.ParticipantStepChooser. La interfaz define los siguientes miembros:
SERVICE_PROPERTY_LABEL
field: Utilice este campo para especificar el nombre del selector de participantes. El nombre aparece en una lista de los usuarios participantes disponibles en las propiedades Paso de participante dinámico.getParticipant
método: Devuelve la identificación principal resuelta dinámicamente como un String
valor.El método getParticipant
devuelve la identificación principal resuelta dinámicamente. Puede ser una identificación de grupo o de usuario.
Sin embargo, una identificación de grupo solo se puede utilizar para un paso del participante, cuando se devuelve una lista de participantes. Para un paso de participante dinámico se devuelve una lista vacía y no se puede usar para delegación.
Para que la implementación esté disponible para los componentes Paso de participante dinámico, agregue la clase Java a un paquete OSGi que exporte el servicio e implemente el paquete en el servidor de AEM.
Las opciones de participante aleatorio son un servicio de muestra que selecciona un usuario aleatorio ( com.day.cq.workflow.impl.process.RandomParticipantChooser
). El ejemplo de componente de paso Selector de participantes aleatorio amplía el paso de participante dinámico y utiliza este servicio como implementación de paso.
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 la secuencia de comandos de ejemplo ( initator-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 Paso de participante dinámico, la lista Selector de participante 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 le 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
El paso del participante en el formulario presenta un formulario cuando se abre el elemento de trabajo. Cuando el usuario rellena y envía el formulario, los datos del campo se almacenan en los nodos de la carga útil del flujo de trabajo.
Para configurar el paso, debe especificar el grupo o usuario al que asignar el elemento de trabajo y la ruta al formulario.
Esta sección trata la sección Forms de Componentes básicos para la creación de páginas.
Para configurar el paso, edite y utilice las fichas siguientes:
Formulario
Cree un formulario para utilizarlo con un paso del participante en el formulario como de costumbre. Sin embargo, los formularios para un paso de participante en el formulario deben tener las siguientes configuraciones:
El Inicio del componente Formulario debe tener la propiedad Tipo de acción establecida en Edit Workflow Controlled Resource(s)
.
El Inicio del componente Formulario debe tener un valor para la propiedad Form Identifier
.
Los componentes del formulario deben tener la propiedad Nombre del elemento establecida en la ruta del nodo donde se almacenan los datos del campo. La ruta debe ubicar un nodo en el contenido de la carga útil del flujo de trabajo. El valor utiliza el siguiente formato:
./jcr:content/path_to_node
El formulario debe incluir un componente Botón(s) de envío de flujo de trabajo. No se configura ninguna propiedad del componente.
Los requisitos del flujo de trabajo determinan dónde debe almacenar los datos de campo. Por ejemplo, los datos de campo pueden utilizarse para configurar las propiedades del contenido de la página. El siguiente valor de una propiedad Nombre del elemento almacena los 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 el componente cq:Page
procese. El segundo ejemplo solo se puede usar cuando la página de carga útil incluye un componente Texto con un ID de text_3
.
El formulario puede ubicarse en cualquier lugar del repositorio, pero los usuarios del flujo de trabajo deben estar autorizados para leerlo.
El paso Selector de participantes aleatorio es un selector de participantes que asigna el elemento de trabajo generado a un usuario seleccionado aleatoriamente desde una lista.
Para configurar el paso, edite y utilice las fichas siguientes:
Argumentos
El paso Selector de participantes del 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.
Para configurar el paso, edite con las fichas siguientes:
Un paso de proceso ejecuta un ECMAScript o llama a un servicio OSGi para realizar el procesamiento automático.
Para configurar el paso, edite y utilice las fichas siguientes:
Proceso
Proceso: Implementación del proceso que se va a ejecutar. Utilice el menú desplegable para seleccionar el servicio ECMAScript o OSGi. Para obtener información sobre:
Avance del controlador: Seleccione esta opción para avanzar automáticamente el flujo de trabajo al paso siguiente después de la ejecución. Si no se selecciona, la secuencia de comandos de implementación debe gestionar el avance del flujo de trabajo.
Argumentos: Argumentos que se van a pasar al proceso.