Ein Zertifikat über die Learn365-API verleihen

Zertifikate können verwendet werden, um Lernende zu belohnen, nachdem sie einen Kurs oder Schulungsplan abgeschlossen haben. Es kann jedoch Fälle geben, in denen Benutzer einen Kurs oder Schulungsplan bereits abgeschlossen haben, bevor ein Zertifikat dafür existierte. In diesem Fall kann solchen Benutzern ein Zertifikat über die Option Externe Schulung importieren im Learn365 Admin Center oder über einen Learn365-API-Endpunkt zuerkannt werden.

In diesem Artikel beschreiben wir, wie Sie ein Zertifikat über die Learn365-API vergeben.

Gehen Sie wie folgt vor, um ein Zertifikat über die Learn365-API zu vergeben:

1. Gehen Sie zu https://api.365.systems/, und vergewissern Sie sich, dass Sie mit dem entsprechenden API-Schlüssel autorisiert sind.

2. Wählen Sie im Abschnitt Certificates den Endpunkt /odata/v2/Certificates aus und wählen Sie oben rechts Try it out aus. 

3. Im Feld Edit Value sehen Sie, welche Parameter beim Erstellen eines Zertifikats verwendet werden kf6nnen:

• Id sollte gelöscht werden, da die ID eines Zertifikats erst nach der Verleihung abgerufen wird. 
• CourseId, ein erforderlicher Parameter. Ersetzen Sie guid durch die ID des Kurses, der mit dem Zertifikat verknüpft ist.
• ContentUrl sollte gelöscht werden, da die URL eines Zertifikats erst nach der Verleihung von Learn365 generiert wird.
• IsGenerated sollte gelöscht werden, da der Wert von Learn365 eingetragen wird, nachdem ein Zertifikat aus der Vorlage generiert wurde.
• Status ist ein optionaler Parameter. Ersetzen Sie integer durch eine Zahl, die den Zertifikatsstatus angibt. Gültige Werte sind 0 (Gültig), 1 (Bald ablaufend) und 2 (Abgelaufen).
• Issued, ein erforderlicher Parameter. Hier wird automatisch der aktuelle Zeitpunkt (als Datum und Uhrzeit) eingetragen, die Angabe kann aber manuell geändert werden.
• Expiry ist ein optionaler Parameter. Hier wird automatisch der aktuelle Zeitpunkt (als Datum und Uhrzeit) eingetragen, die Angabe kann aber manuell geändert werden.
• TemplateId, ein erforderlicher Parameter, wenn Sie eine PDF-Datei ffcr ein Zertifikat erstellen mf6chten; andernfalls kann er weggelassen werden und es wird nur ein Datensatz ffcr einen Benutzer erstellt. Ersetzen Sie guid durch die ID einer Zertifikatsvorlage, die Sie für das Zertifikat verwenden möchten. Informationen zum Abrufen der ID einer Vorlage finden Sie in diesem Artikel.
• UserId, ein erforderlicher Parameter. Ersetzen Sie guid durch die ID des Benutzers, dem Sie das Zertifikat verleihen möchten.
• UserLoginName ist ein optionaler Parameter. Ersetzen Sie string durch den Anmeldenamen des Benutzers. Der Anmeldename des Benutzers kann auf die gleiche Weise wie die oben beschriebene UserId abgerufen werden.

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

5. Gehen Sie zum Block Responses, um die Ergebnisse zu überprüfen:

• Die Zahl 2xx (zum Beispiel „202“) unter Code zeigt an, dass die Anfrage erfolgreich war.
• Im Response body -Feld wird das verliehene Zertifikat mit den festgelegten Parametern angezeigt. Neben dem Wertparameter wird die eindeutige ID des verliehenen Zertifikats angezeigt. Das Zertifikat kann auch im Transcript des Benutzers im Learn365 Admin Center sowie im Fortschritt des Benutzers überprüft werden.
• Sie können die Option Download verwenden, um die Ergebnisse im .JSON-Format auf Ihrem Computer zu speichern.