Amministrazione delle istanze dei flussi di lavoro administering-workflow-instances

La console Flusso di lavoro fornisce diversi strumenti per l’amministrazione delle istanze del flusso di lavoro, in modo che vengano eseguite come previsto.

Sono disponibili diverse console per l’amministrazione dei flussi di lavoro. Utilizza la navigazione globale per aprire il riquadro Strumenti, quindi selezionare Flusso di lavoro:

Monitoraggio dello stato delle istanze del flusso di lavoro monitoring-the-status-of-workflow-instances

Sospensione, Ripresa e Chiusura di un’istanza di flusso di lavoro suspending-resuming-and-terminating-a-workflow-instance

Visualizzazione dei flussi di lavoro archiviati viewing-archived-workflows

Correzione degli errori di un'istanza del flusso di lavoro fixing-workflow-instance-failures

Quando un flusso di lavoro non riesce, AEM fornisce Errori per indagare e intraprendere azioni appropriate una volta gestita la causa originale:

Per approfondire gli errori, quindi riprendere o terminare il flusso di lavoro in seguito, utilizza i seguenti passaggi:

Rimozione regolare delle istanze del flusso di lavoro regular-purging-of-workflow-instances

Minimizzare il numero di istanze del flusso di lavoro aumenta le prestazioni del motore del flusso di lavoro, in modo da poter eliminare regolarmente dall’archivio le istanze del flusso di lavoro completate o in esecuzione.

Configura Configurazione di eliminazione del flusso di lavoro di Adobe Granite per eliminare le istanze del flusso di lavoro in base all’età e allo stato. È inoltre possibile eliminare le istanze del flusso di lavoro di tutti i modelli o di un modello specifico.

Puoi anche creare più configurazioni del servizio per eliminare le istanze del flusso di lavoro che soddisfano criteri diversi. Ad esempio, crea una configurazione che elimina le istanze di un particolare modello di flusso di lavoro quando sono in esecuzione per un periodo di tempo superiore a quello previsto. Crea un’altra configurazione che elimina tutti i flussi di lavoro completati dopo un certo numero di giorni per ridurre al minimo le dimensioni dell’archivio.

Per configurare il servizio, puoi utilizzare Console web o aggiungere una configurazione OSGi all’archivio. Nella tabella seguente sono descritte le proprietà necessarie per entrambi i metodi.

Impostazione della dimensione massima della casella in entrata setting-the-maximum-size-of-the-inbox

È possibile impostare la dimensione massima della casella in entrata configurando Servizio flusso di lavoro Adobe Granite, utilizzando Console web o aggiungere una configurazione OSGi all’archivio. Nella tabella seguente viene descritta la proprietà configurata per entrambi i metodi.

Utilizzo delle variabili del flusso di lavoro per gli archivi dati di proprietà del cliente using-workflow-variables-customer-datastore

I dati elaborati dai flussi di lavoro vengono memorizzati nell’archiviazione fornita da Adobe (JCR). Per loro natura tali dati possono essere sensibili. È possibile salvare tutti i metadati/dati definiti dall’utente nello spazio di archiviazione personale anziché nell’archiviazione fornita da Adobe. Le presenti sezioni descrivono come configurare queste variabili per l’archiviazione esterna.

Impostare il modello per l’utilizzo dell’archiviazione esterna dei metadati set-model-for-external-storage

Viene fornito un flag a livello di modello di flusso di lavoro per indicare che tale modello (e le sue istanze di runtime) dispone di archiviazione esterna dei metadati. Le variabili del flusso di lavoro non vengono rese persistenti in JCR per le istanze del flusso di lavoro dei modelli contrassegnati per l’archiviazione esterna.

La proprietà userMetadataPersistenceEnabled viene memorizzata nel nodo jcr:content del modello di flusso di lavoro. Questo flag viene reso persistente nei metadati del flusso di lavoro come cq:userMetaDataCustomPersistenceEnabled.

L’illustrazione seguente mostra come configurare il flag in un flusso di lavoro.

API per metadati nell’archiviazione esterna apis-for-metadata-external-storage

Per memorizzare le variabili esternamente, implementa le API esposte dal flusso di lavoro.

UserMetaDataPersistenceContext

Gli esempi seguenti mostrano come utilizzare l’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;
}