Mehrere Organisationen (Umgebungen) innerhalb eines einzelnen Learn365-Tenants einrichten

Mit Learn365 können Sie mehrere Organisationen (Umgebungen) in einem einzigen TenantLearn365 erstellen. Obwohl sich die Organisationen im gleichen Tenant befinden, haben sie dennoch unterschiedliche, von einander getrennte Datenbanken und API-Schlüssel. Sie können daher separat verwaltet werden.

Dieser Artikel beschreibt die Schritte zur Erstellung einer neuen Organisation (Umgebung).

Zugriffstoken abrufen

Sie brauchen einen Zugriffstoken, wenn Sie eine Liste der vorhandenen Umgebungen anzeigen oder eine neue erstellen möchten. Gehen Sie dazu wie folgt vor:

1. Öffnen Sie in Ihrem Webbrowser die Registerkarte Developer Tools > Network und lassen Sie sie geöffnet.

2. Melden Sie sich im Learn365 Admin Center an.

3. Suchen und wählen Sie in der Registerkarte Developer Tools > Network die Anfrage AccessTokens aus, öffnen Sie die Registerkarte Vorschau und erweitern Sie die zweite Zeile. Klicken Sie mit der rechten Maustaste auf die Eigenschaft accessToken und wählen Sie Wert kopieren.

Eine Liste der Umgebungen anzeigen

Um eine Liste der bestehenden Umgebungen für Ihren Tenant anzuzeigen, senden Sie diese API-Anfrage:

Methode: GET

URL: https://api.365.systems/services/tenants/api/v1/tenant/{{tenantId}}/environment

Pfadparameter:

Header: Der Header muss die Eigenschaft Authorization mit dem Wert Bearer {{Access Token}} enthalten. Wenn Sie die Anfrage über Postman senden, gehen Sie auf der Registerkarte Authorization Ihrer Anfrage wie folgt vor:

1. Wählen Sie in der Liste Auth Type die Option Bearer Token.

2. Fügen Sie das Zugriffstoken in das Feld Token ein.

Bei einer erfolgreichen Anfrage lautet die Antwort 200 und der Antworttext enthält ein Array von Umgebungen. Jede Umgebung enthält die folgenden Parameter:

• id: Umgebungs-ID.
• tenantId: Tenant-ID.
• provisioningStatus: Status der Umgebung. Der Status Finished bedeutet, dass die Umgebung aktiv und einsatzbereit ist.
• installationStatuses: Das Array enthält die Parameter serviceName (Name des Installationsservice) und installationStatus (aktueller Status der Installation).
• modifiedAt: Datum und Uhrzeit der letzten Umgebungsänderung.
• createdAt: Datum und Uhrzeit der Erstellung der Umgebung.
• modifiedByUserLogin: Der globale Administrator von Microsoft365, der die Umgebung zuletzt geändert hat.
• createdByUserLogin: Der globale Administrator von Microsoft365, der die Umgebung erstellt hat.

Der Antworttext sieht in etwa wie folgt aus:

[
  {
    "id": "d19794e8feb24fda8ddb7ef054c4bd6d ",
    "tenantId": "4654c20b93264c7eb10c583d74976d59",
    "provisioningStatus": "Abgeschlossen",
    "installationStatuses": [
     {
      "serviceName": "LMS",
      "installationStatus": "Abgeschlossen"
     }
    ],
    "modifiedAt": "2025-01-23T12:05:27.4060578",
    "createdAt": "2025-01-23T12:05:27.4060624",
    "modifiedByUserLogin": "test@test.com",
    "createdByUserLogin": "test@test.com"
  },
]

Umgebung erstellen

Um eine Umgebung zu erstellen, senden Sie dieselbe Anfrage, die Sie verwendet haben, um eine Liste von Umgebungen anzuzeigen, aber mit der POST-Methode statt GET.

Bei einer erfolgreichen Anfrage wird die Antwort 202 mit einem leeren Text zurückgegeben.

Den Status der neuen Umgebung prüfen

Da das Erstellen einer Umgebung einige Zeit in Anspruch nehmen kann, ist es ratsam, den Status der Umgebung zu verfolgen. Senden Sie dazu dieselbe Anfrage, die Sie verwendet haben, um eine Liste von Umgebungen anzuzeigen, und prüfen Sie den Antworttext. Wenn provisioningStatus Finished lautet, ist die neue Umgebung einsatzbereit.

Die neue Umgebung aktivieren

Um das Learn365 Admin Center für die neue Umgebung zu öffnen, benötigen Sie die Umgebungs-ID. Sie können sie erhalten, indem Sie dieselbe Anfrage senden, die Sie verwendet haben, um eine Liste von Umgebungen anzuzeigen, und den Parameter id im Antworttext prüfen.

Dann können Sie die Umgebungs-ID verwenden, um die URL des Learn365 Admin Center zu bilden. Die URL hat folgende Struktur:

https://{Domain Name}/tenant/{{Tenant ID}}/env/{{Environment ID}}/global

Nehmen wir an:

• test.365.systems ist der Domainname Ihres Learn365 Admin Center.
• 4654c20b93264c7eb10c583d74976d59 ist Ihre Tenant-ID.
• 0081fd9daaf14ec6a41768932567577e ist Ihre Umgebungs-ID.

In diesem Fall kopieren Sie die folgende URL in die Adressleiste Ihres Browsers:

https://test.365.systems/tenant/4654c20b93264c7eb10c583d74976d59/env/0081fd9daaf14ec6a41768932567577e/global

Sie werden zur Seite Organization Information weitergeleitet, wo Sie die erforderlichen Informationen ausfüllen und das Abonnement für die neue Organisation aktivieren müssen. Weitere Informationen zu dieser Seite finden Sie im Abschnitt Subscription key activation in diesem Artikel.

Danach können Sie:

• LMS-Administratoren hinzufügen zur neuen Organisation.
• API-Schlüssel erstellen für die neue Organisation.

Um die Sichtbarkeit der Benutzer und Benutzergruppen, einschließlich der Microsoft Entra-Gruppen, zwischen Organisationen und Kurskatalogen zu steuern, verwenden Sie die APIs für Gruppenbeschränkungen.

Zwischen Umgebungen wechseln

Erforderliche Rolle: LMS-Administrator.

LMS-Administratoren, die zwei oder mehr Umgebungen in einem Tenant verwalten, können zwischen diesen wechseln.

1. Navigieren Sie zum Learn365 Admin Center > Globale Einstellungen. Die Seite Kurskatalogverwaltung öffnet sich. Das Dropdownmenü Environment ID oben auf dem Bildschirm zeigt alle Umgebungen an, die Sie verwalten.

2. Wählen Sie im Dropdownmenü Environment ID die ID der Umgebung aus, zu der Sie wechseln möchten. Die ausgewählte Umgebung wird auf der Seite Kurskatalogverwaltung angezeigt.