Benutzerkonten in Learn365 per API zusammenführen

Einführung

Learn365-Benutzerkonten einschließlich aller Lernfortschrittsdaten können über die Learn365-API mit einem anderen Konto zusammengeführt werden. Dieser Artikel beschreibt, welche API-Endpunkte für das Zusammenführen von Benutzerkonten verwendet werden und welche Auswirkungen der Vorgang Hostadresse.

 

 

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. Von der API, mit der Sie zwei Konten zusammenführen können, werden die DirectoryObjectId-Werte beider Benutzerkonten benötigt. Sie können die DirectoryObjectId-Werte für die jeweiligen Benutzer über die Anfrage GET /odata/v2/Users ermitteln.

Suchen Sie über die Tastenkombination STRG+F nach den Namen der beiden Benutzer und kopieren Sie deren DirectoryObjectId-Wert.

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: Hier geben Sie die DirectoryObjectId des Hauptkontos ein, das Sie speichern möchten und das die zusammengeführten Daten vom anderen Konto erben 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 Benutzer im Learn365 Admin Center entfernt, während es in Microsoft Entra ID (vormals Azure Active Directory) bestehen bleibt.
  
  

 

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

6. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• 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. 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.

 

So beeinflusst eine Zusammenführung Zuweisungen

Beim Zusammenführen von Konten behält das Hauptkonto seine eigenen Zuweisungen. Zusätzlich erhält es auch diejenigen des sekundären Kontos. Bei identischen Zuweisungen gehen Daten und Dokumente des sekundären Kontos nach dem Zusammenführen verloren.