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 progressionuserId
- 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 :