Flux de travail de publication/extraction

Les workflows commencent à avoir un impact sur vos opérations dès leur publication. Tant que vous n'avez pas publié un workflow valide, votre conception reste à l'état de brouillon :

Avant qu'ESM autorise la mise en service d'un workflow, il vérifie si sa conception contient des erreurs majeures, telles que des instructions de condition manquantes dans les activités de condition. Les éléments présentant des configurations erronées seront signalés par des bordures rouges dans l'éditeur jusqu'à ce que la configuration soit valide.

Une fois qu'un workflow est publié dans le service actif, tous les nouveaux problèmes entrants déclencheront l'exécution du workflow si les critères de sélection sont remplis.

Si, après avoir publié un workflow, vous constatez qu'il ne fonctionne pas comme prévu ou si vous souhaitez le supprimer, vous pouvez le retirer du service actif en le récupérant. Dans ce cas, le brouillon de travail sera réinitialisé à la définition de workflow extraite. Tous les tickets en cours traités par le workflow extrait resteront actifs et ESM tentera de les traiter conformément à la définition de workflow extraite. Vous devez fermer manuellement les tickets s'ils ne se résolvent pas d'eux-mêmes. Les nouveaux tickets du modèle ne seront plus traités par le workflow extrait, mais devront être traités manuellement ou par un workflow de remplacement.

Cycle de vie du flux de travail

ESM garde la trace de plusieurs versions d'un même workflow :

• Un brouillon de travail qui est la dernière version que vous avez enregistrée.
• Le dernier flux de travail publié avec lequel les cartes de données nouvellement créées ou mises à jour seront traitées si elles répondent aux critères de sélection du flux de travail.
• Toutes les versions précédemment publiées des configurations de flux de travail tant que des cartes de données sont toujours en cours de traitement.

Lorsque vous ouvrez un workflow dans l'éditeur de workflows, vous travaillez par défaut sur la version préliminaire. Si vous choisissez d'extraire un workflow du service actif (c'est-à-dire d'annuler la publication), la version préliminaire du workflow sera réinitialisée à la version que vous venez d'extraire.

Les modifications apportées au brouillon ne sont pas automatiquement enregistrées dans la base de données. Il est conseillé de les enregistrer ou de les annuler avant toute autre action dans ESM.

Vous devez toujours publier vos modifications pour les activer pour les cartes de données nouvelles ou mises à jour. Lorsque vous publiez un workflow dans un service actif, cette version est automatiquement enregistrée comme nouveau brouillon de travail.

Vous pouvez supprimer des workflows d'ESM en cliquant sur le bouton Supprimer. Cependant, vous ne pouvez supprimer que les workflows qui ne contiennent aucune demande ouverte. Pour supprimer un workflow, les demandes doivent avoir parcouru toute la séquence de workflow ou avoir été clôturées par un utilisateur ESM. Vous ne pouvez pas supprimer manuellement les anciennes versions des configurations de workflow. Elles seront supprimées par le système lors du traitement de la dernière fiche de données.

L'extraction d'un workflow ne suffit pas à autoriser sa suppression, car des problèmes peuvent encore être en cours de traitement. ESM vérifiera toujours si des problèmes sont toujours en cours avant d'autoriser la suppression du workflow.

Exportation/Importation de Workflows

Tout workflow peut être exporté vers votre poste de travail, puis réimporté, par exemple vers un système de production. Pour exporter et importer des workflows, sélectionnez l'action correspondante dans le menu déroulant « Flux de travail ». N'oubliez pas d'exporter et d'importer également les modèles correspondants.

L'exportation exportera la dernière version publiée du workflow sélectionné. S'il n'existe aucune version publiée, le brouillon sera exporté.

Exportation/importation de nœuds de workflow

Il est possible d'exporter un nœud de workflow et de le réutiliser dans un autre workflow d'un autre modèle. Pour exporter un nœud de workflow, sélectionnez-le, puis choisissez « Exporter le nœud de workflow » dans le menu déroulant. Le nœud sera alors téléchargé sur votre ordinateur.

Pour importer un nœud de workflow, vous devez d'abord sélectionner le workflow vers lequel vous souhaitez l'importer. Les attributs et valeurs d'attributs ne correspondant pas au modèle cible seront remplacés par des champs vides après l'importation. La validation habituelle du workflow identifiera les corrections à apporter au nœud importé.

Vérification de l'état du flux de travail d'un problème

Le moteur de workflow gère l'état du workflow pour chaque problème. Cet état est visible dans la vue de la fiche de données du problème. Les états possibles sont : En cours d'exécution, Terminé, Erreur ou Annulé. L'état du workflow est une valeur système, mais peut être rendu visible en attribuant le WorkflowStatusHandler à un attribut.

Tous les utilisateurs peuvent annuler l’exécution du workflow manuellement en cliquant sur l’indicateur d’état du workflow.

Audit des configurations de flux de travail

ESM enregistre automatiquement les modifications apportées aux workflows dans le journal de configuration du système. La création, la suppression, la publication, la modification et l'extraction de nouveaux workflows sont enregistrées avec l'horodatage et l'identifiant utilisateur. Vous pouvez auditer les modifications apportées aux workflows depuis le journal de configuration.

Journalisation de l'exécution du flux de travail

Des entrées de journal sont générées pour chaque exécution de workflow afin de faciliter l'administration et le dépannage. Ces entrées sont enregistrées dans le fichier workflow.log. Pour télécharger ce fichier journal, accédez à Administration > Maintenance > Journaux > Télécharger les journaux . Vous trouverez ci-dessous un exemple d'enregistrement de l'exécution d'un nœud de workflow dans les journaux. Les sections en gras représentent les aspects clés du journal. Pour faciliter la consultation, l'extrait de journal est numéroté séquentiellement. Ces numéros correspondent à ceux de la capture d'écran du workflow concerné, fournie après l'extrait de journal.

1. WorkflowLogger|INFO|2023-03-22 10:12:12,123|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run workflow {id: 371441422, name: Checklist approval workflow NEW , templateId: 119733870, wrapperId: 366102831}
2. WorkflowLogger|INFO|2023-03-22 10:12:12,123|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running StartpointNode {id: 371440955, name: Begin}
3. WorkflowLogger|INFO|2023-03-22 10:12:12,273|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ConditionNode {id: 371441271, name: LOB SMB escalation or risk amount 1,5m}
4. WorkflowLogger|INFO|2023-03-22 10:12:12,275|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run then path:Then
5. WorkflowLogger|INFO|2023-03-22 10:12:12,430|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval }
WorkflowLogger|INFO|2023-03-29 13:46:25,469|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval}
WorkflowLogger|INFO|2023-03-29 13:49:40,790|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441119, name: LOB SMB Approval}
6. WorkflowLogger|INFO|2023-03-29 13:49:41,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441165, name: Credit Committee Approval }'
WorkflowLogger|INFO|2023-03-31 06:47:55,392|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ApprovalNode {id: 371441165, name: Credit Committee Approval}
7. WorkflowLogger|INFO|2023-03-31 06:47:56,496|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running EmailNode {id: 371441190, name: Notify onboarding team }
8. WorkflowLogger|INFO|2023-03-31 06:47:56,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running ConditionNode {id: 371440832, name: Check risk amount }
9. WorkflowLogger|INFO|2023-03-31 06:47:56,748|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} run then path:Then
10. WorkflowLogger|INFO|2023-03-31 06:47:56,892|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running WaitConditionNode {id: 371440854, name: Waiting for initial approval }
WorkflowLogger|INFO|2023-03-31 06:47:56,892|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} Conditions were not met. NodeId: WaitConditionNode{id='371440854', name='Waiting for initial approval', criteria=ConditionCollection[booleanOperator=AND,conditions=[SimpleCondition[operator=EQUAL_TO,leftOperand=AttributeOperand[groupAttributeId=119738157,ids=[371440842]],rightOperand=StaticValueOperand[value=StaticValueDTO[value=Initial approval,code=initial_approval,staticValueId=133859530],isOpen=false,id=371440844],id=371440847]],id=371440851]}. Workflow is pending for conditions of this node to be met before continuing.
11. WorkflowLogger|INFO|2023-03-31 08:53:03,606|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running WaitConditionNode {id: 371440854, name: Waiting for initial approval }
WorkflowLogger|INFO|2023-03-31 08:53:03,606|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} Conditions were met. NodeId: WaitConditionNode{id='371440854', name='Waiting for initial approval', criteria=ConditionCollection[booleanOperator=AND,conditions=[SimpleCondition[operator=EQUAL_TO,leftOperand=AttributeOperand[groupAttributeId=119738157,ids=[371440842]],rightOperand=StaticValueOperand[value=StaticValueDTO[value=Initial approval,code=initial_approval,staticValueId=133859530],isOpen=false,id=371440844],id=371440847]],id=371440851]}. Workflow proceeds.
12. WorkflowLogger|INFO|2023-03-31 08:53:03,883|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running SetValueNode {id: 371441300, name: Set decision to approved }
13. WorkflowLogger|INFO|2023-03-31 08:53:04,060|datacard {id: 123456789, name: Ticket name| EFE-123456, templateName: Agreement checklist} running EndpointNode {id: 371440960, name: Closed }

Exemple de flux de travail avec des références numérotées à l'extrait de journal de flux de travail :

Journalisation de l'exécution du flux de travail et des échecs d'enregistrement des cartes de données

Lorsqu'un écouteur ou un gestionnaire empêche le workflow d'enregistrer une carte de données, l'événement est consigné dans le fichier itsm.log plutôt que dans le journal du workflow. Les échecs de ce type sont consignés dans des entrées de journal qui se présentent généralement comme suit :

ErrorLogger|ERROR|2023-05-25 13:43:14,116|QuartzScheduler_Worker-3||Job (workflow.7548098#7546966#7546920#0 threw an exception.
org.quartz.SchedulerException: Job threw an unhandled exception. [See nested exception: com.bitmount.boas.exception.PersistenceException: com.efecte.datamodel.entity.action.FatalDataCardActionException: Data card save failed due to fail_card attribute having a value.]
at org.quartz.core.JobRunShell.run(JobRunShell.java:213)
at org.quartz.simpl.SimpleThreadPool$WorkerThread.run(SimpleThreadPool.java:573)
Caused by: com.bitmount.boas.exception.PersistenceException: com.efecte.datamodel.entity.action.FatalDataCardActionException: Data card save failed due to fail_card attribute having a value.

L'ID final de la première ligne indique le nœud de workflow spécifique où le processus s'arrête.

Dans le journal du workflow, la carte semble s'arrêter au nœud où l'échec de sauvegarde s'est produit. Cependant, dans l'interface utilisateur (IU), l'étape du workflow (affichée en haut à droite de la vue de la carte) indique qu'elle se trouve à un nœud précédent. Cette différence est due au fait que la carte revient en réalité au premier nœud « minuteur » ou « condition d'attente » précédant l'échec de sauvegarde.