Benutzerqualifikationen per 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: 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: Anmeldename 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 und levelId: ID der Qualifikation und der Qualifikationsstufe, 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. Wählen Sie im Abschnitt UserSkills den Endpunkt POST /services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/RevokeSkill und dann oben rechts die Option Try it out aus.

3. Tragen Sie courseCatalogId
ein.

4. Geben Sie im Feld userLoginName den Teil „benutzer@domäne.com“ des Benutzeranmeldenamens ein.

5. Geben Sie im Anfragetext Folgendes ein:

• skillId: GUID-Parameter
• levelId: GUID-Parameter

 

 

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

7. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:

• 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. Dies umfasst Datum und Uhrzeit des Qualifikationswiderrufs.
• Die Qualifikation des Benutzers wird auf der von Ihnen angegebenen Ebene widerrufen. Die Qualifikation wird als Widerrufen angezeigt, wenn Sie Learn365 Admin Center > Benutzer > Lernenden auswählen > Aufzeichnung des Kursteilnehmers anzeigen > Qualifikationen auswählen. Gleiches gilt im Abschnitt Mein Schulungs-Dashboard > Aufzeichnung > Qualifikationen des Lernenden. Der Lernende erhält ferner die Benachrichtigung „Qualifikation wurde widerrufen“.

 

 

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

8. Gehen Sie zu Learn365 Admin Center > Globale Einstellungen > 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.

 

 

Benutzerqualifikation 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 und erweitern Sie den Abschnitt Users, suchen Sie die Methode POST /odata/v2/Users('{LoginName}')/RevokeCompetency mit der Beschreibung Revokes competency (skill) und wählen Sie oben rechts Try it out aus.

 

 

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

• key: LoginName: Hier geben Sie den Anmeldenamen des Benutzers ein, für den Sie eine Qualifikation widerrufen möchten.
• "competencyId": "string": Hier müssen Sie string durch die ID der Qualifikation ersetzen, die Sie dem Benutzer entziehen möchten.
• "competencyLevelId": "string": Hier müssen Sie String durch die ID der Qualifikationsstufe ersetzen.

Die Angaben für competencyId und competencyLevelId können Sie mithilfe der Learn365-API ermitteln.

 

 

4. Wählen Sie Execute aus, um die Anfrage auszuführen.

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

• 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. Dies umfasst Datum und Uhrzeit des Qualifikationswiderrufs. Die Qualifikation der entsprechenden Stufe wird dem Benutzer entzogen. Dies kann im Learn365 Admin Center sowie in den Aufzeichnungen des Benutzers in Mein Schulungs-Dashboard überprüft werden: Hier ist die Qualifikation jeweils als Widerrufen ausgewiesen. Der Benutzer erhält außerdem eine Benachrichtigung über den Qualifikationswiderruf.