Ein Zertifikat über die Learn365-API erneut ausstellen

Einführung

Ein Zertifikat, das bereits für einen Kurs oder einen Schulungsplan vergeben wurde, kann erneut ausgestellt oder aktualisiert werden. Das ist besonders nützlich, wenn Sie beispielsweise das Bild aktualisieren möchten, das als Hintergrund für die Zertifikatsvorlage verwendet wird, oder andere Eigenschaften der Zertifikatsvorlage ändern möchten. Das Zertifikatsablaufdatum ändert sich auch für alle aktiven Zertifikate (gültige und ablaufende), die bereits vergeben wurden, wenn deren Ablaufdatum mit PATCH /odata/v2/Certificates({Id}) geändert wurde.

Mit den Learn365-APIs können Sie die Eigenschaften vergebener Zertifikate mit derselben Vorlage oder einer neuen aktualisieren, zum Beispiel wenn das Hintergrundbild eines Zertifikats geändert wurde oder der Vorlagentext angepasst wurde. In diesem Artikel wird beschrieben, wie Sie die Eigenschaften eines vergebenen Zertifikats aktualisieren.

Voraussetzungen 

Um ein Zertifikat zu aktualisieren oder erneut auszustellen, benötigen Sie die folgenden Daten:

• Die eindeutige ID des vergebenen Zertifikats, das Sie erneut ausstellen oder dessen Eigenschaften Sie aktualisieren möchten. 
• Die ID einer Zertifikatsvorlage, die für ein Zertifikat verwendet wird.

Wenn Sie beim Aktualisieren eines Zertifikats oder bei dessen erneuter Ausstellung dieselbe Zertifikatsvorlage verwenden möchten, müssen Sie die ID dieser Vorlage abrufen. Die ID der Zertifikatsvorlage wird in der Antwort angezeigt, wenn Sie die ID eines Zertifikats abrufen (siehe Schritt 1), neben dem Parameter TemplateId.

Sie können die ID einer Zertifikatsvorlage auch abrufen, indem Sie den Schritten aus dem Artikel zum Abrufen der ID des Kurses folgen. In diesem Fall wird, wenn dem Kurs ein Zertifikat zugeordnet ist, die ID der Vorlage in der Antwort neben dem Parameter CertificateTemplateId angezeigt. Wenn einem Kurs derzeit kein Zertifikat zugeordnet ist, zeigt die Antwort null neben dem Parameter CertificateTemplateId.

Wenn Sie beim Aktualisieren eines Zertifikats oder bei dessen erneuter Ausstellung eine andere Zertifikatsvorlage verwenden möchten, müssen Sie die ID der Vorlage aus dem Learn365-Speicher für Zertifikatsvorlagen abrufen.

Gehen Sie wie folgt vor, um die ID einer Zertifikatsvorlage aus dem Vorlagenspeicher abzurufen:

1. Suchen Sie in den Abschnitten CertificateTemplates die GET-Methode /odata/v2/CertificatesTemplates mit der Beschreibung Returns the list of Certificate Templates , erweitern Sie sie und wählen Sie Try it out. aus

2. Nachdem Sie Try it out ausgewählt haben, können Sie Abfrageoptionen eingeben, um die Daten in der Antwort zu filtern.

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

4. Wechseln Sie zum Block Responses, um die Ergebnisse anzuzeigen.

• Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage erfolgreich war. Ü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 zu filtern, können Sie im Feld Response body
  alle Zertifikatvorlagen des Tenants sehen und mithilfe von Strg+F nach einer relevanten Vorlage suchen. Kopieren Sie die ID der Zertifikatvorlage, die neben dem Parameter Id angezeigt wird.

   

  
  
   

• Wenn Abfrageparameter festgelegt wurden, zeigt die Antwort nur die Informationen an, die die festgelegten Bedingungen erfüllen. Kopieren Sie die Zertifikatvorlagen-ID, die neben dem Parameter Id angezeigt wird.

   

  

Ein Zertifikat neu ausstellen oder seine Eigenschaften aktualisieren

Es ist möglich, die Eigenschaften eines Zertifikats (das für den Vorlagenhintergrund verwendete Bild und die Vorlage selbst) teilweise zu aktualisieren oder es neu auszustellen. Der Zertifikatsablauf ändert sich auch für alle aktiven Zertifikate (gültige und ablaufende), die bereits verliehen wurden, wenn ihr Ablaufdatum mit PATCH /odata/v2/Certificates({Id}) geändert wurde.

Führen Sie zu diesem Zweck die folgenden Schritte durch:

1. Gehen Sie zum Abschnitt Certificates, suchen Sie die POST-Methode /odata/v2/Certificates({Id})/Reissue mit der Beschreibung Reissue Certificate und wählen Sie dann Try it out. aus

2. Nachdem Sie Try it out ausgewählt haben, füllen Sie beide erforderlichen Felder aus:

• Geben Sie im Feld key: Id die ID des verliehenen Zertifikats ein, das Sie teilweise aktualisieren oder neu ausstellen möchten.
• Ersetzen Sie im Feld Edit Value die string neben dem Parameter "templateId" durch die ID der Zertifikatvorlage, die Sie für das Zertifikat verwenden möchten.

3. Select Ausführen, um die Anfrage auszuführen.

4. Wechseln Sie zum Block Responses, um die Ergebnisse anzuzeigen.

Die Zahl 2xx (beispielsweise „204“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.

Zur Überprüfung des Ergebnisses wechseln Sie zum Learn365 Admin Center > wählen Sie einen Katalog > Benutzer und Gruppen > Benutzer > wählen Sie den entsprechenden Benutzer aus > Zertifikate herunterladen und suchen Sie im heruntergeladenen Dokument das entsprechende Zertifikat.

Eine weitere Möglichkeit, das Zertifikat zu prüfen, ist, zum Learn365 Admin Center > einen Katalog auswählen > Benutzer und Gruppen > Benutzer > relevanten Benutzer auswählen > Fortschritt des Lernenden anzeigen > die Schulung suchen, mit der das Zertifikat verknüpft ist > das Augensymbol neben der Schulung auswählen > das Pfeilsymbol auswählen, um das Zertifikat als PDF-Datei herunterzuladen und zu öffnen.
 

Hier ist ein Beispiel für ein aktualisiertes Zertifikat, bei dem das Hintergrundbild und der Text geändert wurden.