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」をクリックします。
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」を選択してリクエストを実行します。
5.Responses ブロックで結果を確認します。
- Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
- Download オプションを使用すると、API リクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
- Response body に、設定したパラメータで作成されたコースが表示されます。
このコースは Learn365 管理センターのトレーニング管理ページに表示され、設定、管理することができます。
注記:
トレーニングのプロビジョニングを正常に完了させるために、新しく作成されたコースやトレーニングプランへの学習項目の追加や その他の設定は、しばらく時間をおいてから行うことをお勧めします。
Learn365 API を使用してトレーニングの作成状況を確認することができます。