APIでユーザーをトレーニングプランに登録する

  • 更新

LMS365では、LMS365の管理センターの機能だけでなく、LMS365 APIを使用してユーザーをトレーニングプランに登録することができます。

トレーニングプランにユーザーを登録するには、「APIでユーザーをコースに登録する」と同じエンドポイントが使用されます。

LMS365 APIでトレーニングプランにユーザーを登録するには、

1.https:/api.365.systems/ に移動し、API キーを使用して認証します。認証プロセスについては、SwaggerでLMS365のAPIキーを認証するをご参照ください。

2.LMS365 Cloud API セクションリストの、Courses セクションを展開し、

POST ​/odata​/v2​/Courses({Id})​/Enroll Enrolls user or group into a Course

を選択します。

3.「Try it out」 を選択します。

capture1.png

4.2つのフィールドが表示されます。

capture2.png

必須パラメータを入力します。

  • Id(key: Id):ユーザ、またはグループを登録するトレーニングプランのIDを入力します。
  • parameters:Edit valueにある "userLoginName" をコースに登録するユーザーのログイン名に書き換えます。

capture5.png

5.準備ができたら「Execute 」ボタンを選択して、リクエストを実行します。

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

Code の下にある2xx(例、201)という数字は、リクエストが正しく処理されたことを示しています。
Response body に、リクエストの結果が表示されます。

トレーニングプランに登録されたユーザー/グループには関連する通知が送信されます。
LMS365管理センター>トレーニング管理>トレーニングプランのユーザー管理で、登録されたユーザーを確認することができます。

capture6.png

Responseには以下の重要な情報が含まれます:

"Roles": APIでトレーニングプランに登録した際に、ユーザーがコース管理者ロールを持っているかどうかによって異なります。

ユーザーがトレーニングプランの管理者ロールを割り当てられていない場合、このユーザーのResponseには受講者ロールのみが表示されます。トレーニングプラン管理者ロールのユーザーが、APIでこのトレーニングプランに登録された場合、Responseには、2つのロール「 Learner (受講者)」 と「Teacher (管理者)」 が表示されます。

capture7.png

"RegistrationStatus" :トレーニングプランに設定されている承認フローによって異なります。自動承認のトレーニングプランでは「Active」、管理者またはライン管理者による承認のトレーニングプランでは「Awaiting」になります。ステータスは、LMS365管理センターの受講承認、またはLMS365APIエンドポイント POST/odata/v2/Enrollments({Id})/Approve や POST/odata/v2/Enrollments({Id})/Reject を使って、それぞれ”Awaiting” から ”Active” に変更することができます。

capture8.png