Benutzerqualifikationen über die Learn365-API widerrufen

Qualifikationen eines Benutzers können per Learn365-API widerrufen werden.

Dieser Artikel beschreibt, wie man die ID einer Qualifikation mithilfe der neuen wie auch der älteren Endpunkte abruft.

Benutzerqualifikation über den Endpunkt UserSkills widerrufen

Bevor Sie eine Qualifikation widerrufen, benötigen Sie folgende Parameter:

• courseCatalogId - die ID des Kurskatalogs, der die Qualifikation enthält, die Sie widerrufen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.
• userLoginName des Benutzers, dessen Qualifikation Sie widerrufen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.
• skillId and levelId - die ID der Qualifikation und der Stufe, die Sie widerrufen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.

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

2. Suchen Sie im Abschnitt UserSkills den Endpunkt POST services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/RevokeSkill und wählen Sie oben rechts Try it out aus.

3. Geben Sie die courseCatalogId. 
 

4. Geben Sie im Feld userLoginName den Teil „user@domain.com“ des Benutzeranmeldenamens ein.

5. Geben Sie im Anfrage-Body Folgendes ein:

• skillId GUID-Parameter.
• levelId GUID-Parameter.

6. Wählen Sie die Schaltfläche Execute aus, um die Anfrage auszuführen.

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

• Die Zahl 2xx (beispielsweise „200“) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
• Im Feld Response body werden die Ergebnisse der Anfrage angezeigt, einschließlich Datum und Uhrzeit des Qualifikationswiderrufs.
• Die Qualifikation des Benutzers wird auf der von Ihnen angegebenen Ebene widerrufen. Die Qualifikation wird als Widerrufen im Learn365 Admin Center > Katalog auswählen > Benutzer und Gruppen > Benutzer > Lernende/-n auswählen > Transcript der/des Lernenden anzeigen > Qualifikationen sowie im Mein Schulungs-Dashboard der/des Lernenden > Transcript > Qualifikationen markiert. Der Lernende/Die Lernende erhält außerdem eine Skill revoked-Benachrichtigung.

Sie können den Audit Trail einsehen, um weitere Informationen über die widerrufene Qualifikation zu erhalten.

8. Gehen Sie zu Learn365 Admin Center > All catalogs > Administration > Audit trail.

9. Suchen Sie nach dem letzten Datensatz mit dem Aktivitätsnamen Skill was revoked from learner und wählen Sie ihn aus, um weitere Informationen anzuzeigen.

Qualifikation eines Benutzers per API über den Endpunkt Users widerrufen (veraltete Vorgehensweise)

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

2. Suchen Sie den Abschnitt Users, erweitern Sie ihn, suchen Sie nach POST /odata/v2/Users('{LoginName}')/RevokeCompetency mit der Beschreibung Revokes competency (skill) und wählen Sie dann oben rechts Try it out aus.

3. Nachdem Sie Try it out ausgewählt haben, werden zwei Felder angezeigt. Sie müssen die Pflichtparameter ausfüllen:

• key: LoginName hier müssen Sie den Anmeldenamen des Benutzers eingeben, dem Sie eine Qualifikation widerrufen möchten.
• "competencyId": "string" where you need to replace the string durch die ID der Qualifikation, die Sie von einem Benutzer entfernen möchten.
• "competencyLevelId": "string" where you need to replace the string durch die ID der Qualifikationsstufe.

Die erforderlichen competencyId and  competencyLevelId können Sie über die Learn365 API ermitteln.

4.  Wählen Sie die Schaltfläche Execute aus, um den Befehl auszuführen.

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

• Die Zahl 2xx (z. B. 200) unter Code zeigt an, dass die Anfrage erfolgreich war.
• Im Feld Response body werden die Ergebnisse der Anfrage angezeigt, einschließlich Datum und Uhrzeit des Qualifikationswiderrufs. Die Qualifikation der entsprechenden Stufe wird dem Benutzer entzogen. Dies kann im Learn365 Admin Center sowie im Benutzereintrag Transkript des Mein Schulungs-Dashboard überprüft werden, wo die Qualifikation als Widerrufen gekennzeichnet ist. Der Benutzer erhält eine Benachrichtigung über den Qualifikationswiderruf.