Administración de instancias de flujo de trabajo administering-workflow-instances

La consola de flujo de trabajo proporciona varias herramientas para administrar instancias de flujo de trabajo a fin de garantizar que se ejecuten según lo esperado.

Hay una serie de consolas disponibles para administrar los flujos de trabajo. Utilice la variable navegación global para abrir el panel Herramientas y, a continuación, seleccione Flujo de trabajo:

Monitorización del estado de las instancias de flujo de trabajo monitoring-the-status-of-workflow-instances

Suspender, reanudar y finalizar una instancia de flujo de trabajo suspending-resuming-and-terminating-a-workflow-instance

Visualización de flujos de trabajo archivados viewing-archived-workflows

Corrección de errores de instancias de flujo de trabajo fixing-workflow-instance-failures

AEM Cuando falla un flujo de trabajo, proporciona la consola Failures para que usted pueda investigar y tomar las medidas adecuadas una vez que se haya manejado la causa original:

Para investigar los errores y luego reanudar o finalizar el flujo de trabajo más tarde, siga estos pasos:

Depuración regular de instancias de flujo de trabajo regular-purging-of-workflow-instances

Al minimizar el número de instancias de flujo de trabajo, aumenta el rendimiento del motor de flujo de trabajo, por lo que puede depurar con regularidad las instancias de flujo de trabajo completadas o en ejecución desde el repositorio.

Configure Configuración de depuración del flujo de trabajo de Adobe Granite para depurar instancias de flujo de trabajo según su antigüedad y estado. También puede depurar instancias de flujo de trabajo de todos los modelos o de uno específico.

También puede crear varias configuraciones del servicio para depurar instancias de flujo de trabajo que cumplan distintos criterios. Por ejemplo, cree una configuración que depure las instancias de un modelo de flujo de trabajo concreto cuando se ejecuten durante más tiempo del esperado. Cree otra configuración que depure todos los flujos de trabajo completados después de un determinado número de días para minimizar el tamaño del repositorio.

Para configurar el servicio, puede usar la consola web o agregar una configuración OSGi al repositorio. En la tabla siguiente, se describen las propiedades que necesita para cualquiera de los métodos.

Configuración del tamaño máximo de la bandeja de entrada setting-the-maximum-size-of-the-inbox

Puede establecer el tamaño máximo de la bandeja de entrada configurando el Servicio de flujo de trabajo de Granite de Adobe, usando la consola web o agregando una configuración OSGi al repositorio. En la tabla siguiente se describe la propiedad que se configura para cualquiera de los métodos.

Usar variables de flujo de trabajo para almacenes de datos propiedad del cliente using-workflow-variables-customer-datastore

Los datos procesados por flujos de trabajo se almacenan en el almacenamiento proporcionado por el Adobe (JCR). Estos datos pueden ser de naturaleza delicada. Es posible que desee guardar todos los metadatos/datos definidos por el usuario en su propio almacenamiento administrado en lugar del almacenamiento proporcionado por Adobe. En estas secciones se describe cómo configurar estas variables para el almacenamiento externo.

Establecer el modelo para que utilice el almacenamiento externo de metadatos set-model-for-external-storage

En el nivel del modelo de flujo de trabajo, se proporciona un indicador para indicar que el modelo (y sus instancias de tiempo de ejecución) tiene almacenamiento externo de metadatos. Las variables de flujo de trabajo no persisten en JCR para las instancias de flujo de trabajo de los modelos marcados para almacenamiento externo.

La propiedad userMetadataPersistenceEnabled se almacena en la variable jcr:nodo de contenido del modelo de flujo de trabajo. Este indicador se mantiene en los metadatos del flujo de trabajo como cq:userMetaDataCustomPersistenceEnabled.

La siguiente ilustración muestra cómo establecer el indicador en un flujo de trabajo.

API para metadatos en almacenamiento externo apis-for-metadata-external-storage

Para almacenar las variables de forma externa, implemente las API que expone el flujo de trabajo.

UserMetaDataPersistenceContext

Los siguientes ejemplos muestran cómo utilizar la API.

@ProviderType
public interface UserMetaDataPersistenceContext {

    /**
     * Gets the workflow for persistence
     * @return workflow
     */
    Workflow getWorkflow();

    /**
     * Gets the workflow id for persistence
     * @return workflowId
     */
    String getWorkflowId();

    /**
     * Gets the user metadata persistence id
     * @return userDataId
     */
    String getUserDataId();
}

UserMetaDataPersistenceProvider

/**
 * This provider can be implemented to store the user defined workflow-data metadata in a custom storage location
 */
@ConsumerType
public interface UserMetaDataPersistenceProvider {

   /**
    * Retrieves the metadata using a unique identifier
    * @param userMetaDataPersistenceContext
    * @param metaDataMap of user defined workflow data metaData
    * @throws WorkflowException
    */
   void get(UserMetaDataPersistenceContext userMetaDataPersistenceContext, MetaDataMap metaDataMap) throws WorkflowException;

   /**
    * Stores the given metadata to the custom storage location
    * @param userMetaDataPersistenceContext
    * @param metaDataMap metadata map
    * @return the unique identifier that can be used to retrieve metadata. If null is returned, then workflowId is used.
    * @throws WorkflowException
    */
   String put(UserMetaDataPersistenceContext userMetaDataPersistenceContext, MetaDataMap metaDataMap) throws WorkflowException;
}