Jaa

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-tietojoukon userId 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}

Sovelletun osaamisen valmiude

Käytössä olevat taidot -tietojoukko sisältää tietoja kaikista käytössä olevista taidoista, jotka tämän vuokraajan käyttäjät ovat ansainneet, mikä on yleensä labratöiden suorittamisen tuloksena. 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).

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 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 CreatedOn
{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 title 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"]

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-osioon Opi sisältötyypit -artikkelissa.

certificationUid tyyppi title Yhteenveto URL-osoite iconUrl tasoilla tuotteet 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 tasoilla tuotteet roolit kielet
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 tasoilla tuotteet roolit kielet
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 Esittely /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: