Um verschiedene API-Anfragen mit den beteiligten Qualifikationen auszuführen, müssen Sie die ID der betreffenden Qualifikation und die ID der Stufe dieser Qualifikation kennen. Dieser Artikel beschreibt, welche API Sie verwenden, um diese Daten abzurufen.
HINWEIS
Wir haben neue Qualifikationen-Endpunkte implementiert, die letztendlich die entsprechenden Competency-Endpunkte ersetzen werden. Sie können die bisherigen Competency-Endpunkte weiter verwenden, bis wir sie im Rahmen einer zukünftigen Learn365-Version außer Betrieb nehmen.
Wir empfehlen Ihnen, mit der Planung für die Außerbetriebnahme 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 die ID einer Qualifikation mithilfe der neuen wie auch der älteren Endpunkte abruft.
IDs einer Qualifikation und ihrer Stufe über den Endpunkt UserSkills abrufen
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 GET /services/skills/UserSkills aus und klicken Sie dann oben rechts auf Try it out.
3. Wählen Sie Execute aus, um den Befehl auszuführen.
TIPP
Sie können die Parameter der Abfrageoptionen verwenden, um die Daten in der Antwort durch das Festlegen von Filtern zu steuern.
4. Gehen Sie zumBlockResponses, um die Ergebnisse zu kontrollieren:
- Die Zahl 2xx (zum Beispiel 200) unter Code zeigt an, dass die Anfrage korrekt funktioniert hat.
- Im FeldResponse body wird die Liste aller Qualifikationen im Tenant angezeigt.
- Kopieren Sie die erforderlichen Parameter SkillId und LevelId.
- Wählen Sie Download aus, um die Ergebnisse im JSON-Format auf Ihrem Computer zu speichern.
IDs einer Qualifikation und ihrer Stufe über den Endpunkt UserCompetencies abrufen (veraltet)
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 UserCompetencies , erweitern Sie ihn, suchen Sie die GET-Methode /odata/v2/UserCompetencies mit der Beschreibung Returns the list of user competencies (skills) owned by current user und klicken Sie dann oben rechts auf Try it out in der oberen rechten Ecke.
3. Klicken Sie auf Execute, um den Befehl auszuführen.
TIPP
Sie können Competency, User für $expand festlegen, damit die Antwort mehr Details enthält, einschließlich des Namens der Qualifikation und der Nutzer, denen sie zugewiesen ist. Sie können andere Abfrageoptionsparameter verwenden, um die Daten in der Antwort durch das Festlegen von Filtern zu steuern.
4. Gehen Sie zum Responses Block, um die Ergebnisse zu kontrollieren:
- Die Zahl 2xx (zum Beispiel 200) unter Code zeigt an, dass die Anfrage korrekt ausgeführt wurde.
- Im Response body Feld sehen Sie die Liste aller Qualifikationen des aktuell angemeldeten Nutzers.
- Suchen Sie via Ctrl+F nach der URL einer bestimmten Qualifikation. Falls Competency für $expand festgelegt wurde, können Sie die Suche verwenden, um die Qualifikation anhand ihres Titels zu finden. Kopieren Sie die Parameter CompetencyID und LevelId.
- Sie können die Download Option verwenden, um die Ergebnisse im JSON-Format auf Ihrem Computer zu speichern.
Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.