検索

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

  • 更新

Learn365では、Learn365 管理センター、またはLearn365 APIを使用してトレーニングプランにユーザーを登録することができます。

ここでは、Learn365 API を使用して、トレーニングプランにユーザーを登録する方法についてご説明します。

注記：

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

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

２．Courses セクションを展開し、POST /odata/v2/Courses({Id})/Enroll Enrolls user or group into a Course を選択し、開いた画面で右上の「Try it out」を選択します。

Enroll users in a course via API1.png

３．パラメータを設定します。

  • 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
}

Enroll users in training plans via API1.png

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

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

  • Codeの下にある２ＸＸ（例：201）という数字は、リクエストが正しく動作したことを示します。
  • Response body には、登録に関する詳細な情報が表示されます。
    ユーザーは、トレーニングプランとこのトレーニングプランのすべてのコースに登録されます。
    Learn365 管理センターで、トレーニングプラン設定パネルのユーザーセクションで確認できます。

Enroll users in training plans via API2.png

 

注記：

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

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

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

Enroll users in training plans via API3.png

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

Enroll users in training plans via API4.png