Creación de modelos de flujo de trabajo creating-workflow-models
Puede crear un modelo de flujo de trabajo para definir la serie de pasos que se ejecutan cuando un usuario inicia el flujo de trabajo. También puede definir propiedades del modelo, como si el flujo de trabajo es transitorio o utiliza varios recursos.
Cuando un usuario inicia un flujo de trabajo, se inicia una instancia; este es el modelo de tiempo de ejecución correspondiente, creado al Sincronización los cambios.
Creación de un nuevo flujo de trabajo creating-a-new-workflow
La primera vez que se crea un nuevo modelo de flujo de trabajo contiene:
-
Los pasos, Inicio de flujo y Fin del flujo.
Representan el principio y el final del flujo de trabajo. Estos pasos son obligatorios y no se pueden editar ni eliminar.
-
Un ejemplo Participante step named Paso 1.
Este paso está configurado para asignar un elemento de trabajo al iniciador del flujo de trabajo. Edite o elimine este paso y añada los pasos necesarios.
Para crear un nuevo flujo de trabajo con el editor:
-
Abra el Modelos de flujo de trabajo consola; mediante Herramientas, Flujo de trabajo, Modelos o, por ejemplo:
-
Seleccione Crear y, a continuación, Crear modelo.
-
La variable Agregar modelo de flujo de trabajo aparece en el cuadro de diálogo. Introduzca la variable Título y Nombre (opcional) antes de seleccionar Listo.
-
El nuevo modelo se enumera en la Modelos de flujo de trabajo consola.
-
Seleccione el nuevo flujo de trabajo y, a continuación, utilice Editar para abrirlo y configurarlo:
/var/workflow/models/var/workflow/models/prototypes.Edición de un flujo de trabajo editing-a-workflow
Puede editar cualquier modelo de flujo de trabajo existente para:
-
configurar las propiedades del flujo de trabajo, incluyendo fases, si el flujo de trabajo es transitorio y/o utiliza varios recursos
Edición de un Predeterminado o Heredado flujo de trabajo (predeterminado) tiene un paso adicional para garantizar que copia segura se toma antes de realizar los cambios.
Cuando se hayan completado las actualizaciones del flujo de trabajo, debe utilizar Sincronización a Generar un modelo de tiempo de ejecución. Consulte Sincronizar el flujo de trabajo para obtener más información.
Sincronizar el flujo de trabajo: generar un modelo de tiempo de ejecución sync-your-workflow-generate-a-runtime-model
Sincronización (derecha en la barra de herramientas del editor) genera un modelo runtime. El modelo de tiempo de ejecución es el modelo que se utiliza realmente cuando un usuario inicia un flujo de trabajo. Si no Sincronización Los cambios no estarán disponibles durante la ejecución.
Cuando usted (o cualquier otro usuario) realicen cambios en el flujo de trabajo, debe utilizar Sincronización para generar un modelo de tiempo de ejecución, incluso cuando los cuadros de diálogo individuales (por ejemplo, para los pasos) tienen sus propias opciones de guardado.
Cuando los cambios se sincronizan con el modelo de tiempo de ejecución (guardado), Sincronizado se muestra en su lugar.
Algunos pasos tienen campos obligatorios o una validación integrada. Cuando no se cumplan estas condiciones, se mostrará un error cuando intente Sincronización el modelo. Por ejemplo, cuando no se ha definido ningún participante para un Participante paso:
Edición de un flujo de trabajo predeterminado o heredado por primera vez editing-a-default-or-legacy-workflow-for-the-first-time
Cuando abra un Modelo predeterminado y/o heredado para edición:
-
La variable Pasos El explorador no está disponible (lado izquierdo).
-
Hay un Editar acción disponible en la barra de herramientas (lado derecho).
-
Inicialmente, el modelo y sus propiedades se presentan en modo de solo lectura como:
- Los flujos de trabajo predeterminados se encuentran en
/libs - Los flujos de trabajo heredados se encuentran en
/etc
- Los flujos de trabajo predeterminados se encuentran en
Selección Editar será:
- llevar una copia del flujo de trabajo a
/conf - haga que la variable Pasos explorador disponible
- permite realizar cambios
Adición de un paso a un modelo adding-a-step-to-a-model
Deberá añadir pasos al modelo para representar la actividad que se va a realizar: cada paso realiza una actividad específica. Hay una selección de componentes de paso disponibles en una instancia de AEM estándar.
Al editar un modelo, los pasos disponibles aparecen en los distintos grupos de la variable Pasos explorador. Por ejemplo:
Adición de un paso a un modelo:
-
Abra un modelo de flujo de trabajo existente para editarlo. En el Modelo de flujos de trabajo consola, seleccione el modelo requerido y, a continuación, Editar.
-
Abra el Pasos explorador; using Alternar panel lateral, en el extremo izquierdo de la barra de herramientas superior. Aquí puede hacer lo siguiente:
- Filtro para pasos específicos.
- Utilice el selector desplegable para limitar la selección a un grupo específico de pasos.
- Seleccione el icono Mostrar descripción
-
Arrastre los pasos correspondientes a la ubicación requerida en el modelo.
Por ejemplo, una Etapa de participante.
Después de añadirlo al flujo, puede configurar el paso.
-
Agregue tantos pasos u otras actualizaciones como sea necesario.
En tiempo de ejecución, los pasos se ejecutan en el orden en que aparecen en el modelo. Después de agregar componentes de paso, puede arrastrarlos a una ubicación diferente del modelo.
También puede copiar, cortar, pegar, agrupar o eliminar pasos existentes; como con el editor de páginas.
Los pasos divididos también se pueden contraer o expandir con la opción de la barra de herramientas:
-
Confirme los cambios con Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Configuración de un paso de flujo de trabajo configuring-a-workflow-step
Puede Configurar y personalizar el comportamiento de un paso de flujo de trabajo mediante el Propiedades de los pasos para abrir el Navegador.
-
Para abrir el Propiedades de los pasos para un paso:
- Pulse el paso en el modelo de flujo de trabajo y seleccione Configurar en la barra de herramientas de componentes.
- Haga doble clic en el paso .
note note NOTE Para obtener información sobre los componentes del paso principal instalados con AEM, consulte Referencia de pasos del flujo de trabajo. -
Configure las variables Propiedades de los pasos según sea necesario; las propiedades disponibles dependen del tipo de paso; también pueden haber varias pestañas disponibles. Por ejemplo, el valor predeterminado Etapa de participante, presente en un nuevo flujo de trabajo como
Step 1:
-
Confirme sus actualizaciones con el visto.
-
Confirme los cambios con Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Creación de un flujo de trabajo transitorio creating-a-transient-workflow
Puede crear un Transitorio modelo de flujo de trabajo al crear un nuevo modelo o al editar uno existente:
-
Abra el modelo de flujo de trabajo para editar.
-
Select Propiedades del modelo de flujo de trabajo en la barra de herramientas.
-
En el cuadro de diálogo, active Flujo de trabajo transitorio (o desactivar si es necesario):
-
Confirme el cambio con Guardar y cerrar; seguido de Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Hacer que los modelos de flujo de trabajo estén disponibles en la interfaz de usuario táctil make-workflow-models-available-in-touchui
Si hay un modelo de flujo de trabajo en la IU clásica, pero falta en el menú emergente de selección en la Cronología de la interfaz de usuario táctil y, a continuación, siga la configuración para que esté disponible. Los siguientes pasos ilustran el uso del modelo de flujo de trabajo llamado Solicitud de activación.
-
Confirme que el modelo no está disponible en la IU táctil. Acceder a un recurso mediante
/assets.html/content/damruta. Seleccione un recurso. Apertura Cronología en el carril izquierdo. Haga clic en Iniciar flujo de trabajo y confirme que Solicitud de activación no está presente en la lista emergente. -
Navegar por Herramientas > General > Etiquetado. Select Flujo de trabajo.
-
Select Crear > Crear etiqueta. Establezca Título como
DAMy Nombre comodam. Seleccione Enviar.
-
Navegue hasta Herramientas > Flujo de trabajo > Modelos. Select Solicitud de activación y, a continuación, seleccione Editar.
-
Select Editar y, a continuación, abra Propiedades del modelo de flujo de trabajo. Vaya a la Básico pestaña .
-
Agregar
Workflow : DAMa Etiquetas campo . Confirme la selección con la marca de verificación (visto). -
Confirme la adición de la etiqueta con Guardar y cerrar.
-
Complete el proceso con Sincronización. El flujo de trabajo ya está disponible en la IU táctil.
Configuración de un flujo de trabajo para compatibilidad con varios recursos configuring-a-workflow-for-multi-resource-support
Puede configurar un modelo de flujo de trabajo para Compatibilidad con varios recursos al crear un modelo nuevo o al editar uno existente:
-
Abra el modelo de flujo de trabajo para editar.
-
Select Propiedades del modelo de flujo de trabajo en la barra de herramientas.
-
En el cuadro de diálogo, active Compatibilidad con varios recursos (o desactivar si es necesario):
-
Confirme el cambio con Guardar y cerrar; seguido de Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Configuración de etapas de flujo de trabajo (que muestran el progreso del flujo de trabajo) configuring-workflow-stages-that-show-workflow-progress
Etapas del flujo de trabajo ayuda a visualizar el progreso de un flujo de trabajo al administrar tareas.
Las etapas que estarán disponibles se definen en los modelos de flujo de trabajo; los modelos de flujo de trabajo existentes se pueden actualizar para incluir definiciones de escenario. Puede definir cualquier número de etapas para el modelo de flujo de trabajo.
Para definir Etapas para el flujo de trabajo:
-
Abra el modelo de flujo de trabajo para editarlo.
-
Select Propiedades del modelo de flujo de trabajo en la barra de herramientas. A continuación, abra el Etapas pestaña .
-
Añada (y posicione) su Etapas. Puede definir cualquier número de etapas para el modelo de flujo de trabajo.
Por ejemplo:
-
Haga clic en Guardar y cerrar para guardar las propiedades.
-
Asigne un escenario a cada uno de los pasos del modelo de flujo de trabajo. Por ejemplo:
Se puede asignar un escenario a más de un paso. Por ejemplo:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Paso Escenario Etapa 1 Crear Etapa 2 Crear Etapa 3 Revisión Etapa 4 Aprobar Etapa 5 Aprobar Etapa 6 Completar -
Confirme los cambios con Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Exportación de un modelo de flujo de trabajo en un paquete exporting-a-workflow-model-in-a-package
-
Cree un nuevo paquete utilizando la variable Administrador de paquetes:
- Vaya al Administrador de paquetes mediante Herramientas, Implementación, Paquetes.
- Haga clic en Crear paquete.
- Especifique la variable Nombre del paquete, y cualquier otro detalle según sea necesario.
- Haga clic en Aceptar.
-
Haga clic en Editar en la barra de herramientas del nuevo paquete.
-
Abra el Filtros pestaña .
-
Select Agregar filtro y especifique la ruta del modelo de flujo de trabajo diseño:
/conf/global/settings/workflow/models/<*your-model-name*>Haga clic en Listo.
-
Select Agregar filtro y especifique la ruta de tiempo de ejecución modelo de flujo de trabajo:
/var/workflow/models/<*your-model-name*>Haga clic en Listo.
-
Añada filtros adicionales para cualquier secuencia de comandos personalizada que utilice el modelo.
-
Haga clic en Guardar para confirmar las definiciones del filtro.
-
Select Generar de la barra de herramientas de la definición del paquete.
-
Select Descargar en la barra de herramientas del paquete.
Uso de flujos de trabajo para procesar envíos de formularios using-workflows-to-process-form-submissions
Puede configurar un formulario para que lo procese el flujo de trabajo seleccionado. Cuando los usuarios envían el formulario, se crea una nueva instancia de flujo de trabajo con los datos del envío del formulario como carga útil.
Para configurar el flujo de trabajo que se utilizará con el formulario:
-
Cree una nueva página y ábrala para editarla.
-
Agregue un Formulario a la página.
-
Configure las variables Inicio del formulario que apareció en la página.
-
Uso Iniciar flujo de trabajo para seleccionar el flujo de trabajo deseado de los disponibles:
-
Confirme la nueva configuración de formulario con la marca de verificación.
Flujos de trabajo de prueba testing-workflows
Es una buena práctica a la hora de probar un flujo de trabajo utilizar una variedad de tipos de carga útil; incluyendo tipos diferentes de los para los que se ha desarrollado. Por ejemplo, si tiene intención de que el flujo de trabajo trate con Assets, pruébelo configurando una página como carga útil y asegúrese de que no arroja errores.
Por ejemplo, pruebe el nuevo flujo de trabajo de la siguiente manera:
-
Inicio del modelo de flujo de trabajo desde la consola.
-
Defina el Carga útil y confirme.
-
Realice las acciones necesarias para que se ejecute el flujo de trabajo.
-
Monitorice los archivos de registro mientras se ejecuta el flujo de trabajo.
También puede configurar AEM para mostrar DEBUG en los archivos de registro. Consulte Registro para obtener más información y cuando finalice el desarrollo, establezca la variable Nivel de registro volver a Información.
Ejemplos examples
Ejemplo: Creación de un flujo de trabajo (simple) para aceptar o rechazar una solicitud de publicación example-creating-a-simple-workflow-to-accept-or-reject-a-request-for-publication
Para ilustrar algunas de las posibilidades de creación de un flujo de trabajo, el siguiente ejemplo crea una variación de la variable Publish Example flujo de trabajo.
-
Creación de un nuevo modelo de flujo de trabajo.
El nuevo flujo de trabajo contiene:
- Inicio de flujo
Step 1- Fin de flujo
-
Eliminar
Step 1(ya que es el tipo de paso incorrecto para este ejemplo):- Haga clic en el paso y seleccione Eliminar en la barra de herramientas de componentes. Confirme la acción.
-
En el Flujo de trabajo selección del navegador de pasos, arrastre un Etapa de participante en el flujo de trabajo y colóquelo entre Inicio de flujo y Fin de flujo.
-
Para abrir el cuadro de diálogo de propiedades:
- Haga clic en el paso del participante y seleccione Configurar en la barra de herramientas de componentes.
- Haga doble clic en el paso del participante.
-
En el Frecuentes tab enter
Validate Contentpara ambas Título y Descripción. -
Abra el Usuario/Grupo pestaña:
- Activar Notificar al usuario por correo electrónico.
- Select
Administrator(admin) para la variable Usuario/Grupo campo .
note note NOTE Para enviar correos electrónicos, es necesario configurar el servicio de correo y los detalles de la cuenta de usuario. -
Confirme las actualizaciones con la marca de verificación.
Se le devolverá a la descripción general del modelo de flujo de trabajo, donde se habrá cambiado el nombre del paso del participante a
Validate Content. -
Arrastre un División O en el flujo de trabajo y colóquelo entre
Validate Contenty Fin del flujo. -
Abra el División O para la configuración.
-
Configuración de:
- Frecuentes: select 2 ramas
- Rama 1: select Ruta predeterminada.
- Rama 2: garantizar Ruta predeterminada no está seleccionado.
-
Confirme las actualizaciones a la División OR.
-
Arrastre un Etapa de participante en la rama izquierda, abra las propiedades, especifique los siguientes valores y confirme los cambios:
- Título:
Reject Publish Request - Usuario/Grupo: por ejemplo,
projects-administrators - Notificar al usuario por correo electrónico: Active esta opción para que el usuario reciba una notificación por correo electrónico.
- Título:
-
Arrastre un Paso de proceso en la rama derecha, abra las propiedades, especifique los siguientes valores y confirme los cambios:
- Título:
Publish Page as Requested - Proceso: select
Activate Page. Este proceso publica la página seleccionada en las instancias del editor.
- Título:
-
Haga clic en Sincronización (barra de herramientas del editor) para generar el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
El nuevo modelo de flujo de trabajo tendrá el siguiente aspecto:
-
Aplique este flujo de trabajo a su página, de modo que cuando el usuario se mueva a Completar el Validar contenido , pueden seleccionar si desean Publicar página como se solicitó o Rechazar solicitud de publicación.
Ejemplo: Definición de una regla para una división OR example-defining-a-rule-for-an-or-split
División OR los pasos le permiten introducir rutas de procesamiento condicionales en el flujo de trabajo.
Para definir una regla O:
-
Cree dos secuencias de comandos y guárdelas en el repositorio, por ejemplo, en:
/apps/myapp/workflow/scriptsnote note NOTE Las secuencias de comandos deben tener un function check()que devuelve un valor booleano. -
Edite el flujo de trabajo y añada la variable División OR al modelo.
-
Editar las propiedades de Rama 1 del División OR:
-
Defina esto como la variable Ruta predeterminada configurando la variable Valor a
true. -
Como Regla, establezca la ruta en la secuencia de comandos. Por ejemplo:
/apps/myapp/workflow/scripts/myscript1.ecma
note note NOTE Si es necesario, puede cambiar el orden de las ramas. -
-
Edite las propiedades del Rama 2 del División OR.
-
Como Regla, establezca la ruta en la otra secuencia de comandos. Por ejemplo:
/apps/myapp/workflow/scripts/myscript2.ecma
-
-
Defina las propiedades de los pasos individuales de cada rama. Asegúrese de que la variable Usuario/Grupo está configurado.
-
Haga clic en Sincronización (barra de herramientas del editor) para mantener los cambios en el modelo de tiempo de ejecución.
Consulte Sincronizar el flujo de trabajo para obtener más información.
Función Check() function-check
El siguiente script de ejemplo devuelve true si el nodo es un JCR_PATH ubicado bajo /content/we-retail/us/en:
function check() {
if (workflowData.getPayloadType() == "JCR_PATH") {
var path = workflowData.getPayload().toString();
var node = jcrSession.getItem(path);
if (node.getPath().indexOf("/content/we-retail/us/en") >= 0) {
return true;
} else {
return false;
}
} else {
return false;
}
}
Ejemplo: Solicitud de activación personalizada example-customized-request-for-activation
Puede personalizar cualquiera de los flujos de trabajo predeterminados. Para tener un comportamiento personalizado, superponga los detalles del flujo de trabajo adecuado.
Por ejemplo, Solicitud de activación. Este flujo de trabajo se utiliza para publicar páginas en Sitios y se activa automáticamente cuando un autor de contenido no tiene los derechos de replicación adecuados. Consulte Personalización de la creación de páginas: personalización del flujo de trabajo de solicitud de activación para obtener más información.