検索

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

  • 更新

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

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

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

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

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

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

を選択します。

３．「Try it out」 を選択します。

capture1.png

４．２つのフィールドが表示されます。

capture2.png

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

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

capture5.png

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

６．Responsesブロックで結果を確認します。

Code の下にある２ｘｘ（例、２０１）という数字は、リクエストが正しく処理されたことを示しています。
Response body に、リクエストの結果が表示されます。

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

capture6.png

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

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

ユーザーがトレーニングプランの管理者ロールを割り当てられていない場合、このユーザーのResponseには受講者ロールのみが表示されます。トレーニングプラン管理者ロールのユーザーが、APIでこのトレーニングプランに登録された場合、Responseには、２つのロール「 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