Seznámení s referenční dokumentací pro vývojáře služby Organizační reporting

Tento článek obsahuje informace pro vývojáře a žadatele, kteří implementuje službu Organizační vytváření sestav Microsoft Learn. Doporučujeme také projděte si článek s osvědčenými postupy organizační služby Learn, poznámky k verzi a nejčastější dotazy, které vám pomohou s vývojem.

Datový slovník

Datové sady specifické pro tenanty

Data specifická pro tenanta poskytují datové sady Dosažené cíle, AppliedSkills, Certifications, Progress a Users .

Důležité

V userId datech specifických pro tenanta je identifikátor uživatele profilu Learn, který se liší od Microsoft Entra ObjectId.

Získání záznamů průběhu pomocí displayName pro uživatele ve vašem tenantovi:

• Připojení vlastních dat objectId Microsoft Entra pomocí datové sady Uživatelů specifických pro tenantaAADObjectId
• Připojení k datové sadě UživateléuserIdtenanta k průběhu userId
• Vyberte si vlastní data displayName Microsoft Entra a příslušná data o průběhu.

Když si stáhnete podrobnosti o uživateli v Centru pro správu Microsoft Entra, export bude obsahovat displayName a další vlastnosti ve formátu CSV.

Úspěchy

Datová sada Bonusy obsahuje informace o všech oceněních, které uživatelé v tomto tenantovi získali, obvykle v důsledku dokončování modulů a studijních programů. Po dokončení modulu uživatelé získají odznáček a po dokončení studijního programu získá trofej.

Dosažené cíle uživatelů se zobrazují na živém webu zobrazením profilu uživatele. (Příklad)

ID nájemce	ID uživatele	důvod ocenění	typ ocenění	awardUid	Typ zdroje	SourceUid	Udělenýon
{guid}	{guid}	odznak.modul.základní.dokončen	Odznáček	learn.vstup-do-počítání.odznak	Modul	učit/introduction-do-počítačů	{datetimeoffset}
{guid}	{guid}	Completed základní cesta trofejí	Trofej	learn.cloud-foundations.trophy	Studijní cesta	learn.cloud-foundations	{datetimeoffset}

Aplikované dovednosti

Datová sada AppliedSkills obsahuje informace o všech použitých dovednostech, které uživatelé v tomto tenantovi získali, obvykle v důsledku dokončení testovacích relací. Po úspěšném dokončení cvičení můžou uživatelé získat dovednosti.

ID nájemce	ID uživatele	appliedSkillsUid	labProfileName	zkouškaScoredDate
{guid}	{guid}	praktická dovednost: vytvořit řešení Azure AI Vision	APL-3004: Vytvoření řešení Azure AI Vision	{datetime}
{guid}	{guid}	použité-dovednosti.vytvářejte-spolupráci-aplikace-microsoft-teams	APL-4001: Vytváření aplikací pro spolupráci pro Microsoft Teams	{datetime}

Certifikace

Datová sada certifikací obsahuje informace o všech certifikacích, které uživatelé v tomto tenantovi získali, které jsou stále aktivní nebo jejichž platnost vypršela v posledních dvou letech, a to v důsledku dokončení jedné nebo více zkoušek (podle požadavků na certifikaci).

ID tenanta	ID uživatele	Typ ocenění	Název přepisu	SourceUid	Udělenýon	DatumZačátkuCertifikace	CertificationEndDate	StayCurrentEligibilityStartDate
{guid}	{guid}	Certifikace	Microsoft Certified: Azure Technici AI Associate	certifikace.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	Certifikace	Microsoft Certified: Základy platformy Power	certifikace Power Platform základy	{int}	{int}	{int}	{int}

Hodnoty kalendářního data {int} jsou formátovány jako YYYYMMDD.

Průběh

Datová sada Progress obsahuje informace o tom, kolik bodů XP uživatelé v tomto tenantovi získali od dokončení částí obsahu (například jednotlivých jednotek, celých modulů a studijních programů). Ne veškerý obsah je stejný, takže uživatelé mohou získat více bodů, pokud obsahoval interaktivitu, nebo pokud dokončili kontrolu znalostí 100 % poprvé.

ID nájemce	ID uživatele	XPReason	Typ zdroje	SourceUid	XP	Udělenýon
{guid}	{guid}	body.jednotka.základ.dokončeno	Jednotka	learn.intro-to-compute.1-introduction	100	{datetimeoffset}
{guid}	{guid}	points.module.basic.completed	Modul	učit.se-vytvořit-účet-na-azure	200	{datetimeoffset}
{guid}	{guid}	body.cesta.základní.dokončeno	Studijní cesta	learn.cloud-foundations	2100	{datetimeoffset}

Uživatelé

Datová sada Users obsahuje informace o všech uživatelích odkazovaných v ostatních datových sadách specifických pro tenanta. Všimněte si, že tato datová sada neobsahuje žádné informace o PII. Je userId identifikátor uživatele profilu Learn, který se liší od Microsoft Entra ObjectId (AADObjectId). Při vytváření sestav budete muset tato data připojit ke svému seznamu uživatelů Microsoft Entra, abyste viděli komplexnější seznam informací o uživatelích s jinými daty.

ID nájemce	ID uživatele	AADObjectId	Vytvořeno dne
{guid}	{guid}	{guid}	{datetime}

Datové sady Microsoft Learn

Data Microsoft Learn (ne specifická pro jednotlivého tenanta) poskytují datové sady HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule a HierarchyUnit .

HierarchyAppliedSkills

Datová sada HierarchyAppliedSkills obsahuje informace o katalogu o všech použitých dovednostech v Microsoft Learn.

Další informace o použitých dovednostech a o tom, jak souvisí s jinými typy obsahu, najdete v části Použité dovednosti v článku o typech obsahu Learn.

appliedSkillsUid	název	adresa URL	úrovně	produkty	Role.	předměty	úlohy
praktická dovednost: vytvořit řešení Azure AI Vision	Vytvoření řešení Azure AI Vision	/osvědčení/aplikované-dovednosti/vytvoření-řešení-pro-azure-ai-vidění/	střední úroveň	Azure Computer Vision	["vývojář", "AI inženýr", "kutil"]	["umělá inteligence"]	["Vytvoření prostředku počítačového zpracování obrazu","Analýza obrázků","Vytvoření vlastního modelu analýzy obrázků","Trénování a vyhodnocení modelu","Využívání vlastního modelu"]
použité-dovednosti.vytvářejte-spolupráci-aplikace-microsoft-teams	Vytváření aplikací pro spolupráci pro Microsoft Teams	/credentials/applied-skills/vytvářejte-společné-aplikace-pro-microsoft-teams/	střední úroveň	["office-teams","ms-graph","entra-id","ms-copilot"]	["vývojář"]	["vývoj backendu","vývoj frontendu","vývoj vlastních aplikací"]	["Sestavení robota","Vytvoření rozšíření zasílání zpráv","Sestavení webhooků","Karta Vytvoření Teams","Integrace Microsoft Graphu do aplikace Teams","Distribuce aplikace Teams"]

HierarchieCertification

Datová sada HierarchyCertification obsahuje informace o katalogu o všech certifikacích v Microsoft Learn.

Další informace o certifikacích a jejich vztahu k jiným typům obsahu najdete v části Certifikace v článku Typy obsahu Learn.

certificationUid	typ	název	souhrn	adresa URL	IconUrl	úrovně	produkty	Role.	Zkoušky
certification.azure-administrator	0	Certifikace Microsoftu: Azure Administrator Associate	Správci Azure implementují, spravují a monitorují prostředí Microsoft Azure v organizaci.	/certifications/azure-administrator/	/media/learn/certification/badges/microsoft-certified-associate-badge.svg	střední úroveň	["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"]	["administrator"]	["exam.az-104"]

Hierarchie Učební Cesta

Datová sada HierarchyLearningPath obsahuje informace o katalogu o všech studijních programech v Microsoft Learn.

Další informace o studijních programech a jejich vztahu k jiným typům obsahu najdete v části Studijní programy v článku o typech obsahu Learn.

LearningPathUid	název	adresa URL	délkaVMinutách	výhybka	IconUrl	úrovně	produkty	Role.	jazyky
naučte-se.vytvářet-bezserverové-aplikace	Vytváření aplikací bez serverů	/training/paths/vytvoření-bezserverových-aplikací/	517	1925	/školení/ dosažené cíle / create-serverless-applications.svg	["začátečník","intermediate"]	["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"]	["vývojář","student"]	["powershell"]

Modul hierarchie cesty učení

Datová sada HierarchyLearningPathModule obsahuje mapování modulů na studijní programy. (Poznámka: Modul může být součástí několika studijních programů.)

Další informace omodulech

LearningPathUid	ModuleUid
learn.security-ops-sentinel	azure.query-data-sentinel
learn.architect-data-platform	naučte se přistupovat k datům pomocí Cosmos DB a SQL API

HierarchyModule

Datová sada HierarchyModule obsahuje informace o katalogu o všech modulech (kurzech).

Další informace o modulech a o tom, jak souvisí s jinými typy obsahu, najdete v části Modul v článku o typech obsahu Learn.

moduleUid	název	adresa URL	IconUrl	délkaVMinutách	výhybka	úrovně	produkty	Role.	jazyky
učte.se.jazyky.powershell-napište-první	Napsání prvního kódu PowerShellu	/training/modules/powershell-write-first/	/training/achievements/powershell/powershell-write-first-code.svg	17	200	["začátečník"]	["dotnet"]	["vývojář","student"]	["powershell"]

HierarchyUnit

Datová sada HierarchyUnit obsahuje informace o katalogu o všech jednotkách (části modulů).

Další informace o jednotkách a jejich souvislostech s jinými typy obsahu najdete v části Jednotky v článku o typech obsahu Learn.

unitUid	název	adresa URL	délkaVMinutách	výhybka	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čení – dotazy na data a jejich vizualizace pomocí služby Azure Sentinel Workbooks	/training/modules/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

Další kroky

Projděte si následující zdroje informací, které vám pomůžou na cestě vývoje:

• Seznamte se s osvědčenými postupy služby Vytváření sestav organizace
• Nejčastější dotazy ke službě Organizační vytváření sestav
• Přečtěte si poznámky k verzi služby Organizační reporting