Contrôle de version des workflows de cycle de vie

Les workflows créés à l’aide de workflows de cycle de vie peuvent être mis à jour en fonction des besoins de l’organisation en termes d’audit du cycle de vie des utilisateurs de votre organisation. Pour gérer les mises à jour dans les workflows, les workflows de cycle de vie introduisent le concept de contrôle de version de workflow. Les versions de workflow sont de nouvelles versions de workflows existants, déclenchées par la mise à jour des conditions d’exécution ou des tâches associées. Les versions de workflow peuvent modifier les actions ou même l’étendue d’un workflow existant. Comprendre comment le contrôle de version de workflow est géré pendant le processus de mise à jour du workflow vous permet de configurer stratégiquement des workflows afin que les tâches et les conditions de workflow soient toujours pertinentes pour les utilisateurs traités par un workflow.

Avantages du contrôle de version

Le contrôle de version avec les workflows de cycle de vie offre de nombreux avantages sur la création d’un workflow pour chaque cas d’usage. Ces avantages se retrouvent dans sa capacité à améliorer le processus de création de rapports pour la résolution des problèmes et la conservation des enregistrements des manières suivantes :

• Rétention à long terme : le contrôle de version permet une conservation plus longue des informations de workflow qu’en utilisant uniquement les journaux d’audit. Bien que les journaux d’audit stockent uniquement les informations des 30 jours précédents, avec le contrôle de version, vous pouvez suivre les détails du workflow à partir de la création.
• Traçabilité : autorise le suivi de la version spécifique d’un workflow qui a traité un utilisateur.

Propriétés et versions du workflow

Bien que les mises à jour des workflows puissent déclencher la création d’une nouvelle version, cela n’est pas toujours le cas. Il existe des paramètres de workflow, appelés propriétés de base, qui sont modifiables sans créer de nouvelle version du workflow. La liste de ces paramètres est la suivante :

• displayName
• description
• isEnabled
• IsSchedulingEnabled
• Nom de la tâche
• description de la tâche

Vous allez trouver les paramètres correspondants dans le Centre d’administration Microsoft Entra sous la section Propriétés du workflow que vous mettez à jour.

Pour obtenir un guide pas à pas sur la mise à jour de ces propriétés à l’aide du Centre d’administration Microsoft Entra et de l’API par Microsoft Graph, consultez Gérer les propriétés de workflow.

Les propriétés qui déclenchent la création d’une nouvelle version sont les suivantes :

• tâches
• executionConditions

Bien que de nouvelles versions de ces workflows soient créées dès que vous effectuez les mises à jour dans le Centre d’administration Microsoft Entra, la création d’une nouvelle version d’un workflow à l’aide de l’API avec Microsoft Graph nécessite d’exécuter la méthode createNewVersion. Pour obtenir un guide pas à pas pour mettre à jour des tâches ou des conditions d’exécution, consultez Gérer les versions de workflow.

Notes

Si le workflow est à la demande, les informations de configuration associées aux conditions d’exécution ne sont pas présentes.

Détails contenus dans l’historique des versions du workflow

Contrairement à la modification des propriétés de base d’un workflow, les versions de workflow nouvellement créées peuvent être très différentes des versions précédentes. Des tâches peuvent être ajoutées ou supprimées, et les exécutions du workflow peuvent être différentes. En raison des grandes modifications qui peuvent se produire dans un workflow entre différentes versions, les détails de la version sont également là pour fournir des informations détaillées sur la version actuelle du workflow et ses itérations précédentes.

Détails contenus dans les informations de version, comme indiqué dans le Centre d’administration Microsoft Entra :

Les informations de version détaillées sont les suivantes :

paramètre	description
Numéro de version	Entier indiquant la version du workflow à laquelle les informations sont destinées. Passe de façon séquentielle à chaque nouvelle version du workflow.
Date de dernière modification	Heure de la dernière mise à jour du workflow. Pour les versions précédentes des workflows, la date de dernière modification est toujours l’heure à laquelle la version suivante a été créée.
Auteur de la dernière modification	Qui a modifié la dernière version de ce workflow.
Date de création	Date et heure de création d’une version de workflow.
Créé par	Qui a créé cette version spécifique du workflow.
Nom	Nom du workflow pour cette version.
Description	Description du workflow pour cette version.
Category	Catégorie du workflow.
Conditions d’exécution	Définit pour qui et quand le workflow s’exécute dans cette version.
Tâches	Tâches présentes dans cette version de workflow. Si vous affichez l’API, vous pouvez également voir les arguments de tâche. Pour accéder aux définitions spécifiques des tâches, consultez Tâches et définitions des workflows de cycle de vie.

Étapes suivantes

• Type de ressource workflowVersion
• Gérer les propriétés de workflow
• Gérer les versions des workflows