Delen via

Referentiedocumentatie voor ontwikkelaars van Organisatierapportageservice

  • Artikel

Dit artikel bevat informatie voor ontwikkelaars en aanvragers die de Microsoft Learn-service voor organisatierapportage implementeren. We raden u ook aan het artikel Best practices voor de Learn-organisatieservice, opmerkingen bij de release en veelgestelde vragen te bekijken om uw ontwikkelingstraject te ondersteunen.

Gegevenswoordenboek

Tenantspecifieke gegevenssets

Tenantspecifieke gegevens worden geleverd door de gegevenssets Prestaties, Certificeringen, Voortgang en Gebruikers.

Belangrijk

De userId tenantspecifieke gegevens zijn de gebruikers-id van het Learn-profiel, die verschilt van de Microsoft Entra ObjectId.

Voortgangsrecords ophalen met displayName voor gebruikers in uw tenant:

  • Uw eigen Microsoft Entra-gegevens objectId samenvoegen met de tenantspecifieke gebruikersgegevenssetAADObjectId
  • De tenantspecifieke gebruikersgegevenssetuserId toevoegen aan de voortganguserId
  • Selecteer uw eigen Microsoft Entra-gegevens displayName en toepasselijke voortgangsgegevens.

Wanneer u gebruikersgegevens downloadt in het Microsoft Entra-beheercentrum, bevat displayName de export en andere eigenschappen in CSV-indeling.

Prestaties

De gegevensset Prestaties bevat informatie over alle beloningen die de gebruikers in deze tenant hebben verdiend, meestal door modules en leertrajecten te voltooien. Wanneer de module is voltooid, verdienen gebruikers een badge en na voltooiing van het leertraject verdienen ze een trofee.

Gebruikersprestaties worden weergegeven op de livesite door het profiel van een gebruiker weer te geven. (Voorbeeld)

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 Trofee learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

Toegepaste vaardigheden

De gegevensset Toegepaste vaardigheden bevat informatie over alle toegepaste vaardigheden die de gebruikers in deze tenant hebben verdiend, meestal als gevolg van het voltooien van labsessies. Wanneer de testsessie is voltooid, kunnen gebruikers een vaardigheid verdienen.

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: Een Azure AI Vision-oplossing bouwen {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: Samenwerkings-apps bouwen voor Microsoft Teams {datetime}

Certificeringen

De gegevensset Certificeringen bevat informatie over alle certificeringen die de gebruikers in deze tenant hebben verdiend en die nog steeds actief zijn of in de afgelopen twee jaar zijn verlopen, na voltooiing van een of meer examens (zoals vereist voor de certificering).

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

Datum {int} waarden worden opgemaakt als YYYYMMDD.

Voortgang

De gegevensset Voortgang bevat informatie over hoeveel XP-punten de gebruikers in deze tenant hebben verdiend door het voltooien van inhoudsonderdelen (zoals afzonderlijke eenheden, volledige modules en leertrajecten). Niet alle inhoud is gelijk, dus gebruikers kunnen meer punten verdienen als deze interactiviteit bevat of als ze de eerste keer een kennistoets hebben voltooid.

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Eenheid 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}

Gebruikers

De gegevensset Gebruikers bevat informatie van alle gebruikers waarnaar wordt verwezen in de andere tenantspecifieke gegevenssets. U ziet dat deze gegevensset geen PII-gegevens bevat. Dit userId is de gebruikers-id van het Learn-profiel, die verschilt van de Microsoft Entra ObjectId (AADObjectId). Wanneer u rapporteert, moet u deze gegevens toevoegen aan uw lijst met Microsoft Entra-gebruikers om een meer holistische lijst met gebruikersgegevens weer te geven op basis van de andere gegevens.

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

Microsoft Learn-gegevenssets

Microsoft Learn-gegevens (niet specifiek voor een afzonderlijke tenant) worden geleverd door de gegevensset HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule en HierarchyUnit.

HierarchyAppliedSkills

De gegevensset HierarchyAppliedSkills bevat catalogusinformatie over alle toegepaste vaardigheden in Microsoft Learn.

Bekijk de sectie Toegepaste vaardigheden in het artikel Learn-inhoudstypen voor meer informatie over toegepaste vaardigheden en hoe deze betrekking hebben op andere inhoudstypen.

appliedSkillsUid title URL Niveau Producten rollen Onderwerpen taken
applied-skill.build-azure-ai-vision-solution Een Azure AI Vision-oplossing bouwen /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["kunstmatige intelligentie"] ["Een Computer Vision-resource maken","Afbeeldingen analyseren","Een aangepast afbeeldingsanalysemodel maken","Het model trainen en evalueren","Een aangepast model gebruiken"]
applied-skill.build-collaborative-apps-microsoft-teams Samenwerkings-apps bouwen voor Microsoft Teams /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["intermediate"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["ontwikkelaar"] ["backend-development","frontend-development","custom-app-development"] ["Een bot bouwen","Een berichtextensie maken","Webhooks bouwen","Een Teams-tabblad maken","Microsoft Graph integreren in een Teams-app","Een Teams-app distribueren"]

HierarchyCertification

De gegevensset HierarchyCertification bevat catalogusinformatie over alle certificeringen in Microsoft Learn.

Zie de sectie Certificering in het artikel Learn-inhoudstypen voor meer informatie over certificeringen en hoe deze betrekking hebben op andere inhoudstypen.

certificationUid type title samenvatting URL iconUrl Niveau Producten rollen exams
certification.azure-administrator 0 Microsoft Certified: Azure Administrator Associate Azure-beheerders implementeren, beheren en bewaken de Microsoft Azure-omgeving van een organisatie. /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

De gegevensset HierarchyLearningPath bevat catalogusinformatie over alle leertrajecten op Microsoft Learn.

Bekijk de sectie Leertrajecten in het artikel Learn-inhoudstypen voor meer informatie over leertrajecten en hoe deze betrekking hebben op andere inhoudstypen.

LearningPathUid title URL durationInMinutes punten iconUrl Niveau Producten rollen Taal
learn.create-serverless-applications Serverloze toepassingen maken /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

De gegevensset HierarchyLearningPathModule bevat de toewijzing van modules aan leertrajecten. (Opmerking: een module kan deel uitmaken van meerdere leertrajecten.)

Voor meer informatie over modules en leertrajecten en hoe deze betrekking hebben op andere inhoudstypen, bekijkt u de sectie Module en het leertraject in het artikel Learn-inhoudstypen.

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

HierarchyModule

De gegevensset HierarchyModule bevat catalogusinformatie over alle modules (cursussen).

Bekijk de sectie Module in het artikel Learn-inhoudstypen voor meer informatie over modules en hoe deze betrekking hebben op andere inhoudstypen.

moduleUid title URL iconUrl durationInMinutes punten Niveau Producten rollen Taal
learn.languages.powershell-write-first Uw eerste PowerShell-code schrijven /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

De gegevensset HierarchyUnit bevat catalogusinformatie over alle eenheden (onderdelen van modules).

Bekijk de sectie Eenheden in het artikel Learn-inhoudstypen voor meer informatie over eenheden en hoe deze zich verhouden tot andere inhoudstypen.

unitUid title URL durationInMinutes punten moduleUid
learn.azure.query-data-sentinel.1-introduction Inleiding /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Oefening: een query uitvoeren en gegevens visualiseren met Azure Sentinel-werkmappen /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Volgende stappen

Bekijk de onderstaande bronnen om u te helpen bij uw ontwikkelingstraject: