Aus bestimmten Gründen müssen Sie möglicherweise die ID eines Zertifikats abrufen. In diesem Artikel werden die Schritte beschrieben, wie Sie diese ID mithilfe eines Learn365-API-Endpunkts erhalten. Mithilfe dieser API können Sie auch die ID der für das Zertifikat verwendeten Vorlage abrufen.
So rufen Sie die ID eines Zertifikats in Learn365 ab:
1. Rufen Sie https://api.365.systems/ auf und melden Sie sich an. Weitere Informationen zum Autorisierungsvorgang finden Sie hier.
2. Suchen Sie den Abschnitt Certificates , erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/Certificates mit der Returns the list of Certificates owned by current user Beschreibung und wählen Sie dann oben links Try it out aus.
Sie können Abfrageoptionsparameter verwenden, um die Daten in der Antwort durch das Festlegen von Filtern zu steuern. Die Kombination mehrerer Filter kann Ihnen helfen, die Antwort einzugrenzen und das relevante Zertifikat zu finden.
BEISPIELE
- Um die für einen bestimmten Kurs vergebene Zertifikatvorlage leichter zu finden, geben Sie in $expand enter Course. Nachdem Sie Execute ausgewählt haben, enthält die Antwort Kurstitel, und Sie können Cntr+F verwenden, um nach einem relevanten Kurs zu suchen und die ID der für diesen Kurs verwendeten Zertifikatvorlage abzurufen.
- Um eine Liste der Kurse oder Schulungspläne abzurufen, die in ihren Einstellungen eine bestimmte Zertifikatvorlage konfiguriert haben, geben Sie in $filter Title eq 'certificate's template' ein, wobei certificate template durch den relevanten Titel der Zertifikatvorlage ersetzt wird (Sie finden ihn beispielsweise im Abschnitt Certificate Templates im Learn365 Admin Center). Nachdem Sie Execute ausgewählt haben, zeigt die Antwort nur die Kurse oder Schulungspläne an, in deren Einstellungen diese Zertifikatvorlage konfiguriert ist.
- Um eine Liste der einem bestimmten Benutzer zugewiesenen Zertifikate abzurufen, geben Sie im Feld $filter UserId eq ID des Benutzers ein, z. B. UserId eq 7af3f4b0-65dc-4dfd-a4dc-287733b61e6d.
- Um eine Liste der Zertifikate abzurufen, die einem bestimmten Kurs zugeordnet sind, geben Sie im Feld $filter CourseId eq ID des Kurses ein, z. B. CourseId eq 6bf3f3b0-65dc-4dfd-a4dc-287733b61e6d.
- Eine Kombination aus UserId und CourseID liefert Ihnen in der Antwort nur alle Zertifikate des Benutzers für einen bestimmten Kurs. In diesem Fall enthält die Anfrage beide Parameter im Feld $filter mit and dazwischen, z. B. UserId eq 7af3f4b0-65dc-4dfd-a4dc-287733b61e6d and CourseId eq 6bf3f3b0-65dc-4dfd-a4dc-287733b61e6d.
3. Wählen Sie Execute aus, um die Anfrage auszuführen.
4. Gehen Sie zum Block Responses, um die Ergebnisse zu kontrollieren:
- Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat. Über Download können Sie die Daten aus der Antwort im .JSON-Format auf Ihren Computer herunterladen.
- Wenn keine Abfrageparameter festgelegt wurden, um die Antwort einzugrenzen, können Sie im Feld Response body alle Zertifikate des Tenants und deren Daten einschließlich der ID sehen. Suchen Sie mit Strg+F nach einem bestimmten Zertifikat, um dessen ID zu finden und sie zum Kopieren dort zu verwenden, wo Sie sie benötigen.
-
Wenn Abfrageparameter festgelegt wurden, zeigt die Antwort nur die durch die Abfrageparameter eingeschränkten relevanten Informationen an. Die ID des Zertifikats wird jedoch unabhängig von den Parametern angezeigt, die zur Einschränkung der Antwort festgelegt wurden.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.