Lär dig referensdokumentation för organisationsrapporteringstjänstens utvecklare
Den här artikeln innehåller information för utvecklare och begäranden som implementerar microsoft learn-tjänsten organisationsrapportering. Vi rekommenderar också att du går igenom artikeln om metodtips för learn-organisationstjänsten, viktig information och vanliga frågor som stöder din utvecklingsresa.
Dataordlista
Klientspecifika datauppsättningar
Klientspecifika data tillhandahålls av datauppsättningarna Achievements, Certifications, Progress och Users.
Viktigt!
I userId
klientspecifika data finns användaridentifieraren för Learn-profilen, som skiljer sig från Microsoft Entra ObjectId.
Så här hämtar du förloppsposter med displayName för användare i din klientorganisation:
- Ansluta dina egna Microsoft Entra-data
objectId
till den klientspecifika datauppsättningen AnvändareAADObjectId
- Anslut den klientspecifika datauppsättningen
userId
Användare till förloppetuserId
- Välj dina egna Microsoft Entra-data
displayName
och tillämpliga förloppsdata.
När du laddar ned användarinformation i administrationscentret för Microsoft Entra kommer exporten att innehålla displayName
och andra egenskaper i CSV-format.
Achievements
Datauppsättningen Achievements innehåller information om alla utmärkelser som användarna i den här klientorganisationen har fått, vanligtvis som ett resultat av att moduler och utbildningsvägar har slutförts. När modulen är klar får användarna ett märke och när utbildningsvägen har slutförts får de en trofé.
Användarprestationer visas på livewebbplatsen genom att visa en användares profil. (Exempel)
tenantId | Användar-ID | awardReason | awardType | awardUid | SourceType | SourceUid | AwardedOn |
---|---|---|---|---|---|---|---|
{guid} | {guid} | badge.module.basic.completed | Märke | learn.intro-to-compute.badge | Modul | learn.intro-to-compute | {datetimeoffset} |
{guid} | {guid} | trophy.path.basic.completed | Trofé | learn.cloud-foundations.trophy | LearningPath | learn.cloud-foundations | {datetimeoffset} |
Tillämpade färdigheter
Datauppsättningen Tillämpad kompetens innehåller information om alla tillämpade färdigheter som användarna i den här klientorganisationen har tjänat in, vanligtvis som ett resultat av att du slutfört labbsessioner. När labbsessionen har slutförts kan användarna få en färdighet.
tenantId | Användar-ID | appliedSkillsUid | labProfileName | examScoredDate |
---|---|---|---|---|
{guid} | {guid} | applied-skill.build-azure-ai-vision-solution | APL-3004: Skapa en Azure AI Vision-lösning | {datetime} |
{guid} | {guid} | applied-skill.build-collaborative-apps-microsoft-teams | APL-4001: Skapa samarbetsappar för Microsoft Teams | {datetime} |
Certifieringar
Datauppsättningen Certifications innehåller information om alla certifieringar som användarna i den här klientorganisationen har tjänat som fortfarande är aktiva eller som har upphört att gälla under de senaste två åren, som ett resultat av att ha slutfört ett eller flera prov (som krävs för certifieringen).
tenantID | Användar-ID | AwardType | TranscriptName | SourceUid | AwardedOn | CertificationStartDate | CertificationEndDate | StayCurrentEligibilityStartDate |
---|---|---|---|---|---|---|---|---|
{guid} | {guid} | Certifiering | Microsoft Certified: Azure AI Engineer Associate | certification.azure-ai-engineer | {int} | {int} | {int} | {int} |
{guid} | {guid} | Certifiering | Microsoft Certified: Grunderna i Microsoft Power Platform | certification.power-platform-fundamentals | {int} | {int} | {int} | {int} |
Datum {int} värden formateras som YYYYMMDD
.
Förlopp
Datauppsättningen Progress innehåller information om hur många XP-poäng som användarna i den här klientorganisationen har tjänat på att slutföra delar av innehållet (till exempel enskilda enheter, fullständiga moduler och utbildningsvägar). Allt innehåll är inte lika med, så användarna kan tjäna fler poäng om det innehåller interaktivitet, eller om de har slutfört en kunskapskontroll 100 % första gången.
tenantId | Användar-ID | XPReason | SourceType | SourceUid | XP | AwardedOn |
---|---|---|---|---|---|---|
{guid} | {guid} | points.unit.basic.completed | Enhet | learn.intro-to-compute.1-introduction | 100 | {datetimeoffset} |
{guid} | {guid} | points.module.basic.completed | Modul | learn.create-azure-account | 200 | {datetimeoffset} |
{guid} | {guid} | points.path.basic.completed | LearningPath | learn.cloud-foundations | 2100 | {datetimeoffset} |
Användare
Datauppsättningen Users innehåller information om alla användare som refereras till i de andra klientspecifika datauppsättningarna. Observera att den här datamängden inte innehåller någon PII-information. userId
är användaridentifieraren för Learn-profilen, som skiljer sig från Microsoft Entra ObjectId (AADObjectId
). När du rapporterar måste du ansluta dessa data till din lista över Microsoft Entra-användare för att se en mer holistisk lista över användarinformation mot andra data.
tenantId | Användar-ID | AADObjectId | CreatedOn |
---|---|---|---|
{guid} | {guid} | {guid} | {datetime} |
Microsoft Learn-datauppsättningar
Microsoft Learn-data (inte specifika för en enskild klientorganisation) tillhandahålls av datauppsättningarna HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule och HierarchyUnit .
HierarchyAppliedSkills
Datamängden HierarchyAppliedSkills innehåller kataloginformation om alla tillämpade kunskaper i Microsoft Learn.
Mer information om tillämpade kunskaper och hur de relaterar till andra innehållstyper finns i avsnittet Tillämpade kunskaper i artikeln Learn content types (Lär dig innehållstyper).
appliedSkillsUid | rubrik | URL | nivåer | produkter | roller | Ämnen | uppgifter |
---|---|---|---|---|---|---|---|
applied-skill.build-azure-ai-vision-solution | Skapa en Azure AI Vision-lösning | /credentials/applied-skills/build-azure-ai-vision-solution/ | ["intermediate"] | ["azure-computer-vision"] | ["developer","ai-engineer","maker"] | ["artificiell intelligens"] | ["Create a computer vision resource","Analyze images","Create a custom image analysis model","Train and evaluate the model","Consume a custom model"] |
applied-skill.build-collaborative-apps-microsoft-teams | Skapa samarbetsappar för Microsoft Teams | /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ | ["intermediate"] | ["office-teams","ms-graph","entra-id","ms-copilot"] | ["utvecklare"] | ["backend-development","frontend-development","custom-app-development"] | ["Build a bot","Create a messaging extension","Build webhooks","Create a Teams tab","Integrate Microsoft Graph into a Teams app","Distribute a Teams app"] |
HierarchyCertification
Datauppsättningen HierarchyCertification innehåller kataloginformation om alla certifieringar i Microsoft Learn.
Mer information om certifieringar och hur de relaterar till andra innehållstyper finns i avsnittet Certifiering i artikeln Learn content types (Lär dig innehållstyper).
certificationUid | type | rubrik | Sammanfattning | URL | iconUrl | nivåer | produkter | roller | prov |
---|---|---|---|---|---|---|---|---|---|
certification.azure-administrator | 0 | Microsoft-certifierad: Azure-administratörsassistenter | Azure-administratörer implementerar, hanterar och övervakar en organisations Microsoft Azure-miljö. | /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
Datauppsättningen HierarchyLearningPath innehåller kataloginformation om alla utbildningsvägar i Microsoft Learn.
Mer information om utbildningsvägar och hur de relaterar till andra innehållstyper finns i avsnittet Utbildningsvägar i artikeln Learn content types (Lär dig innehållstyper).
LearningPathUid | rubrik | URL | durationInMinutes | points | iconUrl | nivåer | produkter | roller | språk |
---|---|---|---|---|---|---|---|---|---|
learn.create-serverless-applications | Skapa serverlösa program | /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
Datauppsättningen HierarchyLearningPathModule innehåller mappning av moduler till utbildningsvägar. (Obs! En modul kan vara en del av flera utbildningsvägar.)
Om du vill veta mer om moduler och utbildningsvägar och hur de relaterar till andra innehållstyper kan du läsa avsnittet Modul och Utbildningsväg i artikeln Lär dig innehållstyper.
LearningPathUid | ModuleUid |
---|---|
learn.security-ops-sentinel | azure.query-data-sentinel |
learn.architect-data-platform | learn.access-data-with-cosmos-db-and-sql-api |
HierarchyModule
Datauppsättningen HierarchyModule innehåller kataloginformation om alla moduler (kurser).
Mer information om moduler och hur de relaterar till andra innehållstyper finns i avsnittet Modul i artikeln Learn content types (Lär dig innehållstyper).
moduleUid | rubrik | URL | iconUrl | durationInMinutes | points | nivåer | produkter | roller | språk |
---|---|---|---|---|---|---|---|---|---|
learn.languages.powershell-write-first | Skriv din första PowerShell-kod | /training/modules/powershell-write-first/ | /training/achievements/powershell/powershell-write-first-code.svg | 17 | 200 | ["beginner"] | ["dotnet"] | ["developer","student"] | ["powershell"] |
HierarchyUnit
Datauppsättningen HierarchyUnit innehåller kataloginformation om alla enheter (moduler).
Mer information om enheter och hur de relaterar till andra innehållstyper finns i avsnittet Enheter i artikeln Learn content types (Lär dig innehållstyper).
unitUid | rubrik | URL | durationInMinutes | points | moduleUid |
---|---|---|---|---|---|
learn.azure.query-data-sentinel.1-introduction | Introduktion | /training/modules/query-data-sentinel/1-introduction/ | 5 | 100 | azure.query-data-sentinel |
learn.azure.query-data-sentinel.2-exercise-setup | Övning – Fråga efter och visualisera data med Azure Sentinel-arbetsböcker | /training/modules/query-data-sentinel/2-exercise-setup/ | 10 | 100 | azure.query-data-sentinel |
Nästa steg
Granska resurserna nedan för att hjälpa dig med din utvecklingsresa: