API による削除されたコース/ トレーニング プランの取得

  • 更新

コースとトレーニング プランが削除されると、コースカタログの「トレーニング管理」ページには表示されませんが、それらのデータと関連するトレーニングの記録は Learn365 に保存されており、Learn365 API を通じて取得することができます。

ここでは、Learn365 API を通じた削除されたコース/トレーニング プランの取得について説明します。

 

API を通じた削除されたコース/トレーニング プランの取得は、以下の手順に沿って行います。

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

2.Courses セクションに移動し、GET /odata/v2/Courses/IncludedDeleted Returns the list of Courses including courses which have been deleted  を選択し、右上の「Try it out」を選択します。

 

Get a list of deleted courses1.png

 

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

  • $filter:IsDeleted eq true

これにより、レスポンスには、テナント上の削除されたコース/トレーニング プランのみが含まれます。

クエリ オプション パラメータが設定されていない場合、レスポンスには、テナント上のすべてのコースとトレーニング プランが含まれます。

 

Get a list of deleted courses2.png

 

クエリ オプション パラメータを設定して レスポンス データを絞り込むことができます。

「and」を使って最初のパラメータの後に、追加のパラメータを設定できます。

例えば、削除されたコース/ トレーニング プランのうち、特定のタイプ(e-learning, instructor-led training,training plan)に関する情報を取得するには、$filter に「CourseType eq 'number'」 を追加します。 'number' は、トレーニングのタイプに応じて、以下の数字のいずれかに置き換えます。

  • e-learning courses:1
  • instructor-led training:3
  • training plans:4

例:

$filter フィールドに「IsDeleted eq true and CourseType eq '4' 」と入力します。
この場合、レスポンスには、テナントの削除されたトレーニングプランのみが含まれます。

 

Get a list of deleted courses3.png

 

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

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body には、設定されたクエリオプションパラメータに応じて、テナントの削除されたコースとトレーニングプラン、およびそれらのデータが表示されます。
  • Ctrl+Fで検索することができます。
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

Get a list of deleted courses4.png