Dokumentacja dla deweloperów usługi raportowania organizacyjnego

Ten artykuł zawiera informacje dla deweloperów i osób żądających implementujących usługę raportowania organizacyjnego Microsoft Learn. Zalecamy również zapoznanie się z artykułem Learn Organizational Service best practices (Najlepsze rozwiązania dotyczące usługi organizacyjnej), Release notes (Informacje o wersji) i Frequently asked questions to support your development journey (Często zadawane pytania dotyczące obsługi programowania).

Słownik dotyczący danych

Zestawy danych specyficzne dla dzierżawy

Dane specyficzne dla najemcy są dostarczane przez zestawy danych Osiągnięcia, Umiejętności zastosowane, Certyfikaty, Postęp i Użytkownicy.

Ważne

W userId danych specyficznych dla dzierżawy jest identyfikator użytkownika profilu platformy Learn, który różni się od identyfikatora Microsoft Entra ObjectId.

Aby uzyskać rekordy Postępu z displayName dla użytkowników w dzierżawie:

• Dołączanie własnych danych objectId firmy Microsoft Entra przy użyciu zestawu danych użytkowników specyficznych dla dzierżawyAADObjectId
• Dołączanie zestawu danych użytkownikówuserIddzierżawy do postępuuserId
• Wybierz własne dane displayName firmy Microsoft Entra i odpowiednie dane postępu.

Podczas pobierania szczegółów użytkownika w centrum administracyjnym firmy Microsoft Entra eksport będzie zawierać displayName i inne właściwości w formacie CSV.

Osiągnięcia

Zestaw danych Osiągnięcia zawiera informacje o wszystkich nagrodach uzyskanych przez użytkowników w tej dzierżawie, zazwyczaj w wyniku ukończenia modułów i ścieżek szkoleniowych. Po ukończeniu modułu użytkownicy otrzymają znaczek i po ukończeniu ścieżki szkoleniowej otrzymają trofeum.

Osiągnięcia użytkowników są wyświetlane w witrynie na żywo, wyświetlając profil użytkownika. (Przykład)

Identyfikator najemcy	Identyfikator użytkownika	powód przyznania nagrody	rodzaj nagrody	awardUid	Typ źródła	Identyfikator jednostki źródłowej	Nagrodzona
{guid}	{guid}	odznaka.moduł.podstawowy.zakończony	Odznaka	nauka.wprowadzenie-do-obliczeń.odznaka	Moduł	learn.intro-to-compute	{datetimeoffset}
{guid}	{guid}	trofeum.ścieżka.podstawowy.ukończony	Trofeum	learn.cloud-foundations.trophy	LearningPath	learn.cloud-foundations	{datetimeoffset}

AppliedSkills

Zestaw danych AppliedSkills zawiera informacje o wszystkich zastosowanych umiejętnościach uzyskanych przez użytkowników w tej dzierżawie, zazwyczaj w wyniku ukończenia sesji laboratorium. Po pomyślnym zakończeniu sesji laboratorium użytkownicy mogą zdobyć umiejętności.

Identyfikator najemcy	Identyfikator użytkownika	appliedSkillsUid	labProfileName	DataOcenyEgzaminu
{guid}	{guid}	zastosowanie-umiejętności.budowa-azure-ai-rozwiązania-wizji	APL-3004: Tworzenie rozwiązania azure AI Vision	{datetime}
{guid}	{guid}	umiejętność-praktyczna.buduj-aplikacje-współdzielone-microsoft-teams	APL-4001: Tworzenie aplikacji współpracy dla usługi Microsoft Teams	{datetime}

Certyfikaty

Zestaw danych Certyfikaty zawiera informacje o wszystkich certyfikatach uzyskanych przez użytkowników w tej dzierżawie, które są nadal aktywne lub wygasły w ciągu ostatnich dwóch lat, w wyniku ukończenia co najmniej jednego egzaminu (zgodnie z wymaganiami dotyczącymi certyfikacji).

identyfikator dzierżawy	Identyfikator użytkownika	TypNagrody	Nazwa transkrypcji	Identyfikator jednostki źródłowej	Nagrodzona	DataRozpoczęciaCertyfikacji	DataZakończeniaCertyfikacji	StayCurrentEligibilityStartDate
{guid}	{guid}	Certyfikacja	Certyfikat firmy Microsoft: Azure inżynierowie AI Associate	certyfikacja.azure-ai-engineer	{int}	{int}	{int}	{int}
{guid}	{guid}	Certyfikacja	Certyfikat firmy Microsoft: Podstawy platformy Power Platform	certyfikacja.power-platform-podstawy	{int}	{int}	{int}	{int}

Wartości daty {int} są formatowane jako YYYYMMDD.

Postęp

Zestaw danych Progress zawiera informacje dotyczące liczby punktów XP uzyskanych przez użytkowników w tej dzierżawie od ukończenia fragmentów zawartości (takich jak poszczególne jednostki, pełne moduły i ścieżki szkoleniowe). Nie wszystkie treści są równe, więc użytkownicy mogą zdobywać więcej punktów, jeśli zawiera interakcyjność, lub jeśli po raz pierwszy ukończyli test wiedzy 100%.

Identyfikator najemcy	Identyfikator użytkownika	XPReason	Typ źródła	Identyfikator jednostki źródłowej	XP	Nagrodzona
{guid}	{guid}	Liczba jednostek podstawowych ukończono	Jednostka	ucz.się.wprowadzenie-do-informatyki.1-wprowadzenie	100	{datetimeoffset}
{guid}	{guid}	punkty.moduł.podstawowy.zakończony	Moduł	learn.create-azure-account	200	{datetimeoffset}
{guid}	{guid}	punkty.ścieżka.podstawowa.zakończona	LearningPath	learn.cloud-foundations	2100	{datetimeoffset}

Użytkownicy

Zestaw danych Użytkownicy zawiera informacje o wszystkich użytkownikach, do których odwołuje się inne zestawy danych specyficzne dla dzierżawy. Zwróć uwagę, że ten zestaw danych nie zawiera żadnych informacji osobowych. Jest userId to identyfikator użytkownika profilu platformy Learn, który różni się od identyfikatora Microsoft Entra ObjectId (AADObjectId). Podczas raportowania należy dołączyć te dane do listy użytkowników firmy Microsoft Entra, aby wyświetlić bardziej całościową listę informacji o użytkownikach względem innych danych.

Identyfikator najemcy	Identyfikator użytkownika	AADObjectId	Utworzono dnia
{guid}	{guid}	{guid}	{datetime}

Zestawy danych usługi Microsoft Learn

Dane środowiska Microsoft Learn (nie specyficzne dla pojedynczej dzierżawy) są udostępniane przez zestawy danych HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule i HierarchyUnit.

HierarchyAppliedSkills

Zestaw danych HierarchyAppliedSkills zawiera informacje o katalogu wszystkich zastosowanych umiejętności w środowisku Microsoft Learn.

Aby dowiedzieć się więcej o zastosowanych umiejętnościach i sposobie ich powiązania z innymi typami zawartości, zobacz sekcję Zastosowane umiejętności w artykule Learn content types (Typy zawartości learn).

appliedSkillsUid	tytuł	Adres URL	poziomy	produkty	Ról	Tematy	zadania
umiejętność-stosowana.budowa-rozwiązania-Azure-AI-wizji	Tworzenie rozwiązania azure AI Vision	/credentials/applied-skills/build-azure-ai-vision-solution/ (budowanie rozwiązania AI wizyjnego Azure)	["pośredni"]	["azure-computer-vision"]	["programista","inżynier AI","twórca"]	["sztuczna inteligencja"]	["Tworzenie zasobu przetwarzania obrazów","Analizowanie obrazów","Tworzenie niestandardowego modelu analizy obrazów","Trenowanie i ocenianie modelu","Korzystanie z modelu niestandardowego"]
umiejętności-praktyczne.tworzenie-kolaboracyjnych-aplikacji-microsoft-teams	Tworzenie aplikacji współpracy dla usługi Microsoft Teams	/credentials/applied-skills/build-collaborative-apps-microsoft-teams/	["pośredni"]	["office-teams","ms-graph","entra-id","ms-copilot"]	programista	["rozwój zaplecza","rozwój interfejsu","tworzenie aplikacji niestandardowych"]	["Tworzenie bota","Tworzenie rozszerzenia obsługi komunikatów","Tworzenie elementów webhook","Tworzenie karty usługi Teams","Integrowanie programu Microsoft Graph z aplikacją usługi Teams", "Dystrybuowanie aplikacji Teams"]

Certyfikacja Hierarchii

Zestaw danych HierarchyCertification zawiera informacje o katalogu dotyczące wszystkich certyfikatów w usłudze Microsoft Learn.

Aby dowiedzieć się więcej o certyfikatach i sposobie ich powiązania z innymi typami zawartości, zobacz sekcję Certyfikacja w artykule Learn content types (Typy zawartości learn).

certificationUid	typ	tytuł	podsumowanie	Adres URL	ikonaURL	poziomy	produkty	Ról	Egzaminów
certyfikacja.azure-administrator	0	Certyfikat firmy Microsoft: Azure Administrator Associate	Administratorzy platformy Azure implementują i monitorują środowisko platformy Microsoft Azure organizacji oraz zarządzaj nimi.	/certifications/azure-administrator/	/media/learn/certification/badges/microsoft-certified-associate-badge.svg	["pośredni"]	["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"]	["administrator"]	["exam.az-104"]

HierarchyLearningPath

Zestaw danych HierarchyLearningPath zawiera informacje o katalogu wszystkich ścieżek szkoleniowych w witrynie Microsoft Learn.

Aby dowiedzieć się więcej na temat ścieżek szkoleniowych i sposobu ich powiązania z innymi typami zawartości, zobacz sekcję Ścieżki szkoleniowe w artykule Learn content types (Typy zawartości platformy Learn).

LearningPathUid	tytuł	Adres URL	CzasTrwaniaWMinitach	Punkty	iconUrl	poziomy	produkty	Ról	języki
ucz.się.tworzenia-aplikacji-bezserwerowych	Tworzenie aplikacji bezserwerowych	/training/paths/create-serverless-applications/	517	1925	/training/achievements/tworzenie-aplikacji-bezserwerowych.svg	["początkujący","pośredni"]	["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"]	["developer","student"]	["powershell"]

HierarchyLearningPathModule

Zestaw danych HierarchyLearningPathModule zawiera mapowanie modułów na ścieżki szkoleniowe. (Uwaga: moduł może być częścią wielu ścieżek szkoleniowych).

Aby dowiedzieć się więcej na temat modułów i ścieżek szkoleniowych oraz sposobu ich powiązania z innymi typami zawartości, zobacz sekcję Moduł i ścieżkę szkoleniową w artykule Learn content types (Typy zawartości platformy Learn).

LearningPathUid	ModuleUid
learn.security-ops-sentinel	azure.query-data-sentinel
learn.architekt-platforama-danych	ucz się.dostęp-do-danych-z-cosmos-db-i-sql-api

HierarchyModule

Zestaw danych HierarchyModule zawiera informacje o katalogu dotyczące wszystkich modułów (kursów).

Aby dowiedzieć się więcej o modułach i sposobie ich powiązania z innymi typami zawartości, zobacz sekcję Moduł w artykule Learn content types (Typy zawartości platformy Learn).

moduleUid	tytuł	Adres URL	iconUrl	czasTrwaniaWMinutach	Punkty	poziomy	produkty	Ról	języki
learn.languages.powershell-zacznij-pisać	Pisanie pierwszego kodu programu PowerShell	/training/modules/powershell-write-first/	/training/achievements/powershell/powershell-write-first-code.svg	17	200	["początkujący"]	["dotnet"]	["developer","student"]	["powershell"]

HierarchyUnit

Zestaw danych HierarchyUnit zawiera informacje o katalogu dotyczące wszystkich jednostek (elementów modułów).

Aby dowiedzieć się więcej o jednostkach i sposobie ich powiązania z innymi typami zawartości, zobacz sekcję Units (Jednostki) w artykule Learn content types (Typy zawartości learn).

unitUid	tytuł	Adres URL	czasTrwaniaWMinutach	Punkty	moduleUid
learn.azure.query-data-sentinel.1-introduction	Wprowadzenie	/training/modules/query-data-sentinel/1-introduction/	5	100	azure.query-data-sentinel
ucz się.azure.zapytaj-dane-sentinel.2-przygotowanie-ćwiczenia	Ćwiczenie — Tworzenie zapytań i wizualizowanie danych przy użyciu skoroszytów usługi Azure Sentinel	/training/modules/query-data-sentinel/2-exercise-setup/	10	100	azure.query-data-sentinel

Następne kroki

Zapoznaj się z poniższymi zasobami, aby ułatwić ci proces programowania:

• Poznaj najlepsze rozwiązania dotyczące usługi raportowania organizacyjnego
• Poznaj usługę raportowania organizacyjnego — często zadawane pytania
• Informacje o wersji usługi Raportowanie organizacyjne