Partager via


Documentation de référence pour les développeurs sur le service Rapports organisationnels Learn

Cet article fournit des informations pour les développeurs et les demandeurs qui implémentent le service Rapports organisationnels Microsoft Learn. Nous vous recommandons également de consulter l’article sur les meilleures pratiques, les notes de publication et les questions fréquentes (FAQ) en lien avec le service Rapports organisationnels Learn pour faciliter votre parcours de développement.

Dictionnaire de données

Jeux de données spécifiques du locataire

Les données spécifiques du locataire sont fournies par les jeux de données Achievements, Certifications, Progress et Users.

Important

Le userId dans les données spécifiques au tenant est l’identificateur d’utilisateur du profil Learn qui est différent de ObjectId Microsoft Entra.

Pour obtenir des enregistrements de progression avec displayName pour les utilisateurs de votre locataire :

  • Joignez vos propres données Microsoft Entra objectId au jeu de données des utilisateursAADObjectId spécifique au tenant
  • Joindre le jeu de données Utilisateurs userId spécifique au locataire à la progression userId
  • Sélectionnez vos propres données Microsoft Entra displayName et données de progression applicables.

Lorsque vous Télécharger les informations d’utilisateurs dans le centre d’administration Microsoft Entra, l’exportation inclut displayName et d’autres propriétés au format CSV.

Succès

Le jeu de données Achievements contient des informations sur toutes les récompenses que les utilisateurs de ce locataire ont gagnées, généralement à la suite de l’accomplissement de modules et de parcours d’apprentissage. À l’issue d’un module, les utilisateurs gagnent un badge et, à l’issue du parcours d’apprentissage, ils gagnent un trophée.

Les accomplissements d’un utilisateur sont affichés dans son profil sur le site actif. (Exemple)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed Badge learn.intro-to-compute.badge Module learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Trophée learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

Compétences appliquées

Le jeu de données compétences appliquées contient des informations sur toutes les compétences appliquées que les utilisateurs de ce locataire ont obtenu, généralement en raison de la fin des sessions de laboratoire. Une fois la session de laboratoire terminée, les utilisateurs peuvent acquérir une compétence.

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004 : Créer une solution Azure AI Vision {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001 : Créer des applications collaboratives pour Microsoft Teams {datetime}

Certifications

Le jeu de données Certifications contient des informations sur toutes les certifications que les utilisateurs de ce locataire ont obtenues qui sont toujours actives ou qui ont expiré au cours des deux dernières années, suite à l’achèvement d’un ou plusieurs examens (comme requis pour la certification).

tenantID userId AwardType TranscriptName SourceUid AwardedOn CertificationStartDate CertificationEndDate StayCurrentEligibilityStartDate
{guid} {guid} Certification Microsoft Certified : Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Certification Microsoft Certified: Power Platform Fundamentals certification.power-platform-fundamentals {int} {int} {int} {int}

Les valeurs {int} de date sont au format YYYYMMDD.

Avancement

Le jeu de données Progress contient des informations sur le nombre de points XP que les utilisateurs de ce locataire ont gagnés suite à l’accomplissement d’éléments de contenu (tels que des unités individuelles, des modules complets, des parcours d’apprentissage). Les éléments de contenu ne se valent pas tous. Les utilisateurs peuvent gagner plus de points si l’élément de contenu contient une interactivité, ou s’ils ont répondu à 100 % à un contrôle des connaissances la première fois.

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Unité learn.intro-to-compute.1-introduction 100 {datetimeoffset}
{guid} {guid} points.module.basic.completed Module learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

Utilisateurs

Le jeu de données Users contient des informations sur tous les utilisateurs référencés dans les autres jeux de données spécifiques du locataire. Notez que ce jeu de données ne contient aucune information d’identification personnelle. Le userId est l’identificateur d’utilisateur du profil Learn qui est différent de ObjectId Microsoft Entra (AADObjectId). Lorsque vous créez des rapports, vous devez joindre ces données à votre liste d’utilisateurs Microsoft Entra pour afficher une liste plus globale des informations d’utilisateurs par rapport aux autres données.

tenantId userId AADObjectId CreatedOn
{guid} {guid} {guid} {datetime}

Jeux de données Microsoft Learn

Les données Microsoft Learn (non spécifiques à un locataire individuel) sont fournies par les jeux de données HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModuleet HierarchyUnit.

HierarchyAppliedSkills

Le jeu de données HierarchyAppliedSkills contient des informations de catalogue sur toutes les compétences appliquées dans Microsoft Learn.

Pour en savoir plus sur les compétences appliquées et leur relation avec d’autres types de contenu, consultez la section Compétences appliquées dans l’article Découvrir les types de contenu.

appliedSkillsUid title url niveaux products roles sujets tasks
applied-skill.build-azure-ai-vision-solution Créer une solution Azure AI Vision /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["artificial-intelligence"] ["Créer une ressource vision par ordinateur","Analyser des images","Créer un modèle d’analyse d’image personnalisé","Entraîner et évaluer le modèle","Consommer un modèle personnalisé"]
applied-skill.build-collaborative-apps-microsoft-teams Créer des applications collaboratives pour Microsoft Teams /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["intermediate"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["developer"] ["backend-development","frontend-development","custom-app-development"] ["Créer un bot","Créer une extension de messagerie","Créer des webhooks","Créer un onglet Teams","Intégrer Microsoft Graph dans une application Teams","Distribuer une application Teams"]

HierarchyCertification

Le jeu de données HierarchyCertification contient des informations de catalogue sur toutes les certifications dans Microsoft Learn.

Pour en savoir plus sur les certifications et leur lien avec d’autres types de contenu, consultez la section Certification de l’article Types de contenu Learn.

certificationUid type title Récapitulatif url iconUrl niveaux products roles exams
certification.azure-administrator 0 Microsoft Certified : Azure Administrator Associate Les administrateurs Azure sont chargés de mettre en œuvre, de gérer et de surveiller l’environnement Microsoft Azure d’une organisation. /certifications/azure-administrator/ /media/learn/certification/badges/microsoft-certified-associate-badge.svg ["intermediate"] ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] ["administrator"] ["exam.az-104"]

HierarchyLearningPath

Le jeu de données HierarchyLearningPath contient des informations de catalogue sur tous les parcours d’apprentissage dans Microsoft Learn.

Pour en savoir plus sur les parcours d’apprentissage et leur lien avec d’autres types de contenu, consultez la section Parcours d’apprentissage de l’article Types de contenu Learn.

LearningPathUid title url durationInMinutes points iconUrl niveaux products roles languages
learn.create-serverless-applications Créer des applications serverless /training/paths/create-serverless-applications/ 517 1925 /training/achievements/create-serverless-applications.svg ["beginner","intermediate"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["developer","student"] ["powershell"]

HierarchyLearningPathModule

Le jeu de données HierarchyLearningPathModule contient le mappage des modules aux parcours d’apprentissage. (Remarque : un module peut faire partie de plusieurs parcours d’apprentissage.)

Pour en savoir plus sur les modules et les parcours d’apprentissage et leur lien avec d’autres types de contenu, consultez la section Modules et la section Parcours d’apprentissage dans l’article Types de contenu Learn.

LearningPathUid ModuleUid
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

HierarchyModule

Le jeu de données HierarchyModule contient des informations de catalogue sur tous les modules (cours).

Pour en savoir plus sur les modules et leur lien avec d’autres types de contenu, consultez la section Modules de l’article Types de contenu Learn.

moduleUid title url iconUrl durationInMinutes points niveaux products roles languages
learn.languages.powershell-write-first Écrire vos premières lignes de code PowerShell /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

Le jeu de données HierarchyUnit contient des informations de catalogue sur toutes les unités (éléments de modules).

Pour en savoir plus sur les unités et leur lien avec d’autres types de contenu, consultez la section Unités de l’article Types de contenu Learn.

unitUid title url durationInMinutes points moduleUid
learn.azure.query-data-sentinel.1-introduction Introduction /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Exercice - Interroger et visualiser des données avec des workbooks Azure Sentinel /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Étapes suivantes

Consultez revue les ressources ci-dessous pour vous faciliter votre parcours de développement :