Naučte sa používať referenčnú dokumentáciu pre vývojárov služby Organizational Reporting Service

Tento článok poskytuje informácie pre vývojárov a žiadateľov o implementáciu služby Organizational Reporting na lokalite Microsoft Learn. Odporúčame vám tiež prečítať si článok Osvedčené postupy organizačnej služby Learn, Poznámky k vydaniu a Najčastejšie otázky na podporu vašej cesty vývoja.

Slovník údajov

Množiny údajov špecifické pre nájomníka

Údaje špecifické pre nájomníka sa poskytujú v množinách údajov Úspechy, Certifikácie, Priebeh a Používatelia .

Dôležité

V údajoch špecifických pre nájomníka userId je identifikátor používateľa profilu Learn, ktorý sa líši od identifikátora Microsoft Entra ObjectId.

Ak chcete získať záznamy o priebehu pomocou položky displayName pre používateľov vo vašom nájomníkovi:

  • Pripojte sa k vlastným údajom objectId služby Microsoft Entra k množine údajov Používateľov špecifických pre nájomníka . AADObjectId
  • Pripojte sa k množine userId údajov Používateľov určenej pre nájomníka k postupu userId
  • Vyberte vlastné údaje displayName spoločnosti Microsoft Entra a príslušné údaje o pokroku.

Keď v Centre spravovania služby Microsoft Entra stiahnete podrobnosti o používateľovi, export bude obsahovať displayName aj ďalšie vlastnosti vo formáte CSV.

Odmeny

Množina údajov o úspechoch obsahuje informácie o všetkých odmenách, ktoré používatelia v tomto nájomníkovi získali, zvyčajne v dôsledku dokončenia modulov a študijných kurzov. Po dokončení modulu používatelia získajú odznak a po dokončení študijného programu získajú trofej.

Používateľské úspechy sa zobrazujú na živej lokalite zobrazením používateľského profilu. (príklad)

tenantId userId awardReason awardType (typ ocenenia) zadanie identifikátora SourceType (Typ Zdroja) Id zdroja Ocenenie Zadané
{guid} {guid} badge.module.basic.completed Štítok learn.intro-to-compute.badge Modul learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Trofej trofej learn.cloud-foundations.trophy Vzdelávanie Path learn.cloud-foundations {datetimeoffset}

Certifikácie

Množina údajov Certifikácie obsahuje informácie o všetkých certifikáciách, ktoré používatelia v tomto nájomníkovi získali, ktoré boli stále aktívne alebo ktorých platnosť uplynula za posledné dva roky, v dôsledku toho, že sa vykonali jedno alebo viac skúšok (podľa potreby pre certifikáciu).

TENANTID (ID nájomníka) userId AwardType (Typ ocenenia) Názov prepisu Id zdroja Ocenenie Zadané CertificationStartDate (Dátum Začatia certifikácie) CertificationEndDate (DátumS certifikácie) StayCurrentEligibilityStartDate
{guid} {guid} Certifikácia Certifikované spoločnosťou Microsoft: Azure AI inžinier Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Certifikácia Certifikované spoločnosťou Microsoft: Základy Power Platformy certification.power-platform-fundamentals {int} {int} {int} {int}

Hodnoty dátumu {int} sú formátované ako YYYYMMDD.

Priebeh

Množina údajov Progress obsahuje informácie o tom, koľko bodov XP používatelia v tomto nájomníkovi získali po dokončení častí obsahu (napríklad jednotlivých lekcií, úplných modulov a študijných programov). Nie celý obsah je rovnaký, takže používatelia môžu získať viac bodov, ak obsahujú interaktivitu, alebo ak prvú kontrolu vedomostí dokončili o 100 %.

tenantId userId XPReason SourceType (Typ Zdroja) Id zdroja XP Ocenenie Zadané
{guid} {guid} points.unit.basic.completed Jednotka 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 Vzdelávanie Path learn.cloud-foundations 2100 {datetimeoffset}

Používatelia

Množina údajov Používatelia obsahuje informácie o všetkých používateľoch, na ktoré sa odkazuje v iných množinách údajov špecifických pre nájomníka. Všimnite si, že táto množina údajov neobsahuje žiadne informácie o PII. predstavuje userId identifikátor používateľa profilu Learn, ktorý sa líši od identifikátora Microsoft Entra ObjectId (AADObjectId). Pri vytváraní zostáv sa budete musieť pripojiť k údajom na zoznam používateľov aplikácie Microsoft Entra, aby sa zobrazil holistický zoznam s informáciami o ostatných údajoch o používateľovi.

tenantId userId AADObjectId Dátum vytvorenia
{guid} {guid} {guid} {datetime}

Množiny údajov služby Microsoft Learn

Údaje z lokality Microsoft Learn (nie sú špecifické pre jedného nájomníka) sú poskytované množinami údajov HierarchyCertification, Hierarchy Vzdelávanie Path, Hierarchy Vzdelávanie PathModule, HierarchyModule a HierarchyUnit.

Certifikácia hierarchie

Množina údajov HierarchyCertification obsahuje informácie o katalógu o všetkých certifikáciách v službe Microsoft Learn.

Ak chcete získať ďalšie informácie o certifikáciách a o tom, ako súvisia s inými typmi obsahu, pozrite si časť Certifikácia v článku Typy obsahu služby Learn.

certificationUid typ title Zhrnutie url iconUrl Úrovne výrobky rolí Skúšky
certification.azure-administrator 0 Microsoft Certified: Azure Administrator Associate Správcovia služby Azure implementujú, spravujú a monitorujú prostredie Microsoft Azure organizácie. /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"] ["správca"] ["exam.az-104"]

Hierarchia Vzdelávanie Path

Množina údajov Hierarchy Vzdelávanie Path obsahuje informácie o katalógu o všetkých študijných programoch na lokalite Microsoft Learn.

Ďalšie informácie o študijných programoch a o tom, ako súvisia s inými typmi obsahu, nájdete v časti Vzdelávanie cesty v článku Typy obsahu na lokalite Learn.

Vzdelávanie PathUid title url durationInMinutes Body iconUrl Úrovne výrobky rolí Jazyky
learn.create-serverless-applications Vytváranie bezserverových aplikácií /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"]

Hierarchia Vzdelávanie PathModule

Množina údajov Hierarchy Vzdelávanie PathModule obsahuje mapovanie modulov k študijným programom. (Poznámka: Modul môže byť súčasťou viacerých študijných programu.)

Ak chcete získať ďalšie informácie o moduloch a študijných programoch a o tom, ako súvisia s inými typmi obsahu, pozrite si časť Modul a časť Vzdelávanie cesty v článku Typy obsahu na lokalite Learn.

Vzdelávanie PathUid ID modulu
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

Režim hierarchie

Množina údajov HierarchyModule obsahuje informácie o katalógu o všetkých moduloch (kurzoch).

Ďalšie informácie o moduloch a o tom, ako súvisia s inými typmi obsahu, nájdete v časti Modul v článku Typy obsahu na lokalite Learn.

id moduleUid title url iconUrl durationInMinutes Body Úrovne výrobky rolí Jazyky
learn.languages.powershell-write-first Napíšte svoj prvý kód prostredia PowerShell /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

Hierarchia

Množina údajov HierarchiaMnožina údajov obsahuje informácie o katalógu o všetkých jednotkách (súčasti modulov).

Ďalšie informácie o jednotkách a ich vzťahu s inými typmi obsahu nájdete v časti Jednotky v článku Typy obsahu služby Learn.

unitUid title url durationInMinutes Body id moduleUid
learn.azure.query-data-sentinel.1-introduction Úvod /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Cvičenie: Dotazovanie a vizualizácia údajov pomocou služby Azure Sentinel Workbooks /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Ďalšie kroky

Pozrite si zdroje uvedené nižšie a pomôžte vám na ceste k vývoju: