Freigeben über

Referenzdokumentation für Entwickler*innen zum Organizational Reporting-Dienst von Learn

  • Artikel

Dieser Artikel enthält Informationen für Entwickler*innen und Anforderer*innen, die den Organizational Reporting-Dienst von Microsoft Learn implementieren. Es wird auch empfohlen, die Best Practices für den Organizational Reporting-Dienst von Learn, die Versionshinweise und die häufig gestellten Fragen zu lesen, um den Lernprozess zu unterstützen.

Datenwörterbuch

Mandantenspezifische Datasets

Die mandantenspezifischen Daten stammen aus den Datasets Achievements, Certifications, Progress und Users.

Wichtig

Die userId in den mandantenspezifischen Daten ist die Benutzer-ID des Learn-Profils. Diese unterscheidet sich von der Microsoft Entra-ObjectId.

So rufen Sie Fortschrittsdaten mit dem displayName-Wert für Benutzer*innen in Ihrem Mandanten ab:

  • Verknüpfen der eigenen Microsoft Entra-Daten-objectId mit der mandantenspezifischen AADObjectId des Users-Datasets
  • Verknüpfen des mandantenspezifischen Datasets Benutzer userId mit dem Status userId
  • Wählen Sie Ihren eigenen Microsoft Entra-Daten-displayName und die zutreffenden Fortschrittsdaten aus.

Wenn Sie Benutzerdetails aus dem Microsoft Entra Admin Center herunterladen, enthält der Export displayName und andere Eigenschaften im CSV-Format.

Auszeichnungen

Das Dataset Achievements enthält Informationen zu allen Preisen, die die Benutzer in diesem Mandanten erhalten haben, in der Regel als Ergebnis der Fertigstellung von Modulen und Lernpfaden. Nach Abschluss des Moduls erhalten Benutzer*innen einen Badge und nach Abschluss des Lernpfads einen Preis.

Benutzererfolge werden auf der Livewebsite angezeigt, indem das Profil eines Benutzers angezeigt wird. (Beispiel)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed Badge learn.intro-to-compute.badge Modul learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed Preis learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

Angewandte Fähigkeiten

Das Dataset Applied Skills enthält Informationen über alle Applied Skills, die die Benutzer*innen in diesem Mandanten erlangt haben, in der Regel als Ergebnis der Absolvierung von Labsitzungen. Nach erfolgreichem Abschluss der Labsitzung können Benutzer*innen eine Fähigkeit erwerben.

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004: Erstellen einer Azure KI Vision-Lösung {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001: Erstellen von Apps für die Zusammenarbeit für Microsoft Teams {datetime}

Zertifizierungen

Das Dataset Certifications enthält Informationen zu allen Zertifizierungen, die die Benutzer in diesem Mandanten durch Bestehen einer oder mehrerer Prüfungen (wie für die Zertifizierung erforderlich) erlangt haben und die noch aktiv sind oder in den letzten zwei Jahren abgelaufen sind.

tenantID userId AwardType TranscriptName SourceUid AwardedOn CertificationStartDate CertificationEndDate StayCurrentEligibilityStartDate
{guid} {guid} Zertifizierung Microsoft Certified: Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Zertifizierung Microsoft Certified: Power Platform Fundamentals certification.power-platform-fundamentals {int} {int} {int} {int}

{int}-Werte für Datumsangaben weisen das Format YYYYMMDD auf.

Fortschritt

Das Dataset Progress enthält Informationen darüber, wie viele XP-Punkte die Benutzer*innen in diesem Mandanten durch das Abschließen von Inhaltsteilen (z. B. einzelne Einheiten, vollständige Module oder Lernpfade) erhalten haben. Nicht alle Inhalte sind gleich, sodass Benutzer*innen mehr Punkte verdienen können, wenn sie interaktive Inhalte bearbeiten oder die Wissensbeurteilung zum ersten Mal mit 100 % abschließen.

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Einheit 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 LearningPath learn.cloud-foundations 2100 {datetimeoffset}

Benutzer

Das Dataset Users enthält Informationen zu allen Benutzern, auf die in den anderen mandantenspezifischen Datasets verwiesen wird. Beachten Sie, dass dieses Dataset keine personenbezogenen Informationen enthält. Die userId ist die Benutzer-ID des Learn-Profils. Diese unterscheidet sich von der Microsoft Entra-ObjectId (AADObjectId). Wenn Sie Berichte erstellen, müssen Sie diese Daten mit der Liste der Microsoft Entra-Benutzer verknüpfen, um eine umfassendere Liste der Benutzerinformationen mit den anderen Daten anzuzeigen.

tenantId userId AADObjectId CreatedOn
{guid} {guid} {guid} {datetime}

Microsoft Learn-Datasets

Microsoft Learn-Daten (nicht spezifisch für einen einzelnen Mandanten) werden von den Datasets HierarchyAppliedSkills, HierarchyCertification, HierarchyLearningPath, HierarchyLearningPathModule, HierarchyModule und HierarchyUnit bereitgestellt.

HierarchyAppliedSkills

Das HierarchyAppliedSkills-Dataset enthält Kataloginformationen zu allen Applied Skills in Microsoft Learn.

Weitere Informationen zu Applied Skills und ihrer Beziehung zu anderen Inhaltstypen finden Sie im Abschnitt „Applied Skills“ im Artikel „Inhaltstypen in Learn“.

appliedSkillsUid title url Stufen products roles Themen Tasks
applied-skill.build-azure-ai-vision-solution Erstellen einer Azure KI Vision-Lösung /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["artificial-intelligence"] [„Eine Bildverarbeitungsressource erstellen“, „Bilder analysieren“, „Ein benutzerdefiniertes Bildanalysemodell erstellen“, „Das Modell trainieren und auswerten“, „Ein benutzerdefiniertes Modell verbrauchen“]
applied-skill.build-collaborative-apps-microsoft-teams Erstellen von Apps für die Zusammenarbeit für 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"] [„Einen Bot erstellen“, „Eine Messagingerweiterung erstellen“, „Webhooks erstellen“, „Eine Teams-Registerkarte erstellen“, „Microsoft Graph in eine Teams-App integrieren“, „Eine Teams-App verteilen“]

HierarchyCertification

Das Dataset HierarchyCertification enthält Kataloginformationen zu allen Zertifizierungen in Microsoft Learn.

Weitere Informationen zu Zertifizierungen und deren Beziehung zu anderen Inhaltstypen finden Sie im Abschnitt Zertifizierung im Artikel Learn-Inhaltstypen.

certificationUid type title Zusammenfassung url iconUrl Stufen products roles exams
certification.azure-administrator 0 Microsoft Certified: Azure Administrator Associate Azure Administrators implementieren, verwalten und überwachen die Microsoft Azure-Umgebung einer Organisation. /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

Das Dataset HierarchyLearningPath enthält Kataloginformationen zu allen Lernpfaden auf Microsoft Learn.

Weitere Informationen zu Lernpfaden und deren Beziehung zu anderen Inhaltstypen finden Sie im Abschnitt Lernpfade im Artikel Learn-Inhaltstypen.

LearningPathUid title url durationInMinutes Punkte iconUrl Stufen products roles languages
learn.create-serverless-applications Erstellen von serverlosen Anwendungen /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

Das Dataset HierarchyLearningPathModule enthält die Zuordnung von Modulen zu Lernpfaden. (Hinweis: Ein Modul kann Teil mehrerer Lernpfade sein.)

Weitere Informationen zu Modulen und Lernpfaden und deren Beziehung zu anderen Inhaltstypen finden Sie in den Abschnitten Module und Lernpfade im Artikel Learn-Inhaltstypen.

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

HierarchyModule

Das Dataset HierarchyModule enthält Kataloginformationen zu allen Modulen (Kursen).

Weitere Informationen zu Modulen und deren Beziehung zu anderen Inhaltstypen finden Sie im Abschnitt Module im Artikel Learn-Inhaltstypen.

moduleUid title url iconUrl durationInMinutes Punkte Stufen products roles languages
learn.languages.powershell-write-first Schreiben Ihres ersten PowerShell-Codes /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

Das Dataset HierarchyUnit enthält Kataloginformationen zu allen Lerneinheiten (Modulbestandteile).

Weitere Informationen zu Lerneinheiten und deren Beziehung zu anderen Inhaltstypen finden Sie im Abschnitt Lerneinheiten im Artikel Learn-Inhaltstypen.

unitUid title url durationInMinutes Punkte moduleUid
learn.azure.query-data-sentinel.1-introduction Einführung /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup Übung: Abfragen und Visualisieren von Daten mit Azure Sentinel-Arbeitsmappen /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

Nächste Schritte

Sehen Sie sich die folgenden Ressourcen an, um weitere Informationen zu erhalten: