Verwenden der Mitarbeiterlern-API für die Integration in Viva Learning

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Viva Learning ist ein zentralisierter Lernhub für Mitarbeiter in Microsoft Teams, mit dem Mitarbeiter lernen und Fähigkeiten in ihren Arbeitstag integrieren können. In Viva Learning können Teams Inhaltsbibliotheken, die von ihren organization und Partnern bereitgestellt werden, entdecken, freigeben, empfehlen und lernen. Sie können schnell auf zugewiesene oder kürzlich abgeschlossene Lerninhalte zugreifen und dies alles tun, ohne Microsoft Teams zu verlassen.

Mit der Mitarbeiterlern-API in Microsoft Graph können Apps Inhalte aus einem Learning Management System (LMS) oder Lernanbieter in Viva Learning verfügbar machen. Verwenden Sie die folgenden Ressourcen für die Integration in Viva Learning:

• Lernanbieter zum Verwalten von Lernanbietern, einschließlich Registrierung und Löschung von Anbietern.
• Lerninhalte zum Hochladen und Verwalten von Metadaten von Lerninhalten von Ihrem LMS oder Lernanbieter in Viva Learning.
• Lernkursaktivitäten zum Hochladen und Verwalten von Kursaktivitätsdatensätzen für Lernende von Ihrem LMS oder Lernanbieter in Viva Learning.

Wie funktionieren Integrationen?

Als Administratoren können Sie Ihre Inhalte und Lerndatensätze (Mitarbeiterzuweisungen und abgeschlossene Kursdatensätze) von Ihrem LMS oder Lernanbieter in Viva Learning integrieren, indem Sie sofort einsatzbereite Integrationen verwenden, bei denen Viva Learning Inhaltsmetadaten und Lerndatensätze von Ihrem LMS oder Lernanbieter abrufen können. Sie können auch die Mitarbeiterlern-API in Microsoft Graph verwenden, um Inhaltsmetadaten von Ihrem LMS oder Lernanbieter in Viva Learning zu pushen.

Wenn die Inhaltsmetadaten, Mitarbeiterzuweisungen und ihre abgeschlossenen Kursdatensätze in Viva Learning hochgeladen werden, werden sie in Viva Learning an den folgenden Speicherorten angezeigt:

• Wenn die Inhaltsmetadaten synchronisiert werden, wird der Inhalt auf der Startseite unter dem Abschnitt Kurse durchsuchen – Anbieter angezeigt.
• Wenn die Lernkursaktivitäten synchronisiert werden, werden Aufgaben, Empfehlungen und selbstlernende Kursdatensätze auf der Registerkarte Mein Lernen angezeigt. Basierend auf dem Fortschritt wechselt der status von In Bearbeitung zu Abgeschlossen.

Die Lernkursaktivitäten für die Lernenden können über APIs außerhalb von Viva Learning entdeckt werden.

Authorization

Mit den entsprechenden delegierten Berechtigungen oder Berechtigungen für das Lernen von Anwendungsmitarbeitern kann Ihre App die Mitarbeiterlern-API verwenden, um Lernanbieter und deren Inhalte für einen Lernhub in einem Mandanten zu verwalten. Weitere Informationen zu Zugriffstoken, App-Registrierung und delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Grundlagen zu Authentifizierung und Autorisierung.

Anwendungsfälle für die Mitarbeiterlern-API in Microsoft Graph

Verwenden Sie die Mitarbeiterlern-APIs, um Folgendes auszuführen:

• Verwalten von Lernanbietern:
  • Registrieren Sie einen Anbieter mit Viva Learning, geben Sie einen Anzeigenamen, ein quadratisches Logo, das auf einem Lerninhalt Karte angezeigt wird, und ein langes Logo an, das auf der Detailseite angezeigt wird. Dies ist erforderlich, damit der Anbieterinhalt in Viva Learning angezeigt wird. Die zurückgegebene Registrierungs-ID kann verwendet werden, um die nachfolgenden Aufrufe für die Inhaltserfassung zu tätigen.
  • Rufen Sie die Details zu einem Anbieter in Viva Learning für eine bestimmte registrationId ab. 
  • Rufen Sie die Liste der Anbieterregistrierungen in Viva Learning für einen Mandanten ab.
  • Löschen Sie eine Registrierung eines Anbieters in Viva Learning.
• Create und Verwalten von Lerninhalten:
  • Übertragen Sie Inhaltsmetadaten per Push an Viva Learning, um Inhalte in Viva Learning zur Nutzung durch Benutzer zur Verfügung zu stellen. 
  • Rufen Sie mithilfe der registrationId eines Anbieters eine Liste der Metadaten des erfassten Inhalts eines Anbieters ab. 
  • Rufen Sie die angegebenen Metadaten der erfassten Inhalte eines Anbieters in Viva Learning ab.
  • Löschen Sie die angegebenen Metadaten der erfassten Inhalte eines Anbieters.
• Create und Verwalten von Lernkursaktivitäten:
  • Abrufen der Liste der Kurse für einen Benutzer
  • Create eine neue Lernkursaktivität in Viva Learning.
  • Rufen Sie Details zur Lernkursaktivität mithilfe von learningCourseActivityId ab.
  • Aktualisieren Sie Details der Lernkursaktivität mithilfe von learningCourseActivityId.
  • Lernkursaktivität löschen

Nächste Schritte

• Aktivieren Sie das Lernen von Mitarbeitern mithilfe der Funktionen für die Zusammenarbeit in Teams.
• Testen Sie die Mitarbeiterlern-API im Graph-Explorer.