Liste der Zielqualifikationsregeln über die Learn365-API abrufen

Einführung

Über die Learn365-API können Sie eine Liste der auf dem Tenant verfügbaren Zielqualifikationsregeln abrufen.  In diesem Artikel wird beschrieben, wie Sie per API eine Liste der Zielqualifikationsregeln auf dem Tenant abrufen können, sowie Informationen zu einer einzelnen Regel und eine Liste der für bestimmte Lernende definierten Regeln.

Weitere Informationen zu Zielqualifikationsregeln und zur Verwaltung über das Learn365 Admin Center finden Sie in diesem Artikel.

Liste der Zielqualifikationsregeln auf dem Tenant abrufen

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

2. Suchen Sie im Abschnitt TargetSkills den GET-Endpunkt /services/skills/TargetSkills endpoint und wählen Sie oben rechts Try it out aus.

3. Verwenden Sie Abfrageoptionsparameter um die Daten in der Antwort zu steuern.

Wenn Sie keine Abfrageoptionsparameter verwenden, um die Ergebnisse zu filtern, enthält die Antwort Informationen zu allen Zielqualifikationen auf dem Tenant.

Sie können die Ergebnisse wie folgt filtern:

• Id – die ID der Zielqualifikationsregel. Mithilfe der ID können Sie Informationen zu einer einzelnen Zielqualifikationsregel abrufen, indem Sie die GET-API-Anfrage /services/skills/TargetSkills/{id} senden.
• Name – der Titel der Zielqualifikationsregel.
• isGlobal – "isGlobal": true bedeutet, dass die Zielqualifikationsregel für alle Personen in der Organisation definiert ist. Im Feld $filter können Sie beispielsweise isGlobal eq true oder isGlobal eq false eingeben.

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

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

• Ein 200-Code mit einer Liste von Zielqualifikationsregeln im Antworttext weist auf eine erfolgreiche Antwort hin.
• In dem Response body Feld sehen Sie eine Liste aller Zielqualifikationsregeln auf dem Tenant, zusammen mit den Parametern Id, Name und isGlobal. 
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erläutern.

Liste der Ziel-Qualifikationsregeln abrufen, die für bestimmte Benutzer definiert sind

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

2. Suchen Sie im Abschnitt TargetSkills den POST-/services/skills/TargetSkills/ByUsers Endpoint und wählen Sie oben rechts Try it outaus.

3. Geben Sie im Anfragetext die Benutzer-IDs ein. Wie Sie die Benutzer-IDs per API ermitteln, erfahren Sie in diesem Artikel.

Der Anfragetext sollte in etwa wie folgt aussehen:

4. Select Execute, um die Anfrage auszuführen.

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

• Ein 200-Code mit einer Liste von Benutzer-IDs und Ziel-Qualifikationsregeln im Antworttext weist auf eine erfolgreiche Antwort hin.
• Im FeldResponse bodysehen Sie eine Liste von Benutzer-IDs und Ziel-Qualifikationsregeln, die für die Benutzer definiert wurden, sowie eine Liste von Ziel-Qualifikationen, Qualifikationsstufen und anderen Parametern. 
• Im Fehlerfall enthält der Antworttext das Objekt error mit den Schlüsseln code und message, die das Problem erklären.