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ľa o implementáciu služby Microsoft Learn Organizational Reporting. Odporúčame tiež, aby ste si skontrolovali článok Osvedčené postupy organizačnej služby Learn, Poznámky k vydaniu a Najčastejšie otázky , ktoré podporia vašu cestu k vývoju.

Slovník údajov

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

Údaje špecifické pre nájomníka sú poskytované množinami údajov Úspechy, Certifikácie, Priebeh a Používatelia.

Dôležité

V userId údajoch špecifických pre nájomníka je identifikátor používateľa profilu Learn, ktorý sa líši od objectId služby AAD.

Získanie záznamov Progress so zobrazovaým menom používateľov vo vašom nájomníkovi:

  • Pripojte sa k vlastným údajom objectId AAD k množine údajov Používatelia špecifickej pre nájomníka AADObjectId
  • Pripojte sa k množine userId údajov Používatelia špecifickej pre nájomníka k pokrokuuserId
  • Vyberte vlastné údaje displayName AAD a použiteľné údaje o pokroku.

Keď si na portáli Azure Active Directory stiahnete podrobnosti o používateľovi, export bude obsahovať displayName aj ďalšie vlastnosti vo formáte CSV.

Odmeny

Množina údajov Úspechy obsahuje informácie o všetkých oceneniach, ktoré používatelia v tomto nájomníkovi získali, zvyčajne v dôsledku dokončenia modulov a študijných programu. 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 profilu používateľa. (príklad)

tenantId Userid awardReason (udelenie ceny) awardType (typ ocenenia) awardUid SourceType (Typ Zdroja) SourceUid AwardedOn (Udelený)
{guid} {guid} badge.module.basic.completed Odznak learn.intro-to-compute.badge Modul learn.intro-to-compute {datetimeoffset}
{guid} {guid} trofej.path.basic.completed Trofej learn.cloud nadácie.trofej Študijný Program základy learn.cloud {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 a ktoré sú stále aktívne alebo uplynuli počas posledných dvoch rokov, v dôsledku absolvovania jednej alebo viacerých skúšok (podľa potreby pre certifikáciu).

tenantID (ID nájomníka) Userid Typ ocenenia Názov prepisu SourceUid AwardedOn (Udelený) CertificationStartDate CertificationEndDate (DátumSchvedčovania) 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}

Dátum {int} hodnoty 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 za dokončenie častí obsahu (napríklad jednotlivých jednotiek, úplných modulov a študijných programov). Nie celý obsah je rovný, takže používatelia môžu získať viac bodov, ak obsahuje interaktivitu, alebo ak prvýkrát dokončili kontrolu vedomostí o 100 %.

tenantId Userid XPReason SourceType (Typ Zdroja) SourceUid XP AwardedOn (Udelený)
{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 Študijný Program základy learn.cloud 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. userId je identifikátor používateľa profilu Learn, ktorý sa líši od objectId služby AAD (AADObjectId). Pri vytváraní zostáv budete musieť pripojiť tieto údaje do zoznamu používateľov služby Azure Active Directory, aby sa vám zobrazil holistický zoznam s informáciami o ostatných údajoch.

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

Množiny údajov služby Microsoft Learn

Údaje služby Microsoft Learn (nie sú špecifické pre jednotlivých nájomníkov) sú poskytované množinami údajov HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule a HierarchyUnit .

Certifikácia hierarchie

Množina údajov HierarchyCertification obsahuje informácie o katalógu všetkých certifikácií 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 na lokalite Learn.

certificationUid zadať názov summary url iconUrl Úrovne Výrobky Úlohy Skúšky
certification.azure-administrator 0 Microsoft Certified: Azure Administrator Associate Správcovia 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"]

HierarchyLearningPath

Množina údajov HierarchyLearningPath obsahuje katalógové informácie 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 Študijné programy v článku Typy obsahu služby Learn.

LearningPathUid názov url durationInMinutes Body iconUrl Úrovne Výrobky Úlohy 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"]

HierarchyLearningPathModule

Množina údajov HierarchyLearningPathModule obsahuje priradenie modulov k študijných 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 študijný program v článku Typy obsahu služby Learn.

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

HierarchiaModule

Množina údajov HierarchyModule obsahuje katalógové informácie 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 Informácie o typoch obsahu.

moduleUid názov url iconUrl durationInMinutes Body Úrovne Výrobky Úlohy Jazyky
learn.languages.powershell-write-first Napísanie prvého kódu 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 HierarchyUnit obsahuje katalógové informácie o všetkých jednotkách (súčasti modulov).

Ďalšie informácie o jednotkách a o tom, ako súvisia s inými typmi obsahu, nájdete v časti Jednotky v článku Naučte sa typy obsahu.

unitUid názov url durationInMinutes Body 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 zošitov Azure Sentinel /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ôžu vám na vašej ceste k vývoju: