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