Qualifikationen können per API aus dem Learn365-Mandanten gelöscht werden. Hierdurch werden diese Informationen vollständig entfernt.
HINWEIS
Wir haben neue Qualifikationen-Endpunkte implementiert, die zu gegebener Zeit die entsprechenden Competency-Endpunkte ersetzen werden. Sie können die bisherigen Competency-Endpunkte weiterhin verwenden, bis wir sie im Rahmen eines zukünftigen Learn365-Releases außer Betrieb nehmen.
Wir empfehlen Ihnen, mit der Planung für die Außerkraftsetzung der Competency-Endpunkte zu beginnen und zu den neuen Qualifikationen-Endpunkten zu migrieren. Hierdurch stellen Sie sicher, dass etwaige Probleme oder Fehler, auf die Sie stoßen, bis zum Zeitpunkt des Auslaufens der Endpunkte behoben werden können.
Dieser Artikel beschreibt, wie man eine Qualifikation mithilfe der neuen wie auch der älteren Endpunkte löscht.
HINWEIS
- Sie können sowohl gültige als auch widerrufene Qualifikationen löschen.
- Das Löschen einer Qualifikation in einer mehrstufigen Qualifikationskette führt zur Löschung der gesamten Kette.
Bevor Sie eine Qualifikation löschen, benötigen Sie folgende Parameter:
- LoginName des Benutzers, dessen Qualifikation Sie löschen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.
- skillId oder competencyId. Dies ist die ID der Qualifikation, die Sie löschen möchten. Sie können diese Information per API ermitteln, indem Sie die Schritte in diesem Artikel befolgen.
Qualifikation eines Benutzers über den Endpunkt UserSkills löschen
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}/PurgeSkill und dann oben rechts die Option Try it out aus.
3. Geben Sie im Feld userLoginName den Teil „user@domain.com“ des Benutzeranmeldenamens ein.
4. Geben Sie im Anforderungstext die skillId ein, d. h. die ID der Qualifikation, die Sie löschen möchten.
5. Wählen Sie Execute aus, um die Anfrage auszuführen.
6. Gehen Sie zum Block Response, um die Ergebnisse zu kontrollieren:
- Ein 204 code ohne Parameter im Antworttext bedeutet, dass die Antwort erfolgreich war.
- Im Fehlerfall enthält der Antworttext das error-Objekt mit den Schlüsseln code und message, die das Problem erklären.
Sie können den Audit Trail einsehen, um weitere Informationen zur gelöschten Qualifikation zu erhalten.
7. Gehen Sie zu Learn365 Admin Center > All catalogs > Administration > Audit trail.
8. Suchen Sie den letzten Datensatz mit dem Aktivitätsnamen Learner skill level was purged und wählen Sie ihn aus, um weitere Informationen anzuzeigen.
Qualifikation eines Benutzers über den Endpunkt Users löschen (veraltet)
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 Users den POST-Endpunkt /odata/v2/Users(‘{LoginName}’)/PurgeCompetency aus und wählen Sie oben rechts Try it out aus.
3. Geben Sie LoginName und competencyId ein.
4. Wählen Sie Execute aus, um die Anfrage auszuführen.
5. Gehen Sie zum Block Response, um die Ergebnisse zu überprüfen:
- Ein 202-Code ohne Parameter im Antworttext bedeutet eine erfolgreiche Antwort.
- Im Fehlerfall enthält der Antworttext das error-Objekt mit den Schlüsseln code und message, die das Problem erklären.
Sie können den Audit Trail einsehen, um weitere Informationen über die gelöschte Qualifikation zu erhalten.
6. Gehen Sie zu Learn365 Admin Center > All catalogs > Administration > Audit trail.
7. Suchen Sie den letzten Datensatz mit dem Aktivitätsnamen Learner skill level was purged und wählen Sie ihn aus, um weitere Informationen anzuzeigen.
Weitere Informationen zum Audit Trail finden Sie in diesem Artikel.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.