【API】 コース/ トレーニング プランの作成

  • 更新

Learn365では、Learn365 管理センター、または Learn365 API を通じて コース/ トレーニング プランを作成することができます。

ここでは、Learn365 API を通じた、コース/ トレーニングプランの作成方法とガイドラインを説明します。

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

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

2.Courses セクションに移動し、 POST /odata/v2/Courses Creates new Course を選択し、右上の「Try it out」をクリックします。

Create courses via API-1.png

 

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

「Edit Value」で、関連するパラメータの値を入力します。

必須 パラメータとオプション パラメータがあります。オプション パラメータは、コースまたはトレーニングプランを作成後、Learn365 管理センターでトレーニングを編集することで追加することができます。

必須 パラメーターは以下の通りです。:

  • CourseCatalogId:作成した新しいコースを追加するコース カタログの ID(ID はユニークです)。
  • UICulture:ロケール ID でサイト言語を指定します。ロケール ID は SharePoint でサポートされている言語の表の「LCID」列で取得できます。例えば、英語(アメリカ合衆国)の場合、「en-us」 を使用します。他のロケール形式が使用された場合、作成は失敗します。
  • Title:作成するコースのタイトルを入力します。
  • Description:作成するコースの概要説明を入力します。
  • CourseType:作成するコースのトレーニング タイプを指定します。このパラメータが設定されなかったり、0 が設定された場合、トレーニング タイプは定義されず、後でそれを設定することもできません。
    • eラーニング コース:1
    • 集合トレーニング コース :3
    • トレーニングプラン:4

注記:

集合トレーニング コースでは、 ”CourseSessionEnrollmentType” パラメータを使用して、登録タイプを指定します。

  • 1つのグループまたはセッション:1
  • 複数のグループまたはセッション:2
  • すべてのグループとセッション:3

参考 💡

  • 集合トレーニング コース の Responses body では、「CourseType」は ”ClassRoom"と表示されます。
  • API を通してコースを作成する過程でコースを公開するには、以下のパラメータを指定します。

    "PublishingSettings": {"IsEnabled": true}

 

注意が必要なオプションのパラメーター:

  • TeacherLogins:コース管理者として割り当てるユーザーを指定します。
  • TrainerLogins:「TeacherLogins」に指定したユーザーの中から、トレーニング ホームページに連絡先として表示するユーザーを指定します。「TeacherLogins」に含まれていないユーザーをここに追加した場合、トレーニングホームページの連絡先には表示されません。
  • VisitorLogins:”Training Audience Targeting” が有効な場合、対象となるユーザーを指定します。 ”Training Audience Targeting” が無効の場合、対象となるユーザーは設定されません。

例:必須パラメータと公開ステータスを設定したトレーニング作成のリクエストの例


eラーニングコース:

 {
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "en-us",
"Title": "Business Analysis, part 2",
"Description": "The course is oriented towards expert business analysts.",
"CourseType": "1",
"PublishingSettings": {"IsEnabled": true}
}

 


集合トレーニング コース:

{
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "fr-fr",
"Title": "Analyse commerciale, partie 4",
"Description": "Le cours s'adresse aux analystes commerciaux experts.",
"CourseType": "3",
"CourseSessionEnrollmentType": "3",
"PublishingSettings": {"IsEnabled": true}
}

 


トレーニング プラン:

{
"CourseCatalogId": "d4d0b82f-e67f-46d7-a142-fc347a520973",
"UICulture": "de-de",
"Title": "Geschäftsanalyse",
"Description": "Der Ausbildungsplan ist auf erfahrene Business Analysten ausgerichtet.",
"CourseType": "4",
"PublishingSettings": {"IsEnabled": true}
}

 

 

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

 

Create courses via API-2.png

 

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Download オプションを使用すると、API リクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
  • Response body に、設定したパラメータで作成されたコースが表示されます。
    このコースは Learn365 管理センターのトレーニング管理ページに表示され、設定、管理することができます。

Create courses via API-3.png

 

注記:

トレーニングのプロビジョニングを正常に完了させるために、新しく作成されたコースやトレーニングプランへの学習項目の追加や その他の設定は、しばらく時間をおいてから行うことをお勧めします。

Learn365 API を使用してトレーニングの作成状況を確認することができます。