Mehrere Organisationen (Umgebungen) in einem einzigen Tenant 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 Entwicklertools > Netzwerk und lassen Sie sie offen.

2. Melden Sie sich im Learn365 Admin Center an.

3. Wählen Sie auf der Registerkarte Entwicklertools > Netzwerk die AccessTokens-Anfrage aus, öffnen Sie die Vorschau-Registerkarte und erweitern Sie die zweite Zeile. Klicken Sie mit der rechten Maustaste auf die Eigenschaft accessToken und wählen Sie dann 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 und den Wert Bearer {{Access Token}} enthalten. Wenn Sie die Anfrage über Postman senden, gehen Sie auf der Registerkarte Autorisierung 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 erfolgreiche Anfrage lautet die Antwort 200, gefolgt von einem Array von Umgebungen im Text. Jede Umgebung enthält die folgenden Parameter:

• id: Umgebungs-ID
• tenantId: Tenant-ID
• provisioningStatus: Umgebungsstatus Der Status Finished zeigt, dass die Umgebung aktiv ist und verwendet werden kann.
• 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": "Finished",
    "installationStatuses": [
     {
      "serviceName": "Lms",
      "installationStatus": "Finished"
     }
    ],
"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 die gleiche Anfrage, die Sie verwendet haben, um eine Liste mit Umgebungen anzuzeigen, ersetzen aber GET mit der POST-Methode.

Bei einer erfolgreiche Anfrage lautet die Antwort 202 und enthält keinen Text.

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 die gleiche Anfrage, die Sie verwendet haben, um die Liste mit Umgebungen aufzurufen und lesen Sie den Text. Wenn provisioningStatus Finishedlautet, 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 zu diesem Zweck die gleiche Anfrage senden, die Sie verwendet haben, um die Liste mit Umgebungen aufzurufen, und dann den id-Parameter im Text auffinden.

Dann können Sie die Umgebungs-ID verwenden, um die URL des Learn365 Admin Centers 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 Name Ihres Learn365 Admin Centers
• 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 Organisationsinformationen 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 zur Aktivierung des Abonnement-Schlüssels in diesem Artikel.

Danach können Sie:

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

Um die Sichtbarkeit der Benutzer und Benutzergruppen, u. a. auch für Microsoft Entra (Azure Active Directory)-Gruppen zwischen den Organisationen und Kurskatalogen festzulegen, verwenden Sie die APIs für Gruppenbeschränkungen.