【API】 ユーザーのスキルの取り消し

  • 更新

Learn365では、Learn365 管理センター、または Learn365 API を通じて、ユーザーのスキルを取り消すことができます。

ここでは、Learn365 API を通じて、ユーザーのスキルを取り消す手順を説明します。

注記:

従来の Competencies 関連のエンドポイントは、今後の Learn365 リリースで廃止される予定です。新しい Skills エンドポイントへの移行を推奨します。

 

ユーザーのスキルを取り消すには、以下の情報が必要です。

UserSkills セクションで取り消す

手順:

1.https://api.365.systems/  にアクセスし、API キーで認証します。

2.UserSkills セクションに移動し、

POST /services/skills/catalog/{courseCatalogId}/UserSkills/User/{userLoginName}/RevokeSkill
Revoke skill(s) of a specific user

を選択し、右上の[Try it out]をクリックします。

3.パラメータを入力します。

revoke_skill_swagger.png

 

4.[Execute]を選択してリクエストを実行します。

5.Responses ブロックで結果を確認します。

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body では、リクエストの結果が表示され、スキルの取り消し日時を確認できます。
  • Learn365 管理センター、およびトレーニング ダッシュボードの「スキル」セクションで、取り消されたスキルを確認できます。ユーザーにはスキルの失効に関する通知が送信されます。

revoke skills_userskills_endpoint.png

 

Learn365 管理センター>グローバル設定>「監査証跡」で、スキルの取り消しに関する詳細な情報を確認することができます。

フィルター パネルの「活動」フィールドで「受講者のスキルが取り消されました」を選択し適用します。検索結果で該当するレコードを選択すると、詳細情報が表示されます。

revoke skills_userskills_endpoint-2.jpg

 

Learn365 監査証跡については、こちらをご覧ください。

 

Users セクションで取り消す(従来)

注意!Users セクションのエンドポイントは、今後の Learn365 リリースで廃止される予定です。

手順:

1.https://api.365.systems/  にアクセスし、API キーで認証します。

2.Users セクションに移動し、 POST /odata/v2/Users('{LoginName}')/ RevokeCompetency Revokes competency (skill)  を選択し、右上の[Try it out]をクリックします。

Revoke user's skills via API1.png

 

3.パラメータを入力します。

  • LoginName:「Key:LoginName」フィールドに、対象ユーザーのログイン名を入力します。
  • parameters:「Edit Value」フィールドで、以下を入力します。
    • "competencyId": "string" :「string」を、ユーザーから削除するスキルのIDに置き換えます。
    • "competencyLevelId": "string" :「string」を、ユーザーから削除するスキルのスキルレベルIDに置き換えます。

スキル ID とスキルレベル ID を取得する方法は、こちらをご参照ください。

Revoke user's skills via API2.png

 

4.[Execute]を選択してリクエストを実行します。

5.Responses ブロックで結果を確認します。

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body では、リクエストの結果が表示され、スキルの取り消し日時を確認できます。
  • Learn365 管理センター、およびトレーニングダッシュボードの「スキル」セクションで、取り消されたスキルを確認できます。ユーザーにはスキルの失効に関する通知が送信されます。

Revoke user's skills via API3.png