Qualifikationen können per API aus dem Learn365-Mandanten gelöscht werden. Hierdurch werden diese Informationen vollständig entfernt.
HINWEIS
Wir haben neue Skills-Endpunkte implementiert, die zu gegebener Zeit die entsprechenden Competency-Endpunkte ersetzen werden. Sie können die bisherigen Competency-Endpunkte weiter nutzen, bis sie im Rahmen der Veröffentlichung von Learn365 v3.64 auslaufen. (Diese Veröffentlichung ist gegenwärtig für den 18. August 2025 geplant.)
Wir empfehlen Ihnen, bereits jetzt mit den Planungen für das Auslaufen der Competency-Endpunkte zu beginnen und zu den neuen Skills-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: Anmeldename 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.
Benutzerqualifikation ü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 „benutzer@domäne.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:
- Der 204-Code ohne weitere Parameter im Antworttext signalisiert eine erfolgreich abgerufene Antwort.
- Im Fehlerfall enthält der Antworttext das Objekt error 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.
7. Gehen Sie zu Learn365 Admin Center > Globale Einstellungen > Audit-Trail.
8. Suchen Sie nach dem letzten Datensatz mit dem Aktivitätsnamen Learner skill level was purged und wählen Sie ihn aus, um weitere Informationen anzuzeigen.
Benutzerqualifikation über den Endpunkt Users löschen (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. Wählen Sie im Abschnitt Users den Endpunkt POST /odata/v2/Users(‘{LoginName}’)/PurgeCompetency und klicken Sie oben rechts auf Try it out.
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 kontrollieren:
- Der 202-Code ohne weitere Parameter im Antworttext signalisiert eine erfolgreich abgerufene Antwort.
- Im Fehlerfall enthält der Antworttext das Objekt error 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 > Globale Einstellungen > Audit-Trail.
7. Suchen Sie nach dem letzten Datensatz mit dem Aktivitätsnamen Learner skill level was purged und wählen Sie ihn aus, um weitere Informationen anzuzeigen.
Weitere Informationen zu Audit-Trails finden Sie in diesem Artikel.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.