Udostępnij przez

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:

  • Last updated on