Freigeben über


Best Practices für die Verwendung des Organizational Reporting-Diensts von Microsoft Learn

In diesem Artikel werden die Best Practices für die Verwendung des Organizational Reporting-Diensts von Microsoft Learn beschrieben.

Grundlegendes zur Microsoft Learn-Vereinbarung zu Datenzugriff und Datenfreigabe

Mit der Nutzung dieses Datenfreigabediensts nehmen Sie die Microsoft Learn-Vereinbarung zu Datenzugriff und Datenfreigabe zur Kenntnis und akzeptieren sie, damit Microsoft die Learn-Daten von Learn-Benutzer*innen, die sich mit der Mandanten-ID Ihrer Organisation anmelden, für die Organisation freigeben kann. Bevor Sie den Organizational Reporting-Dienst von Microsoft Learn verwenden und die Ausgabe in Produktionsumgebungen einschließen, sollten Sie diese Vereinbarung gelesen und verstanden haben.

Planen der Berichtslösung zum Visualisieren der in diesem Dienst bereitgestellten Daten

Der Organizational Reporting-Dienst von Microsoft Learn stellt Organisationen unformatierte Abschlussdaten bereit und verfügt standardmäßig über keine Dashboards. Sie können die Daten in das CSV-Format exportieren, um die Daten schnell anzuzeigen, aber sie müssen miteinander verknüpft werden, um aussagekräftig zu sein.

Sie können eine Power BI-Vorlage für SQL-Datenbank-Speicher für den Organizational Reporting-Dienst von Learn nutzen, die viele Standarddatenvisualisierungen umfasst. Sie können aber auch eine Berichtslösung Ihrer Wahl verwenden. Planen Sie im Voraus, was Sie verwenden möchten, damit Sie diese Komponenten im Rahmen des Setupprozesses mit dem Datenspeicher verknüpfen können.

Grundlegendes zum Learn-Inhaltsmodell

Um die Antwort des Organizational Reporting-Diensts von Microsoft Learn effektiv nutzen zu können, ist es wichtig, die auf Microsoft Learn verfügbaren Inhaltstypen und deren Zusammenhänge zu verstehen. Weitere Informationen finden Sie im Artikel zu den Learn-Inhaltstypen.

Dabei gilt Folgendes:

  • Die UID steht für „Unique ID“ und ist für jedes Inhaltsobjekt eindeutig. Wenn sich eine UID ändert, wird der Inhalt als neues Objekt betrachtet, auch wenn der Titel oder andere Metadaten identisch bleiben.
  • Module sind das wichtigste Objekt im Learn-Schulungskatalog. Sie können in dem Sinne eigenständig sein, dass sie ein Szenario oder ein Konzept komplett vermitteln und die Absolvierung von Vorgängermodulen nicht erforderlich ist. In manchen Fällen ist das alles, und die Module gehören nicht zu einem Lernpfad. In anderen Fällen sind Module zu einem Lernpfad (oder mehreren Lernpfaden) gebündelt, bei denen fortgeschrittene Konzepte vermittelt werden. Ein Modul ist nicht zwingend Teil eines Lernpfads, aber es kann in einem oder mehreren Lernpfaden vorkommen.
  • Die Lerneinheiten sind nicht als eigenständige Inhalte konzipiert. Sie sollen in der im Modul vorgesehenen Reihenfolge absolviert werden. Deswegen haben wir den Link auf der Moduldetailseite und in der ersten Einheit hinzugefügt. Benutzer können an dieser Stelle beginnen und dann mit den weiteren Inhalten fortfahren.

Funktionsweise der Lokalisierung auf Learn und der Wiedergabe lokalisierter Inhalte in der Organizational Reporting-Ausgabe

Microsoft Learn unterstützt über 65 Gebietsschemas auf der Website, und ein Großteil der Inhalte wurde in diese Gebietsschemas übersetzt. Unser Ziel ist es, die Inhalte in allen Sprachen zur Verfügung zu stellen, in denen das Produkt bzw. die Produkte, die in den Inhalten behandelt werden, erhältlich sind. Jedoch sind nicht für alle Gebietsschemas übersetzte Inhalte verfügbar.

Wenn für einen Gebietsschemadatensatz die zugehörige Übersetzung nicht verfügbar ist, werden die Inhalte auf der Website und die API-Antwort standardmäßig auf Englisch angezeigt. Bei der API-Ausgabe werden in diesem Fall englischsprachige Metadaten in den Antworten anderer Gebietsschemas angezeigt. Die URL zum Inhalt führt jedoch weiterhin zu diesem Gebietsschema, auch wenn der Hauptinhalt möglicherweise auf Englisch angezeigt wird. Dadurch soll es Benutzer*innen ermöglicht werden, die Website weiterhin in diesem Gebietsschema zu navigieren (die übersetzte Kopf- und Fußzeile und jeder andere Link, für den eine Übersetzung verfügbar ist, werden angezeigt).

Wenn Updates des englischsprachigen Inhalts veröffentlicht werden, arbeiten unsere Lokalisierungspipelines daran, die lokalisierten Versionen so schnell wie möglich zu aktualisieren – in der Regel innerhalb weniger Tage nach der ursprünglichen Änderung. Eine vollständige Liste der unterstützten Gebietsschemas wird in der Fußzeile der Website angezeigt (Link für die Sprache auswählen, in der die Website angezeigt wird).

Unsere Datensätze zur Absolvierung von Schulungsinhalten sind unabhängig vom Gebietsschema, was bedeutet, dass wir lokalisierte Versionen von Inhalten nicht als separate Objekte in unseren Datensätzen zur Absolvierung von Benutzerschulungen unterscheiden. Unabhängig davon, in welcher Sprache Benutzer*innen eine Schulung abschließen, erhalten sie Punkte für das Gesamtobjekt, und wir speichern keinen Verweis darauf, in welcher Sprache sie abgeschlossen wurde. Wenn Sie die Daten des Organizational Reporting-Diensts von Learn in Ihre Lernumgebung integrieren, müssen Sie dies beachten. Wenn Sie die Inhaltsobjekte als separate Objekte laden, müssen Sie außerdem eine Äquivalenz zwischen ihnen implementieren, sodass Benutzer*innen die Schulung unabhängig von der Sprache, in der sie abgeschlossen wird, in den anderen Sprachen angerechnet bekommen und sie nicht wiederholen müssen.

Funktionsweise der Inhaltsversionsverwaltung auf Learn und Wiedergabe in der Organizational Reporting-Ausgabe

Die Inhalte werden ständig aktualisiert. Updates werden in der Regel zweimal täglich veröffentlicht. Dabei kann es sich entweder um geringfügige Änderungen (z. B. kleinere Änderungen am Text) oder um umfangreiche Änderungen (z. B. größere Überarbeitungen, Ergänzungen oder Löschungen) handeln. Allgemein wird das Inhaltsportfolio wie ein umfangreiches, stark reglementiertes Open-Source-Projekt mit Tausenden von Mitwirkenden verwaltet, weshalb ständig Änderungen vorgenommen werden. Wenn Sie die Daten des Organizational Reporting-Diensts von Learn in Ihrem Produktionssystem verwenden, sollten Sie sich darüber im Klaren sein. Außerdem sollte Ihr System in der Lage sein, damit umzugehen.

Wenn neue Inhaltsobjekte hinzugefügt werden, werden sie als neues Objekt (durch die UID identifiziert) in der Antwort angezeigt. Wenn Inhalte geändert werden, können Sie dies anhand des Werts „last_modified“ feststellen. Wenn Inhalt gelöscht wird, wird er aus der Antwort entfernt. Obwohl es manchmal eine leichte Verzögerung beim Aktualisieren von Inhalten in der API-Antwort gibt, werden immer die aktuellsten Informationen angezeigt, wenn Benutzer*innen der URL zum Inhalt folgen. Bei Löschungen leitet die alte URL auf den neuen Inhalt oder die neue Benutzeroberfläche um.

Derzeit gibt es keine Hinweise auf Inhaltsversionen, die über das Datum last_modified hinausgehen.

Grundlegendes zu den Einschränkungen des Organizational Reporting-Diensts

Weitere Informationen zu den Einschränkungen finden Sie im Artikel mit der Übersicht über die Features des Organizational Reporting-Diensts von Learn.

Regelmäßiges Aktualisieren der Daten

Wenn Sie die Kataloginformationen aus den Daten des Organizational Reporting-Diensts von Learn verwenden, um Ihre Geschäftsprozesse zu unterstützen oder um sie Kunden als Teil Ihrer Website anzuzeigen, stellen Sie sicher, dass Sie den Inhalt mindestens einmal am Tag aktualisieren.

Die Inhalte werden ständig aktualisiert. Updates werden in der Regel zweimal täglich veröffentlicht. Dabei kann es sich entweder um geringfügige Änderungen (z. B. kleinere Änderungen am Text) oder um umfangreiche Änderungen (z. B. größere Überarbeitungen, Ergänzungen oder Löschungen) handeln. Allgemein wird das Inhaltsportfolio wie ein umfangreiches, stark reglementiertes Open-Source-Projekt mit Tausenden von Mitwirkenden verwaltet, weshalb ständig Änderungen vorgenommen werden. Wenn Sie die Daten des Organizational Reporting-Diensts in Ihrem Produktionssystem verwenden, sollten Sie sich darüber im Klaren sein. Außerdem sollte Ihr System in der Lage sein, damit umzugehen.

Sicherstellen, dass Ihre verbundenen Microsoft Entra-Informationen regelmäßig aktualisiert werden

Um zu wissen, auf wen sich jeder Vervollständigungsdatensatz bezieht, müssen Sie die Organizational Reporting-Datasetdaten mit Ihren Microsoft Entra-Informationen verknüpfen, sodass Namen zusammen mit den Vervollständigungsdatensätzen angezeigt werden. Wenn Sie Ihre Microsoft Entra-verknüpften Daten nicht aktualisieren, verfügen Sie möglicherweise über Vervolllständigungsdatensätze mit veralteten Personaldaten oder Datensätze, denen fehlende personenbezogene Daten zugeordnet sind.

Verweisen auf die Entwicklerdokumentation

Die Entwicklerdokumentation zum Organizational Reporting-Dienst von Learn enthält eine vollständige Liste der Daten, die als Teil der Antwort bereitgestellt werden, sowie Empfehlungen, wie jedes Feld zur Unterstützung des Lernprozesses verwendet werden sollte.

Nächste Schritte

Weitere Informationen zum Organizational Reporting-Dienst von Learn finden Sie in den folgenden Artikeln: