Opi organisaation raportointipalvelun kehittäjän viitedokumentaatio

  • Artikkeli

Tässä artikkelissa annetaan tietoja kehittäjille ja pyytäjille, jotka toteuttavat Microsoft Learnin organisaatioraportointipalvelua. Suosittelemme myös tutustumaan Learnin organisaatiopalvelun parhaat käytännöt -artikkeliin, julkaisuhuomautukset ja usein kysyttyihin kysymyksiin , jotka tukevat kehitysmatkaasi.

Tietojen sanakirja

Vuokraajakohtaiset tietojoukot

Vuokraajakohtaiset tiedot tarjotaan Saavutukset-, Sertifioinnit-, Edistyminen- ja Käyttäjät-tietojoukoissa.

Tärkeä

userId Vuokraajakohtaisissa tiedoissa on Learn-profiilin käyttäjätunnus, joka on eri kuin Microsoft Entra ObjectId.

Progress-tietueiden saaminen displayName-ominaisuuden avulla vuokraajasi käyttäjille:

  • Liity omaan Microsoft Entra -tietoihisi objectId vuokraajakohtaisen Users-tietojoukon avulla AADObjectId
  • Vuokraajakohtaisen Käyttäjät-tietojoukonuserId yhdistäminen Edistyminen-kohtaan userId
  • Valitse omat Microsoft Entra -tietosi displayName ja soveltuvat edistymistiedot.

Kun lataat käyttäjätietoja Microsoft Entra -hallintakeskuksessa, vienti sisältää sekä displayName muita ominaisuuksia CSV-muodossa.

Saavutukset

Saavutukset-tietojoukko sisältää tietoja kaikista tämän vuokraajan käyttäjien ansaitsemista palkinnoista. Ne ovat yleensä moduulien ja oppimispolkujen suorittamisen tuloksia. Moduulin suorittamisen jälkeen käyttäjät saavat merkin ja oppimispolun suorittamisen jälkeen he ansaitsevat palkinnon.

Käyttäjän saavutukset näytetään reaaliaikaisessa sivustossa tarkastelemalla käyttäjän profiilia. (Esimerkki)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed Merkki learn.intro-to-compute.badge Moduuli learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Palkinto learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

Sertifioinnit

Sertifioinnit-tietojoukko sisältää tietoja kaikista tämän vuokraajan käyttäjien ansaitsemista sertifioinneista, jotka ovat edelleen aktiivisia tai vanhentuneet kahden viime vuoden aikana. Ne ovat yhden tai useamman kokeen suorittamisen tuloksia (sertifioinnin edellyttämällä tavalla).

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

Päivämäärä {int} arvot muotoillaan muodossa YYYYMMDD.

Edistyminen

Edistyminen-tietojoukko sisältää tietoja siitä, miten monta kokemuspistettä tämän vuokraajan käyttäjät ovat ansainneet sisältöosien (kuten yksittäisten yksiköiden, täysien moduulien ja oppimispolkujen) suorittamisesta. Kaikki sisältö ei ole yhtä suuri, joten käyttäjät voivat ansaita enemmän pisteitä, jos se sisältää vuorovaikutteisuutta, tai jos he suorittivat tietämyksen tarkistuksen 100 % ensimmäisellä kerralla.

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 Moduuli learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

Käyttäjät

Käyttäjät-tietojoukko sisältää tietoja kaikista käyttäjistä, joihin muissa vuokraajakohtaisissa tietojoukoissa on viitattu. Huomaa, että tämä tietojoukko ei sisällä PII-tietoja. userId on Learn-profiilin käyttäjätunnus, joka on eri kuin Microsoft Entra ObjectId (AADObjectId). Kun raportoit, sinun on liitettävä nämä tiedot Microsoft Entra -käyttäjien luetteloosi, jotta näet kokonaisvaltaisemman luettelon muiden tietojen käyttäjätiedoista.

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

Microsoft Learn -tietojoukot

Microsoft Learnin tiedot (jotka eivät koske yksittäistä vuokraajaa) kuuluvat tietojoukkoihin HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule ja HierarchyUnit.

HierarchyCertification

HierarchyCertification-tietojoukko sisältää luettelotietoja kaikista Microsoft Learnin sertifioinneista.

Saat lisätietoja sertifioineista ja siitä, miten ne liittyvät muihin sisältötyyppeihin, tutustu Sertifiointi-osioonOpi sisältötyypit -artikkelissa.

certificationUid type title Yhteenveto URL-osoite iconUrl levels products roolit exams
certification.azure-administrator 0 Microsoft-sertifiointi: Azure Administrator Associate Azure-järjestelmänvalvojat ottavat käyttöön, hallitsevat ja valvovat organisaation Microsoft Azure -ympäristöä. /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

HierarchyLearningPath-tietojoukko sisältää luettelotietoja kaikista Microsoft Learnin oppimispolusta.

Saat lisätietoja oppimispolusta ja siitä, miten ne liittyvät muihin sisältötyyppeihin, Tutustu sisältötyyppeihin -artikkelin Oppimispolut-osiosta.

LearningPathUid title URL-osoite durationInMinutes points iconUrl levels products roolit languages
learn.create-serverless-applications Palvelimettomien sovellusten luominen /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

HierarchyLearningPathModule-tietojoukko sisältää moduulien yhdistämisen oppimispolkuihin. (Huomautus: moduuli voi olla osa useita oppimispolkuja.)

Saat lisätietoja moduuleista ja oppimispolusta ja siitä, miten ne liittyvät muihin sisältötyyppeihin, Moduuli-osiosta ja Oppimispolku-osasta Opi sisältötyypit -artikkelista.

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

HierarchyModule

HierarchyModule-tietojoukko sisältää luettelotietoja kaikista moduuleista (kursseista).

Saat lisätietoja moduuleista ja siitä, miten ne liittyvät muihin sisältötyyppeihin, Tutustu sisältötyyppeihin -artikkelin Moduuli-osiosta.

moduleUid title URL-osoite iconUrl durationInMinutes points levels products roolit languages
learn.languages.powershell-write-first Write your first PowerShell code /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

HierarchyUnit-tietojoukko sisältää luettelotietoja kaikista yksiköistä (moduulien osia).

Saat lisätietoja yksiköistä ja siitä, miten ne liittyvät muihin sisältötyyppeihin, tutustu Opi sisältötyypit -artikkelin Yksiköt-osioon.

unitUid title URL-osoite durationInMinutes points moduleUid
learn.azure.query-data-sentinel.1-introduction Johdanto /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Exercise - Query and visualize data with Azure Sentinel Workbooks /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Seuraavat vaiheet

Tutustu alla oleviin resursseihin, jotka auttavat sinua kehitysmatkallasi: