Learn365では、Learn365 管理センター、または Learn365 API を通じて、ユーザーのスキルを取り消すことができます。
ここでは、Learn365 API を通じて、ユーザーのスキルを取り消す手順を説明します。
注記:
従来の Competencies 関連のエンドポイントは、今後の Learn365 リリースで廃止される予定です。新しい Skills エンドポイントへの移行を推奨します。
ユーザーのスキルを取り消すには、以下の情報が必要です。
- courseCatalogId:取り消すスキルが含まれているコースカタログのID。コースカタログ ID の取得については、こちらをご参照ください。
- LoginName:スキルを取り消すユーザーの LoginName。ユーザーの LoginName の取得については、こちらをご参照ください。
- skillId とlevelId:スキルのIDと、スキル レベルのID。スキルとスキルレベル ID の取得については、こちらをご参照ください。
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.パラメータを入力します。
- courseCatalogId*:「courseCatalogId」フィールドにコースカタログ ID を入力します。
- LoginName*:「LoginName」フィールドに、ユーザーのログイン名を入力します。
-
body:「Example Value」フィールドで以下を入力します。
- "skillId": "guid":「guid」をスキル ID に置き換えます。
- "levelId": "guid":「guid」をスキルレベル ID に置き換えます。
4.[Execute]を選択してリクエストを実行します。
5.Responses ブロックで結果を確認します。
- Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
- Response body では、リクエストの結果が表示され、スキルの取り消し日時を確認できます。
- Learn365 管理センター、およびトレーニング ダッシュボードの「スキル」セクションで、取り消されたスキルを確認できます。ユーザーにはスキルの失効に関する通知が送信されます。
Learn365 管理センター>グローバル設定>「監査証跡」で、スキルの取り消しに関する詳細な情報を確認することができます。
フィルター パネルの「活動」フィールドで「受講者のスキルが取り消されました」を選択し適用します。検索結果で該当するレコードを選択すると、詳細情報が表示されます。
Learn365 監査証跡については、こちらをご覧ください。
Users セクションで取り消す(従来)
注意!Users セクションのエンドポイントは、今後の Learn365 リリースで廃止される予定です。
手順:
1.https://api.365.systems/ にアクセスし、API キーで認証します。
2.Users セクションに移動し、 POST /odata/v2/Users('{LoginName}')/ RevokeCompetency Revokes competency (skill) を選択し、右上の[Try it out]をクリックします。
3.パラメータを入力します。
- LoginName*:「Key:LoginName」フィールドに、対象ユーザーのログイン名を入力します。
-
parameters*:「Edit Value」フィールドで、以下を入力します。
- "competencyId": "string" :「string」を、ユーザーから削除するスキルのIDに置き換えます。
- "competencyLevelId": "string" :「string」を、ユーザーから削除するスキルのスキルレベルIDに置き換えます。
スキル ID とスキルレベル ID を取得する方法は、こちらをご参照ください。
4.[Execute]を選択してリクエストを実行します。
5.Responses ブロックで結果を確認します。
- Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
- Response body では、リクエストの結果が表示され、スキルの取り消し日時を確認できます。
- Learn365 管理センター、およびトレーニングダッシュボードの「スキル」セクションで、取り消されたスキルを確認できます。ユーザーにはスキルの失効に関する通知が送信されます。