API によるユーザーのスキルの消去

  • 更新

API を通じて Learn365 ユーザーのスキルを消去し、この情報を完全に削除することが可能です。

ここでは、API を通じてユーザーのスキルを消去する方法について説明します。

 

注記:

  • 有効と失効、どちらのスキルも消去できます。
  • 複数レベルの一連のスキルのうち、1つのレベルのスキルをパージすると、その一連のスキル全体が消去されます。

 

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

  • LoginName:スキルを消去するユーザーのログイン名。LoginName の取得については、こちらを参照してください。
  • competencyId:消去するスキルの ID。competencyId の取得については、こちらを参照してください。

 

Learn365 API を通じたユーザーのスキルの消去は、以下の手順に沿って行います。

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

2.Users セクションに移動し、POST /odata/v2/Users('{LoginName}')/PurgeCompetency
Purge competency(skill) for a specific user を選択し、右上の「Try it out」を選択します。

 

Purge skills via the API-1.png

 

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

  • LoginName:「Key:LoginName」フィールドにスキルを消去するユーザーのログイン名を入力します。
  • parameters * competencyId:「Edit Value」フィールドで、以下を入力します。

    • "competencyId": "string" :「string」を、消去するスキルの ID に置き換えます。

 

Purge skills via the API-2.png

 

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

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • エラーの場合、Response body には、問題を説明するコードとメッセージ キーを持つエラー オブジェクトが含まれます。

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

フィルター パネルの 活動 で 「受講者のスキルレベルが消去されました(Learner skill level was purged)」 を選択し、レコードを検索して該当するレコードを選択すると、詳細情報が表示されます。

 

Purge skills via the API-3.png