Vue d’ensemble de l’API de création de rapports de workflow de cycle de
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Les workflows de cycle de vie proposent des rapports qui permettent aux organisations d’obtenir des informations sur la façon dont les workflows de cycle de vie ont été traités pour les utilisateurs de votre organization.
Remarque
Cet article explique comment exporter des données personnelles à partir d’un appareil ou d’un service. Ces étapes peuvent être utilisées pour prendre en charge vos obligations en vertu du Règlement général sur la protection des données (RGPD). Les administrateurs de locataires autorisés peuvent utiliser Microsoft Graph pour corriger, mettre à jour ou supprimer des informations d’identification sur les utilisateurs finaux, y compris les profils utilisateur des clients et des employés ou les données personnelles, telles que le nom, la fonction professionnelle, l’adresse ou le numéro de téléphone d’un utilisateur, dans votre environnement de Microsoft Entra ID.
L’API des workflows de cycle de vie est définie dans le sous-espace de nom OData, microsoft.graph.identityGovernance.
Éléments clés des rapports de workflows de cycle de vie
| Fonctionnalité de création de rapports | Description |
|---|---|
| Résultat du traitement par l’utilisateur | Résultat d’un workflow de cycle de vie qui a été exécuté pour un utilisateur spécifique. Le résultat est une agrégation de tous les résultats de traitement des tâches de flux de travail qui faisaient partie du workflow de cycle de vie et qui étaient exécutées pour l’utilisateur spécifique. |
| Résultat du traitement de la tâche | Résultat d’une tâche de flux de travail exécutée pour un utilisateur spécifique. |
| Exécution du flux de travail | Résultat d’un workflow de cycle de vie qui a été exécuté pour une collection d’utilisateurs. Le résultat est une agrégation de tous les résultats de traitement utilisateur des utilisateurs qui ont été traités dans un intervalle ou qui faisaient partie d’une exécution à la demande. |
| Rapport de tâche | Agrégation des résultats du traitement des tâches pour une tâche de flux de travail spécifique au sein d’une exécution de workflow. Avec ce rapport, l’intégrité status d’une tâche de flux de travail dans une exécution de workflow peut être facilement déterminée et la source d’erreur peut donc être identifiée plus rapidement en cas d’échec de l’exécution d’un workflow. |
Workflows de cycle de vie dans les journaux d’audit
Tous les événements exécutés dans les workflows de cycle de vie sont enregistrés par Microsoft Entra ID. Il s’agit notamment de la création, de la mise à jour, de la suppression ou de l’exécution de workflows et de l’attribution d’autorisations aux applications.
Ces journaux auditables sont représentés par le type de ressource directoryAudit et ses méthodes GET associées dans Microsoft Graph.
Vérifications des licences
L’utilisation de cette fonctionnalité nécessite Gouvernance Microsoft Entra ID licences. Pour trouver la licence adaptée à vos besoins, consultez Comparer les fonctionnalités généralement disponibles de Micorosft Microsoft Entra ID.
Vérifications de l’autorisation des rôles et des autorisations d’application
Les rôles Microsoft Entra suivants sont requis pour qu’un utilisateur appelant lise les rapports dans les workflows de cycle de vie.
| Opération | Autorisations de l’application | Rôle d’annuaire requis de l’utilisateur appelant |
|---|---|---|
| Lecture | LifecycleWorkflows.Read.All ou LifecycleWorkflows.ReadWrite.All | Lecteur global ou administrateur de flux de vie |
| Créer, mettre à jour ou supprimer | LifecycleWorkflows.ReadWrite.All | Administrateur de workflows de cycle de vie |