Creación de modelos de flujo de trabajo

PRECAUCIÓN

Para usar la IU clásica, consulte la Documentación de AEM 6.3 como referencia.

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

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:

  1. Abra el Modelos de flujo de trabajo consola; via Herramientas, Flujo de trabajo, Modelos o, por ejemplo: https://localhost:4502/aem/workflow
  2. Seleccione Crear y, a continuación, Crear modelo.
  3. La variable Agregar modelo de flujo de trabajo se abre. Introduzca la variable Título y Nombre (opcional) antes de seleccionar Listo.
  4. El nuevo modelo se enumera en la Modelos de flujo de trabajo consola.
  5. Seleccione el nuevo flujo de trabajo y, a continuación, utilice Editar para abrirlo y configurarlo:
    wf-01
NOTA

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

/var/workflow/models

Por ejemplo, /var/workflow/models/prototypes.

Esta carpeta se puede usar 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:

Edición de un Predeterminado y/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

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:

wf-21

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

Cuando abra un Modelo predeterminado y/o heredado para edición:

  • El navegador Pasos 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
      Selección
      Editar será:
  • llevar una copia del flujo de trabajo a /conf
  • hacer que el navegador Pasos esté disponible
  • permite realizar cambios
NOTA

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

wf-22

Adición de un paso a un modelo

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 Navegador Pasos. Por ejemplo:

wf-10

NOTA

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

Para añadir pasos al modelo de flujo de trabajo:

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

  2. Abra el explorador Pasos . 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 wf-step-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, una Etapa de participante.

    Una vez añadido al flujo, puede configurar el paso.

    wf-03

  4. 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: wf-contraseexpand-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 flujo de trabajo

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

  1. Para abrir el Propiedades de los pasos para un paso:

    • Toque o haga clic en el* *paso del modelo de flujo de trabajo y seleccione Configurar en la barra de herramientas de componentes.

    • Haga doble clic en el paso .

    NOTA

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

  2. 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:

    wf-11

  3. Confirme sus actualizaciones con el visto.

  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 Transitorio modelo de flujo de trabajo al crear un nuevo modelo o al editar uno existente:

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

  2. Select Propiedades del modelo de flujo de trabajo en la barra de herramientas.

  3. En el cuadro de diálogo activar Flujo de trabajo transitorio (o desactivar si es necesario):

    wf-07

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

NOTA

Al ejecutar un flujo de trabajo en transient modo AEM no almacena ningún historial de flujo de trabajo. Por lo tanto, Cronología no muestra ninguna información relacionada con ese flujo de trabajo.

Hacer que los modelos de flujo de trabajo estén disponibles en la interfaz de usuario 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 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.

  1. Confirme que el modelo no está disponible en la IU táctil. Acceder a un recurso mediante /assets.html/content/dam ruta. 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.

  2. Navegar por Herramientas > General > Etiquetado. Select Flujo de trabajo.

  3. Select Crear > Crear etiqueta. Establezca Título como DAM y Nombre como dam. Seleccione Enviar.
    Creación de una etiqueta en el modelo de flujo de trabajo

  4. Vaya a Herramientas > Flujo de trabajo > Modelos. Select Solicitud de activación y, a continuación, seleccione Editar.

  5. Select Editar, abra el Información de la página y seleccione Abrir propiedades y vaya a Básico (si no está abierta).

  6. Agregar Workflow : DAM a Etiquetas campo . 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 modelo nuevo o al editar uno existente:

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

  2. Select Propiedades del modelo de flujo de trabajo en la barra de herramientas.

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

    wf-08

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

Etapas del flujo de trabajo ayuda a visualizar el progreso de un flujo de trabajo al administrar tareas.

PRECAUCIÓN

Si las etapas del flujo de trabajo se definen en Propiedades de página, pero no se utiliza para ninguno de los pasos del flujo de trabajo, la barra de progreso no muestra 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 escenario. Puede definir cualquier número de etapas para el modelo de flujo de trabajo.

Para definir Etapas para el flujo de trabajo:

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

  2. Select Propiedades del modelo de flujo de trabajo en la barra de herramientas. A continuación, abra el Etapas pestaña .

  3. Añada (y posicione) su Etapas. 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 un escenario 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 Revisión
    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 flujo de trabajo en un paquete

Para exportar un modelo de flujo de trabajo en un paquete:

  1. Cree un nuevo paquete utilizando la variable Administrador de paquetes:

    1. Vaya al Administrador de paquetes a través de Herramientas, Implementación, Paquetes.

    2. Haga clic en Crear paquete.

    3. Especifique la variable 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 el Filtros pestaña .

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

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

  6. Añada filtros adicionales para cualquier secuencia de comandos personalizada que utilice el modelo.

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

  8. Select Generar de la barra de herramientas de la definición del paquete.

  9. Select 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. Agregue un Formulario a la página.

  3. Configurar el Inicio del formulario que apareció en la página.

  4. Uso Iniciar flujo de trabajo para seleccionar el flujo de trabajo deseado de los disponibles:

    wf-12

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

Flujos de trabajo de prueba

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:

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

  2. Defina el Carga útil y confirme.

  3. Realice las acciones necesarias para que se ejecute el flujo de trabajo.

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

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 creación de un flujo de trabajo, el siguiente ejemplo crea una variación de la variable Publish Example flujo de trabajo.

  1. Creación de un nuevo modelo de flujo de trabajo.

    El nuevo flujo de trabajo contiene:

    • 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 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 del 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 doble clic en el paso del participante.
  5. En el Frecuentes tab enter Validate Content para ambas Título y Descripción.

  6. Abra el Usuario/Grupo pestaña:

    • Activar Notificar al usuario por correo electrónico.
    • Select Administrator ( admin) para la variable Usuario/Grupo campo .
  7. 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.

  8. Arrastre un División O en el flujo de trabajo y colóquelo entre Validate Content y Fin del flujo.

  9. Abra el División O para la configuración.

  10. Configuración de:

    • Frecuentes: especifique el nombre dividido.

    • Rama 1: select Ruta predeterminada.

    • Rama 2: garantizar Ruta predeterminada no está seleccionado.

  11. Confirme las actualizaciones a la División OR.

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

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

  14. 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:

    wf-13

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

    chlimage_1-72

Ejemplo: Definición de una regla para una división OR mediante una secuencia de comandos ECMA

División OR los pasos le permiten introducir rutas de procesamiento condicionales en el flujo de trabajo.

Para definir una regla OR, siga estos pasos:

  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 un function check() que devuelve un valor booleano.

  2. Edite el flujo de trabajo y añada la variable División OR al modelo.

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

    NOTA

    Si es necesario, puede cambiar el orden de las ramas.

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

  5. Defina las propiedades de los pasos individuales de cada rama. Asegúrese de que la variable Usuario/Grupo está configurado.

  6. 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()

NOTA

Consulte Uso de ECMAScript.

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

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.

En esta página