Administration d’instances de workflows

La console de workflows fournit plusieurs outils permettant d’administrer les instances de workflows pour vérifier qu’elles s’exécutent comme prévu.

Remarque

The JMX console provides additional workflow maintenance operations.

Différentes consoles sont à votre disposition pour administrer les workflows. Use the global navigation to open the Tools pane, then select Workflow:

  • Modèles : gérez les définitions de workflows.
  • Instances : affichez et gérez l’exécution des instances de workflows.
  • Lanceurs : gérez le lancement des workflows.
  • Archiver : affichez l’historique des workflows correctement terminés.
  • Échecs : affichez l’historique des workflows terminés avec des erreurs.

Suivi du statut des instances de workflows

  1. Avec la navigation, sélectionnez Outil, puis Workflows.

  2. Sélectionnez Instances pour afficher la liste des instances de workflows en cours.

    wf-96

  3. Sélectionnez un élément spécifique, puis Ouvrir l’historique pour afficher plus de détails :

    wf-97

Suspension, reprise ou arrêt d’une instance de workflows

  1. Avec la navigation, sélectionnez Outil, puis Workflows.

  2. Sélectionnez Instances pour afficher la liste des instances de workflows en cours.

    wf-96-1

  3. Sélectionnez un élément spécifique, puis utilisez Arrêter, Suspendre ou Reprendre, selon le cas. Une confirmation et/ou d’autres détails sont requis :

    wf-97-1

Affichage des workflows archivés

  1. Avec la navigation, sélectionnez Outil, puis Workflows.

  2. Sélectionnez Archiver pour afficher la liste des instances de workflows qui se sont terminées avec succès.

    wf-98

    Remarque

    Le statut d’abandon est considéré comme un arrêt réussi, car il se produit suite à une action de l’utilisateur. Par exemple :

    • Utilisation de l’action Terminer
    • lorsqu’une page, soumise à un flux de travail, est supprimée (force), le flux de travail est arrêté
  3. Sélectionnez un élément spécifique, puis Ouvrir l’historique pour afficher plus de détails :

    wf-99

Correction des échecs d’instance de workflows

Lorsqu’un workflow échoue, AEM fournit la console Échecs pour vous permettre d’enquêter et de prendre la mesure appropriée une fois la cause d’origine traitée :

  • Détails d’échec Ouvre une fenêtre pour afficher la variable
    Message d’échec, étape et pile ​d’échec.

  • Ouvrir l’historique Affiche des détails sur l’historique des workflows.

  • Relancer l’étape Exécute à nouveau l’instance du composant d’étape de test. Utilisez la commande Relancer l’étape après avoir corrigé la cause de l’erreur d’origine. Par exemple, relancez l’étape après avoir corrigé un bogue dans le script que l’étape de processus exécute.

  • Arrêter Arrêtez le workflow si l’erreur a provoqué une situation irréconciliable pour le workflow. Par exemple, le workflow peut se baser sur des conditions environnementales comme des informations figurant dans le référentiel qui ne sont plus valides pour l’instance de workflow.

  • Arrêter et réessayer Similaire à Arrêter, à ceci près qu’une nouvelle instance de workflow est lancée à l’aide de la charge utile, du titre et de la description d’origine.

Pour examiner les échecs, puis reprendre ou arrêter le workflow par la suite, utilisez les étapes suivantes :

  1. Avec la navigation, sélectionnez Outil, puis Workflows.

  2. Sélectionnez Échecs pour afficher la liste des instances de workflows qui ne se sont pas terminées avec succès.

  3. Sélectionnez un élément spécifique, puis l’action appropriée :

    wf-47

Purge régulière des instances de workflow

Réduire le nombre d’instances de workflow améliore les performances du moteur de workflows. Vous pouvez donc purger régulièrement les instances de workflows terminées ou en cours d’exécution du référentiel.

Configurez la configuration de la purge du workflow Adobe Granite pour purger les instances de workflows en fonction de leur âge et de leur statut. Vous pouvez également purger les instances de workflows de tous les modèles ou d’un modèle spécifique.

Vous pouvez également créer plusieurs configurations du service pour purger les instances de workflows qui répondent à différents critères. Par exemple, créez une configuration qui purge les instances d’un modèle de workflow particulier lorsqu’elles s’exécutent beaucoup plus longtemps que prévu. Créez une autre configuration qui purge tous les workflows terminés après un certain nombre de jours pour réduire la taille du référentiel.

Pour configurer le service, vous pouvez utiliser la console Web ou ajouter une configuration OSGi au référentiel. Le tableau suivant décrit les propriétés dont vous avez besoin pour l’une ou l’autre de ces méthodes.

Remarque

Pour ajouter la configuration au référentiel, le PID de service est :

com.adobe.granite.workflow.purge.Scheduler

Le service étant un service d’usine, le nom du nœud sling:OsgiConfig nécessite un suffixe d’identifiant, tel que :

com.adobe.granite.workflow.purge.Scheduler-myidentifier

Nom de propriété (console Web) Nom de propriété OSGi Description
Nom de la tâche scheduledpurge.name Nom descriptif de la purge planifiée.
État du workflow scheduledpurge.workflowStatus

Statut des instances de workflowsà purger. Les valeurs suivantes sont valides :

  • TERMINÉ : les instances de workflows terminées sont purgées.
  • EN COURS : les instances de workflows en cours d’exécution sont purgées.
Modèles à purger scheduledpurge.modelIds

ID des modèles de workflows à purger. L’ID est le chemin d’accès au nœud de modèle, par exemple :
/conf/global/settings/workflow/models/dam/update_asset/jcr:content/model
Pour purger les instances de tous les modèles de workflows, ne spécifiez aucune valeur.

Pour spécifier plusieurs modèles, cliquez sur le bouton + dans la console Web.

Âge de workflow scheduledpurge.daysold L’âge des instances de workflows à purger, exprimé en jours.

Définition de la taille maximale de la boîte de réception

You can set the maximum size of the inbox by configuring the Adobe Granite Workflow Service, using the Web Console or add an OSGi configuration to the repository. Le tableau suivant décrit la propriété que vous configurez pour l’une ou l’autre méthode.

Remarque

Pour ajouter la configuration au référentiel, le PID de service est :

com.adobe.granite.workflow.core.WorkflowSessionFactory.

Nom de propriété (console Web) Nom de propriété OSGi
Taille maximale de la Requête de la boîte de réception granite.workflow.inboxQuerySize

Sur cette page