Creación de modelos de flujo de trabajo

ATENCIÓN

Para obtener más información sobre el uso de la IU clásica, consulte la documentación de AEM 6.3.

Puede crear un modelo de flujo de trabajo para definir la serie de pasos ejecutados cuando un usuario inicio el flujo de trabajo. También puede definir propiedades de modelo, como si el flujo de trabajo es transitorio o utiliza varios recursos.

Cuando un usuario inicio un flujo de trabajo, se inicia una instancia; este es el modelo de tiempo de ejecución correspondiente, creado cuando Sincronice los cambios.

Creación de un nuevo flujo de trabajo

Cuando se crea un nuevo modelo de flujo de trabajo, éste contiene:

  • Los pasos Inicio de flujo y Fin de flujo.

    Representan el principio y el final del flujo de trabajo. Estos pasos son obligatorios y no se pueden editar ni eliminar.

  • Un ejemplo de Participante paso denominado Paso 1.

    Este paso está configurado para asignar un elemento de trabajo al iniciador del flujo de trabajo. Edite o elimine este paso, y agregue los pasos necesarios.

Para crear un nuevo flujo de trabajo con el editor:

  1. Abra la consola Modelos de flujo de trabajo; mediante Herramientas, Flujo de trabajo, Modelos o, por ejemplo:

    http://localhost:4502/aem/workflow

  2. Seleccione Crear y luego Crear modelo.

  3. Aparece el cuadro de diálogo Añadir modelo de flujo de trabajo. Escriba Título y Nombre (opcional) antes de seleccionar Listo.

  4. El nuevo modelo se enumera en la consola Modelos de flujo de trabajo.

  5. Seleccione el nuevo flujo de trabajo y, a continuación, utilice Editar​para abrirlo para la configuración:

    wf-01

NOTA

Si crea modelos mediante programación (mediante un paquete crx), también puede crear una subcarpeta dentro de:

/var/workflow/models

Por ejemplo, /var/workflow/models/prototypes

Esta carpeta se puede utilizar para administrar el acceso a los modelos de esa carpeta.

Edición de un flujo de trabajo

Puede editar cualquier modelo de flujo de trabajo existente para:

Editar un flujo de trabajo predeterminado o heredado (predeterminado) tiene un paso adicional para garantizar que se realice una copia segura antes de realizar los cambios.

Cuando se completen las actualizaciones del flujo de trabajo, debe utilizar Sincronizar para 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

La sincronización (derecha en la barra de herramientas del editor) genera un modelo de tiempo de ejecución. El modelo de tiempo de ejecución es el modelo que se utiliza realmente cuando un usuario inicio un flujo de trabajo. Si no Sincroniza los cambios, éstos no estarán disponibles en tiempo de ejecución.

Cuando usted (o cualquier otro usuario) realice cambios en el flujo de trabajo, debe utilizar Sincronizar para generar un modelo de tiempo de ejecución, incluso cuando los diálogos individuales (por ejemplo, para pasos) tengan sus propias opciones de guardado.

Cuando los cambios se sincronizan con el modelo de tiempo de ejecución (guardado), se muestra Sincronizado en su lugar.

Algunos pasos tienen campos obligatorios y/o validación integrada. Cuando no se cumplan estas condiciones, se mostrará un error al intentar sincronizar el modelo. Por ejemplo, cuando no se ha definido ningún participante para un paso Participante:

wf-21

Edición de un flujo de trabajo predeterminado o heredado por primera vez

Al abrir un modelo predeterminado y/o heredado para editarlo:

  • El explorador Pasos no está disponible (lado izquierdo).

  • Hay una acción Editar disponible en la barra de herramientas (lado derecho).

  • Inicialmente, el modelo y sus propiedades se presentan en modo de sólo lectura como:

    • Los flujos de trabajo predeterminados se encuentran en /libs
    • Los flujos de trabajo heredados se encuentran en /etc

Si selecciona Editar:

  • llevar una copia del flujo de trabajo a /conf
  • hacer que el explorador Pasos esté disponible
  • permitir que realice cambios
NOTA

Consulte Ubicaciones de modelos de flujo de trabajo para obtener más información.

wf-22

Añadir un paso a un modelo

Deberá agregar 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 del explorador Pasos. Por ejemplo:

wf-10

NOTA

Para obtener información sobre los componentes de paso principales instalados con AEM, consulte Referencia de pasos de flujo de trabajo.

Para agregar un paso a un modelo:

  1. Abra un modelo de flujo de trabajo existente para editarlo. En la consola Modelo de Flujos de trabajo, seleccione el modelo requerido y, a continuación, Editar.

  2. Abra el explorador Pasos; con 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 wf-step-info-icon para mostrar más detalles sobre el paso adecuado.

    wf-02

  3. Arrastre los pasos correspondientes a la ubicación requerida en el modelo.

    Por ejemplo, un paso del participante.

    Después de agregarlo al flujo, puede configurar el paso.

    wf-03

  4. Añada 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 otra ubicación del modelo.

    También puede copiar, cortar, pegar, agrupar o eliminar los 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: wf-scseexpanded-toolbar-icon

  5. 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 workflow

Puede configurar y personalizar el comportamiento de un paso de flujo de trabajo mediante los cuadros de diálogo Propiedades del paso.

  1. Para abrir el cuadro de diálogo Propiedades del paso para obtener un paso:

    • Toque el paso en el modelo de flujo de trabajo y seleccione Configurar en la barra de herramientas de componentes.
    • Haga clic con el doble en el paso.
    NOTA

    Para obtener información sobre los componentes de paso principales instalados con AEM, consulte Referencia de pasos de flujo de trabajo.

  2. Configure las Propiedades del paso según sea necesario; las propiedades disponibles dependen del tipo de paso; también puede haber varias fichas disponibles. Por ejemplo, el paso de participante predeterminado, presente en un nuevo flujo de trabajo como Step 1:

    wf-11

  3. Confirme sus actualizaciones con la marca.

  4. 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

Puede crear un modelo de flujo de trabajo transitorio al crear un modelo nuevo o al editar uno existente:

  1. Abra el modelo de workflow para edición.

  2. Seleccione Propiedades del modelo de workflow en la barra de herramientas.

  3. En el cuadro de diálogo, active Flujo de trabajo transitorio (o desactive si es necesario):

    wf-07

  4. Confirme el cambio con Guardar y cerrar; seguido de Sync (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.

NOTA

Cuando se ejecuta un flujo de trabajo en modo transitorio AEM no almacena ningún historial de flujo de trabajo. Por lo tanto, Timeline no muestra ninguna información relacionada con ese flujo de trabajo.

Hacer que los modelos de flujo de trabajo estén disponibles en la IU táctil

Si hay un modelo de flujo de trabajo en la IU clásica, pero falta en el menú emergente de selección en el carril Línea de tiempo de la IU táctil, 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.

  1. Confirme que el modelo no está disponible en la IU táctil. Acceda a un recurso mediante /assets.html/content/dam ruta. Seleccione un recurso. Abra Línea de tiempo en el carril izquierdo. Haga clic en Flujo de trabajo de Inicio y confirme que el modelo Solicitud de Activación no está presente en la lista emergente.

  2. Navegue por Herramientas > General > Etiquetado. Seleccione Flujo de trabajo.

  3. Seleccione Crear > Crear etiqueta. Establezca Título como DAM y Nombre como dam. Seleccione Enviar.
    Crear etiqueta en modelo de flujo de trabajo

  4. Vaya a Herramientas > Flujo de trabajo > Modelos. Seleccione Solicitud de Activación y luego seleccione Editar.

  5. Seleccione Editar y luego abra Propiedades del modelo de flujo de trabajo. Vaya a la ficha Basic.

  6. Añada Workflow : DAM en el campo Etiquetas. Confirme la selección con la marca de verificación (visto).

  7. Confirme la adición de la etiqueta con Guardar y cerrar.
    Editar propiedades de página del modelo

  8. 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

Puede configurar un modelo de flujo de trabajo para Compatibilidad con varios recursos al crear un nuevo modelo o al editar uno existente:

  1. Abra el modelo de workflow para edición.

  2. Seleccione Propiedades del modelo de workflow en la barra de herramientas.

  3. En el cuadro de diálogo, active Compatibilidad con varios recursos (o desactive si es necesario):

    wf-08

  4. Confirme el cambio con Guardar y cerrar; seguido de Sync (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 las etapas del flujo de trabajo (que muestran el progreso del flujo de trabajo)

Las etapas de flujo de trabajo ayudan a visualizar el progreso de un flujo de trabajo al administrar tareas.

ATENCIÓN

Si las etapas del flujo de trabajo están definidas en Propiedades de la página, pero no se utilizan para ninguno de los pasos del flujo de trabajo, la barra de progreso no mostrará ningún progreso (independientemente del paso actual del flujo de trabajo).

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 etapas. Puede definir cualquier número de etapas para el modelo de flujo de trabajo.

Para definir Fases para el flujo de trabajo:

  1. Abra el modelo de flujo de trabajo para editarlo.

  2. Seleccione Propiedades del modelo de workflow en la barra de herramientas. A continuación, abra la ficha Fases.

  3. Añada (y coloque) las etapas requeridas. Puede definir cualquier número de etapas para el modelo de flujo de trabajo.

    Por ejemplo:

    wf-08-1

  4. Haga clic en Guardar y cerrar para guardar las propiedades.

  5. Asigne una etapa a cada uno de los pasos del modelo de flujo de trabajo. Por ejemplo:

    wf-09

    Se puede asignar un escenario a más de un paso. Por ejemplo:

    Etapa Escenario
    Etapa 1 Crear
    Etapa 2 Crear
    Etapa 3 Crítica
    Etapa 4 Aprobar
    Etapa 5 Aprobar
    Etapa 6 Completar
  6. 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 workflow en un paquete

  1. Cree un nuevo paquete con el Administrador de paquetes:

    1. Vaya al Administrador de paquetes mediante Herramientas, Implementación, Paquetes.
    2. Haga clic en Crear paquete.
    3. Especifique el nombre del paquete y cualquier otro detalle según sea necesario.
    4. Haga clic en Aceptar.
  2. Haga clic en Editar en la barra de herramientas del nuevo paquete.

  3. Abra la ficha Filtros.

  4. Seleccione Añadir filtro y especifique la ruta de su modelo de flujo de trabajo diseño:

    /conf/global/settings/workflow/models/<*your-model-name*>

    Haga clic en Listo.

  5. Seleccione Añadir filtro y especifique la ruta del modelo de flujo de trabajo tiempo de ejecución:

    /var/workflow/models/<*your-model-name*>

    Haga clic en Listo.

  6. Añada filtros adicionales para las secuencias de comandos personalizadas que utilice el modelo.

  7. Haga clic en Guardar para confirmar las definiciones del filtro.

  8. Seleccione Build en la barra de herramientas de la definición del paquete.

  9. Seleccione Descargar en la barra de herramientas del paquete.

Uso de Flujos de trabajo para procesar envíos de formularios

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:

  1. Cree una nueva página y ábrala para editarla.

  2. Añada un componente Formulario a la página.

  3. Configure el componente Inicio de formulario que aparece en la página.

  4. Utilice Flujo de trabajo de Inicio para seleccionar el flujo de trabajo deseado de entre los disponibles:

    wf-12

  5. Confirme la nueva configuración del formulario con la marca de verificación.

Prueba de Flujos de trabajo

Es una buena práctica, al probar un flujo de trabajo, utilizar diversos tipos de carga útil; incluir tipos distintos de los tipos para los que se ha desarrollado. Por ejemplo, si desea que el flujo de trabajo se ocupe de los recursos, 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:

  1. Inicio el modelo de flujo de trabajo desde la consola.

  2. Defina la Carga útil y confirme.

  3. Realice las acciones necesarias para que el flujo de trabajo continúe.

  4. Monitoree los archivos de registro mientras se ejecuta el flujo de trabajo.

También puede configurar AEM para que muestren mensajes DEBUG en los archivos de registro. Consulte Registro para obtener más información y, cuando termine el desarrollo, establezca el Nivel de registro en Información.

Ejemplos

Ejemplo: Creación de un flujo de trabajo (simple) para aceptar o rechazar una solicitud de publicación

Para ilustrar algunas de las posibilidades de crear un flujo de trabajo, en el siguiente ejemplo se crea una variación del flujo de trabajo Publish Example.

  1. Cree un nuevo modelo de flujo de trabajo.

    El nuevo flujo de trabajo contendrá:

    • Inicio de flujo
    • Step 1
    • Fin de flujo
  2. 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.
  3. En la selección del explorador de pasos de Flujo de trabajo, arrastre un Paso del participante al flujo de trabajo y colóquelo entre Inicio de flujo y Fin de flujo.

  4. 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 clic con el doble en el paso del participante.
  5. En la ficha Common introduzca Validate Content tanto para el Título como para la Descripción.

  6. Abra la ficha Usuario/Grupo:

    • Active Notificar al usuario por correo electrónico.
    • Seleccione Administrator ( admin) para el campo Usuario/Grupo.
  7. Confirme las actualizaciones con la marca de verificación.

    Volverá a la descripción general del modelo de flujo de trabajo, donde se cambiará el nombre del paso del participante a Validate Content.

  8. Arrastre un O dividido al flujo de trabajo y colóquelo entre Validate Content y Flujo final.

  9. Abra O Split para la configuración.

  10. Configuración:

    • Frecuentes: seleccionar 2 ramas
    • Rama 1: seleccione Ruta ​predeterminada.
    • Rama 2: asegúrese de que las rutas predeterminadas no estén seleccionadas.
  11. Confirme las actualizaciones de OR Split.

  12. Arrastre un Paso del participante a 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.
  13. Arrastre un paso de proceso a la rama derecha, abra las propiedades, especifique los valores siguientes y confirme los cambios:

    • Título: Publish Page as Requested
    • Proceso: seleccione Activate Page. Este proceso publica la página seleccionada en las instancias del editor.
  14. Haga clic en Sincronizar (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á este aspecto:

    wf-13

  15. Aplique este flujo de trabajo a la página, de modo que cuando el usuario pase a Completar el paso Validar contenido, pueda seleccionar si desea Publicar página como solicitada o Rechazar solicitud de publicación.

    chlimage_1-182

Ejemplo: Definición de una regla para una división OR

O Splitstep le permite introducir rutas de procesamiento condicionales en el flujo de trabajo.

Para definir una regla O:

  1. Cree dos secuencias de comandos y guárdelas en el repositorio, por ejemplo en:

    /apps/myapp/workflow/scripts

    NOTA

    Las secuencias de comandos deben tener una función check() que devuelve un valor booleano.

  2. Edite el flujo de trabajo y agregue el OR Split al modelo.

  3. Edite las propiedades de Branch 1 de OR Split:

    • Defina esto como la Ruta predeterminada estableciendo el Valor en true.

    • Como Regla, establezca la ruta de acceso a la secuencia de comandos. Por ejemplo:

      /apps/myapp/workflow/scripts/myscript1.ecma

    NOTA

    Si es necesario, puede cambiar el orden de ramificación.

  4. Edite las propiedades de la rama 2 de la división OR.

    • Como Regla, establezca la ruta de acceso a la otra secuencia de comandos. Por ejemplo:

      /apps/myapp/workflow/scripts/myscript2.ecma

  5. Configure las propiedades de los pasos individuales de cada rama. Asegúrese de que User/Group está establecido.

  6. Haga clic en Sincronizar (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()

NOTA

Consulte Uso de ECMAScript.

La siguiente secuencia de comandos de ejemplo devuelve true si el nodo es JCR_PATH ubicado en /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

Puede personalizar cualquiera de los flujos de trabajo listos para usar. 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 dentro de 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.

En esta página