Benutzerkonten über die Learn365-API zusammenführen

Einführung

Learn365-Benutzerkonten einschließlich aller Lernfortschrittsdaten können über die Learn365-API von einem Konto auf ein anderes zusammengeführt werden. Dieser Artikel beschreibt, welche API-Endpunkte Sie zum Zusammenführen von Benutzerkonten verwenden und welche Folgen das Zusammenführen der Konten hat.

Learn365-Konten per API zusammenführen

Gehen Sie wie folgt vor, um Konten in Learn365 per API zusammenzuführen:

1. Gehen Sie zu https://api.365.systems/ und autorisieren Sie sich mit dem entsprechenden API-Schlüssel. Weitere Informationen zum Autorisierungsvorgang finden Sie hier.

2. Die API, mit der Sie zwei Konten zusammenführen können, erfordert die DirectoryObjectId beider Benutzerkonten. Sie können die DirectoryObjectId-Werte für jeden Benutzer über die GET-Anfrage /odata/v2/Users ermitteln.

Suchen Sie über Strg+F nach den Namen beider Benutzer und kopieren Sie deren DirectoryObjectId.

Mit der Option Download können Sie die Ergebnisse im JSON-Format auf Ihrem Computer speichern.

3. Suchen und erweitern Sie den Abschnitt Users, suchen Sie die POST-Methode /odata/v2/Users('{LoginName}')/Merge mit der Beschreibung Merges user's data und wählen Sie oben links Try it out aus. Der Endpunkt ermöglicht das Speichern der Stammdaten des Hauptkontos und die Schulungsunterlagen beider Konten.

4. Füllen Sie zwei Felder aus:

• key: LoginName – Geben Sie die DirectoryObjectId des Hauptkontos ein, das Sie speichern möchten und das die zusammengeführten Daten vom anderen Konto übernehmen soll. Nach dem Zusammenführen bleiben die Daten des Hauptkontos erhalten, und die Schulungsdatensätze des Sekundärkontos werden in das Hauptkonto integriert.
• "sourceUserLoginName": "string" - Ersetzen Sie string durch die DirectoryObjectId des sekundären Kontos, das Sie mit dem Hauptkonto zusammenführen möchten. Nach dem Zusammenführen der Konten wird das sekundäre Konto von der Seite Users im Learn365 Admin Center entfernt, bleibt jedoch in Microsoft Entra ID bestehen.
  
  

5. Wählen Sie Execute aus, um die Anfrage auszuführen. 

6. Gehen Sie zum Block Responses, um die Ergebnisse zu prüfen:

• Die Zahl 2xx (beispielsweise „204“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body werden Informationen zur Kontenzusammenführung angezeigt.

So beeinflusst eine Zusammenführung Learn365-Rollen und SharePoint-Gruppen

Die beiden zusammenzuführenden Konten können in Learn365 unterschiedliche Rollen innehaben und auf unterschiedliche Gruppen in SharePoint verweisen. Das Zusammenführen von Learn365-Benutzerkonten hat folgende Auswirkungen:

• Wenn die beiden Konten unterschiedliche Rollen aufweisen, erhält das Hauptkonto alle Rollen sowohl des Haupt- als auch des sekundären Kontos. 
• Das sekundäre Konto verliert sämtliche Rollen, aber es kommt zu keinen Änderungen bei den SharePoint-Gruppen, zu denen das sekundäre Konto gehört. Wenn Sie das sekundäre Konto aus einer SharePoint-Gruppe entfernen möchten, müssen Sie dies manuell erledigen.
• Wenn das sekundäre Konto einem Kurs oder Schulungsplan innerhalb einer AD-Gruppe hinzugefügt war, wird die Registrierung auf das Hauptkonto übertragen. Allerdings erhält das Hauptkonto keine Rolle in diesem Kurs oder Schulungsplan.

So beeinflusst eine Zusammenführung Registrierungen

Jeder Benutzer kann nur einmalig für einen Kurs oder Schulungsplan registriert sein. Daher behält das Hauptkonto nach dem Zusammenführen seine eigenen Registrierungsanmeldungen. Zusätzlich erhält es auch diejenigen des sekundären Kontos. Sämtliche Daten, die mit diesen Registrierungsanmeldungen verbunden sind, werden auf das Hauptkonto übertragen.

Waren beide Konten im selben Kurs oder Schulungsplan registriert, dann werden die Registrierungen des sekundären Kontos als abgelaufen auf das Hauptkonto übertragen. Alle Daten und Schulungsunterlagen sind vom Hauptkonto aus einsehbar.

Ein Benutzer kann sich auch nur einmal für eine Kurssitzung registrieren. Nach dem Zusammenführen behält das Hauptkonto seine eigenen Registrierungen für Kurssitzungen bei. Außerdem erhält es auch diejenigen des sekundären Kontos. Sämtliche Daten, die mit diesen Registrierungsanmeldungen verbunden sind, werden auf das Hauptkonto übertragen.

So beeinflusst eine Zusammenführung Zuweisungen

Beim Zusammenführen von Konten behält das Hauptkonto seine eigenen Aufgaben. Zusätzlich erhält es auch diejenigen des sekundären Kontos. Wenn es überschneidende Aufgaben gibt, gehen die Daten und Dokumente des sekundären Kontos nach dem Zusammenführen verloren.