LMS365では、LMS365 管理センター、またはLMS365 APIを使用してトレーニングプランにユーザーを登録することができます。
ここでは、LMS365 API を使用して、トレーニングプランにユーザーを登録する方法についてご説明します。
トレーニングプランにユーザーを登録するには、コースへの登録と同じAPIエンドポイントが使用されます。 |
1. https://api.365.systems/ にアクセスし、APIキーで認証します。
2.Courses セクションを展開し、POST /odata/v2/Courses({Id})/Enroll Enrolls user or group into a Course を選択し、開いた画面で右上の「Try it out」を選択します。
3.パラメータを設定します。
- key:Id:このパラメータは必須です。ユーザーまたはグループを登録するコースのIDを入力します。
- "userLoginName": "string":このパラメータは必須です。"string” を登録するユーザーのログイン名に置き換えます。
トレーニングプランへの登録リクエストの行うときは、Edit Value フィールドから、lcourseSessionId": "string", "courseSessionIds": ["guid"],パラメータを削除します。
例:
{
"userLoginName": "i:0#.f|membership|kayb@lms365preview.onmicrosoft.com",
"ignoreMaxAttendees": true,
"ignoreEnrollmentFlow": true
}
4.準備ができたら、「Execute 」ボタンを選択してリクエストを実行します。
5.Responses ブロックで結果を確認します。
- Codeの下にある2XX(例:201)という数字は、リクエストが正しく動作したことを示します。
- Response body には、登録に関する詳細な情報が表示されます。
ユーザーは、トレーニングプランとこのトレーニングプランのすべてのコースに登録されます。
LMS365 管理センターで、トレーニングプラン設定パネルのユーザーセクションで確認できます。
Responseには以下の重要な情報が含まれます: "Roles": APIでトレーニングプランに登録した際に、ユーザーがコース管理者ロールを持っているかどうかによって異なります。 ユーザーがトレーニングプランの管理者ロールを割り当てられていない場合、このユーザーのResponseには受講者ロールのみが表示されます。トレーニングプラン管理者ロールのユーザーが、APIでこのトレーニングプランに登録された場合、Responseには、2つのロール「 Learner (受講者)」 と「Teacher (管理者)」 が表示されます。 "RegistrationStatus" :トレーニングプランに設定されている承認フローによって異なります。自動承認のトレーニングプランでは「Active」、管理者またはライン管理者による承認のトレーニングプランでは「Awaiting」になります。ステータスは、LMS365管理センターの受講承認、またはLMS365APIエンドポイント POST/odata/v2/Enrollments({Id})/Approve や POST/odata/v2/Enrollments({Id})/Reject を使って、それぞれ”Awaiting” から ”Active” に変更することができます。 |