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, Certifikace, Průběh a Uživatelé .

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ě userId Uživatelé pro konkrétního tenanta 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)

tenantId	userId	awardReason	awardType	awardUid	Typ zdroje	SourceUid	Udělenýon
{guid}	{guid}	badge.module.basic.completed	Odznáček	learn.intro-to-compute.badge	Modul	learn.intro-to-compute	{datetimeoffset}
{guid}	{guid}	trophy.path.basic.completed	Trofej	learn.cloud-foundations.trophy	Studijní cesta	learn.cloud-foundations	{datetimeoffset}

Použité dovednosti

Datová sada Použité dovednosti 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.

tenantId	userId	appliedSkillsUid	labProfileName	zkouškaScoredDate
{guid}	{guid}	applied-skill.build-azure-ai-vision-solution	APL-3004: Vytvoření řešení Azure AI Vision	{datetime}
{guid}	{guid}	applied-skill.build-collaborative-apps-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	userId	AwardType	Název přepisu	SourceUid	Udělenýon	CertificationStartDate	CertificationEndDate	StayCurrentEligibilityStartDate
{guid}	{guid}	Certifikace	Microsoft Certified: Azure Technici AI Associate	certification.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	Certifikace	Microsoft Certified: Power Platform Fundamentals	certification.power-platform-fundamentals	{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é.

tenantId	userId	XPReason	Typ zdroje	SourceUid	XP	Udělenýon
{guid}	{guid}	points.unit.basic.completed	Unit	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	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.

tenantId	userId	AADObjectId	CreatedOn
{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	title	url	úrovně	produkty	Role.	předměty	úlohy
applied-skill.build-azure-ai-vision-solution	Vytvoření řešení Azure AI Vision	/credentials/applied-skills/build-azure-ai-vision-solution/	["intermediate"]	["azure-computer-vision"]	["developer","ai-engineer","maker"]	["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"]
applied-skill.build-collaborative-apps-microsoft-teams	Vytváření aplikací pro spolupráci pro Microsoft Teams	/credentials/applied-skills/build-collaborative-apps-microsoft-teams/	["intermediate"]	["office-teams","ms-graph","entra-id","ms-copilot"]	["developer"]	["backend-development","frontend-development","custom-app-development"]	["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	type	title	Souhrn	url	iconUrl	úrovně	produkty	Role.	Zkoušky
certification.azure-administrator	0	Microsoft Certified: 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	["intermediate"]	["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"]	["administrator"]	["exam.az-104"]

HierarchyLearningPath

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	title	url	durationInMinutes	points	iconUrl	úrovně	produkty	Role.	jazyky
learn.create-serverless-applications	Vytváření aplikací bez serverů	/training/paths/create-serverless-applications/	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"]	["developer","student"]	["powershell"]

HierarchyLearningPathModule

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	learn.access-data-with-cosmos-db-and-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	title	url	iconUrl	durationInMinutes	points	úrovně	produkty	Role.	jazyky
learn.languages.powershell-write-first	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"]	["developer","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	title	url	durationInMinutes	points	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