Jaa


Opi organisaation raportointipalvelun kehittäjän viitedokumentaatio

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 ovat Achievements-, AppliedSkills-, Certifications-, Progress- ja Users-tietojoukkojen tarjoamia.

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 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 Lähdetyyppi SourceUid Saaja
{guid} {guid} badge.module.basic.completed Merkki learn.intro-to-compute.merkki Moduuli learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Palkinto learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

AppliedSkills

AppliedSkills-tietojoukko sisältää tietoja kaikista käytössä olevista taidoista, jotka tämän vuokraajan käyttäjät ovat hankkineet. Yleensä tämä johtuu laboratorioistuntojen suorittamisesta. Onnistuneen labratyöistunnon suorittamisen jälkeen käyttäjät saattavat ansaita osaamista.

tenantId userId appliedSkillsUid labProfileName ExamScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: Azure AI Vision -ratkaisun luominen {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: yhteistyösovellusten luominen Microsoft Teamsille {datetime}

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).

vuokraajan tunnus userId AwardType Tallennenimi SourceUid Saaja Sertifioinnin aloituspäivämäärä Sertifioinnin päivämäärä StayCurrentEligibilityStartDate
{guid} {guid} Sertifiointi Microsoft-sertifiointi: Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Sertifiointi Microsoft-sertifiointi: 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 Lähdetyyppi SourceUid XP Saaja
{guid} {guid} points.unit.basic.completed Yksikkö 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 Luotu
{guid} {guid} {guid} {datetime}

Microsoft Learn -tietojoukot

Microsoft Learnin tiedot (jotka eivät koske vain yksittäistä vuokraajaa) ovat hierarkiasovellussovellusliittymät, hierarkiasertifiointi, hierarkianlearningpath, hierarkianlearningpathmodule, hierarchymodule ja hierarchyunit-tietojoukot.

HierarchyAppliedSkills

HierarchyAppliedSkills-tietojoukko sisältää luettelotietoja kaikista Microsoft Learnin käytössä olevia taitoja koskevista taidoista.

Saat lisätietoja käytetyistä taidoista ja siitä, miten ne liittyvät muihin sisältötyyppeihin, Tutustu sisältötyyppeihin -artikkelin Käytössä olevat taidot -osiosta.

appliedSkillsUid otsikko URL-osoite tasoilla tuotteet roolit Aiheita Tehtävät
applied-skill.build-azure-ai-vision-solution Luo Azure AI Vision -ratkaisu /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["tekoäly"] ["Luo tietokonenäköresurssi","Analysoi kuvia","Luo mukautettu kuva-analyysimalli","Harjoita ja arvioi mallia","Mukautetun mallin käyttäminen"]
applied-skill.build-collaborative-apps-microsoft-teams Yhteistyösovellusten luominen Microsoft Teamsille /tunnistetiedot/applied-skills/build-collaborative-apps-microsoft-teams/ ["intermediate"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["developer"] ["backend-development","frontend-development","custom-app-development"] ["Rakenna botti","Luo viestilaajennus","Luo webhookit","Luo Teams-välilehti","Integroi Microsoft Graph Teams-sovellukseen","Teams-sovelluksen jakaminen"]

HierarkiaSertifiointi

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 tyyppi otsikko yhteenveto URL-osoite iconUrl tasoilla tuotteet roolit Tentit
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öä. /sertifioinnit/azure-järjestelmänvalvoja/ /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"] ["järjestelmänvalvoja"] ["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 otsikko URL-osoite durationInMinutes Pistettä iconUrl tasoilla tuotteet roolit kielet
learn.create-serverless-applications Palvelimettomien sovellusten luominen /koulutus/polut/create-serverless-applications/ 517 1925 /koulutus/saavutukset/create-serverless-applications.svg ["aloittelija","keskitason"] ["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 otsikko URL-osoite iconUrl durationInMinutes Pistettä tasoilla tuotteet roolit kielet
learn.languages.powershell-write-first Ensimmäisen PowerShell-koodin kirjoittaminen /koulutus/moduulit/powershell-write-first/ /koulutus/saavutukset/powershell/powershell-write-first-code.svg 17 200 ["aloittelija"] ["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 otsikko URL-osoite durationInMinutes Pistettä moduleUid
learn.azure.query-data-sentinel.1-introduction Esittely /koulutus/moduulit/kysely-data-sentinel/1-esittely/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Harjoitus – Tietojen kysely ja visualisointi Azure Sentinel -työkirjoilla /koulutus/moduulit/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Seuraavat vaiheet

Tutustu alla oleviin resursseihin, jotka auttavat sinua kehitysmatkallasi: