Benutzer für bestimmte eigenständige Sitzungen und Sitzungsgruppen über die Learn365-API registrieren

Einführung

Es kann vorkommen, dass ein Benutzer in einem von einem Dozenten geleiteten Kurs mit dem Registrierungstyp single- oder multiple- eingeschrieben ist, aber sich noch für keine eigenständigen Sitzungen oder Sitzungsgruppen registriert hat. Sie können die Learn365-API verwenden, um einen Benutzer für eigenständige Sitzungen oder Sitzungsgruppen zu registrieren.

Dieser Artikel beschreibt, wie Sie einen Benutzer für eigenständige Sitzungen oder Sitzungsgruppen registrieren, indem Sie seine Kursregistrierung mit eigenständigen Sitzungen oder Sitzungsgruppen verknüpfen.

Voraussetzungen 

• Der Benutzer, den Sie für bestimmte eigenständige Sitzungen oder Sitzungsgruppen registrieren möchten, sollte bereits über das Learn365 Admin Center in einem von einem Dozenten geleiteten Kurs mit dem Registrierungstyp single- oder multiple- eingeschrieben sein, sich selbst über die Kursstartseite eingeschrieben haben oder über die Learn365-API eingeschrieben sein Dadurch wird der Registrierungsstatus der Registrierung des Benutzers in Learn365 als aktiv oder ausstehend markiert. Das bedeutet, dass er für bestimmte eigenständige Sitzungen oder Sitzungsgruppen registriert werden kann.
   
• Um einen Benutzer über die Learn365-API für bestimmte eigenständige Sitzungen oder Sitzungsgruppen zu registrieren, benötigen Sie seine Registrierungs-ID.

Benutzer für eigenständige Sitzungen oder Sitzungsgruppen registrieren

Sobald ein Benutzer in einem Kurs eingeschrieben ist, können Sie seine Registrierung mit bestimmten eigenständigen Sitzungen oder Sitzungsgruppen dieses Kurses verknüpfen. Je nach Registrierungstyp kann es sich dabei um eine einzelne eigenständige Sitzung bzw. Sitzungsgruppe oder um mehrere Sitzungen bzw. Gruppen handeln.

Um einen Benutzer für eigenständige Sitzungen oder Sitzungsgruppen über die API zu registrieren, gehen Sie wie folgt vor:

1. Suchen Sie den Abschnitt Enrollments und klappen Sie ihn auf. Suchen Sie dann die Methode POST /odata/v2/Enrollments({Id})/AssociateWithCourseSession mit der Beschreibung Associates enrollment with course session(s) und klappen Sie sie auf. Wählen Sie anschließend oben rechts Try it out aus.

2. Füllen Sie den erforderlichen Parameter aus:

• key:Id, in das Sie die ID der Registrierung des Benutzers einfügen. 
• Löschen Sie den Parameter courseSessionId, da er mit dem Release vom August 2022 als veraltet eingestuft wurde.
• Ersetzen Sie beim Parameter "courseSessionIds": "guid" den Wert guid durch die IDs der eigenständigen Sitzungen oder Sitzungsgruppen, für die Sie diesen Benutzer registrieren möchten.

Um einen Benutzer für eine einzelne eigenständige Sitzung oder Sitzungsgruppe für Kurse mit dem Registrierungstyp single- zu registrieren, verwenden Sie die ID der ausgewählten eigenständigen Sitzung oder Sitzungsgruppe.

{
  "courseSessionIds": [
  "d9080ef9-848a-453b-af7e-2aeb7944ac99"
  ]
  }

Um einen Benutzer für mehrere eigenständige Sitzungen oder Sitzungsgruppen in Kursen des Mehrfach-Registrierung-Typs zu registrieren, müssen Sie die ID jeder eigenständigen Sitzung und/oder Sitzungsgruppe hinzufügen, getrennt durch Kommas.

{
  "courseSessionIds": [
  "d9080ef9-848a-453b-af7e-2aeb7944ac99", "f749c75b-335a-4869-a729-b859fbd04d6a"
  ]
  }

Das folgende Bild zeigt eine Beispielanfrage, bei der ein Benutzer für eine eigenständige Sitzung und eine Sitzungsgruppe eines Kurses mit dem Registrierungstyp multiple- registriert wird.

3. Wenn Sie bereit sind, wählen Sie Execute aus, um die Anfrage auszuführen

4. Gehen Sie zum Block Responses, um die Ergebnisse zu kontrollieren:

• Die Zahl 2xx (zum Beispiel „204“) unter Code zeigt an, dass die Anfrage erfolgreich war.

  
  
   

• In diesem Schritt wird der Benutzer für die ausgewählten eigenständigen Sitzungen oder Sitzungsgruppen des Kurses registriert. Um dies zu überprüfen, gehen Sie zum Learn365 Admin Center > wählen Sie den entsprechenden Kurs aus > Manage People > prüfen Sie, ob der erforderliche Benutzer für die entsprechenden eigenständigen Sitzungen oder Sitzungsgruppen registriert ist. 
   
• Sie können diese Daten mit der Option Download im JSON-Format auf Ihr lokales Gerät herunterladen.