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 管理センターでトレーニングを編集することで追加することができます。

既定のデータタイプは次のとおりです。

  • guid:一意の ID
  • string:任意の限定された文字列(文字、数字、記号、句読点など)
  • integer:整数
  • boolean:真か偽の変数

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

  • CourseCatalogId:新しいコース作成が追加されるカタログ ID(固有のものです)。

  • UICulture:サイト言語。SharePoint がサポートする言語リストから追加する必要があります。SharePoint でサポートされている言語の表の「LCID」列で、該当するロケール IDを使用します。例えば、英語(アメリカ合衆国)の場合、「en-us」 を使用します。他のロケール形式が使用された場合、作成は失敗します。

  • Title:作成するコースのタイトルを入力します。

  • Description:作成するコースの簡単な説明(概要)を入力します。

  • CourseType:作成するトレーニングタイプを選択します。
    • eラーニングコース:1
    • 講師に指導によるトレーニング :3
    • トレーニングプラン:4

このパラメーターが構成されていない場合、または「0」が設定されている場合、トレーニングのタイプは設定されず、あとで設定することもできません。

 

注記:

講師の指導によるトレーニングでは、 ”CourseSessionEnrollmentType” パラメータを使用して、登録タイプを指定します。

  • 1つのグループまたはセッション:1
  • 複数のグループまたはセッション:2
  • すべてのグループとセッション:3
  • 講師の指導によるトレーニング コースは、Responses には '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 を使用してトレーニングの作成状況を確認することができます。