APIでコースを作成する

  • 更新

LMS365では、LMS365 管理センター、またはLMS365 API を使用して、コースを作成することができます。

ここでは、LMS365 API を使用して、コースを作成ための方法とガイドラインをご説明します。

LMS365 API を使用して新しいコースを作成するには、以下の手順で行います。

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

2.Courses セクションを展開し、 POST /odata/v2/Courses Creates new Course を選択し、開いた画面で右上の「Try it out」を選択します。

Create

3.パラメータを設定します。

Create

API 経由でコースを作成する場合、パラメータのうち5つは必須項目、その他は任意項目です。
オプションのパラメータは、コース作成後にLMS365 管理センターのコース編集で追加することができます。

データのデフォルト値には、以下のタイプがあります。

  • guid:一意の ID
  • string:何らかの制限のある文字列(文字、数字、記号、句読点など)
  • integer:整数
  • boolean:真か偽の変数

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

  • CourseCatalogId:作成する新しいコースを表示するカタログの固有ID

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

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

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

  • CourseType:トレーニングタイプを選択してください。このパラメータが設定されていない場合、または ”0” に設定されている場合、トレーニングタイプは設定されません。
    eラーニングコースを作成する場合は ”1” 、インストラクターによるコースを作成する場合は ”3” 、トレーニングプランを作成する場合は ”4” を入力します。

インストラクター主導型のコースでは登録タイプを設定するために ”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

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body フィールドに、リクエストの結果が表示されます。
  • ダウンロードオプションを使用して、結果を JSON フォーマットでローカルデバイスに保存することができます。

Response body フィールドには、設定されたパラメータで新しく作成されたコースが表示されます。
このコースはLMS365 管理センターのトレーニング管理ページに表示され、設定、管理することができます。

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

トレーニングの作成状況はLMS365 APIで確認することができます

Create