APIでコースやトレーニングプランからユーザー/グループの登録を解除する

  • 更新

LMS365 では、LMS365の管理センターの機能だけでなく、LMS365 APIを使用して、コースやトレーニングプランからユーザー/ Azure AD グループの登録を解除することができます。

LMS365 APIでコースやトレーニングプランからユーザー/グループの登録を解除するには、

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

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

POST /odata/v2/Courses({Id})/Unenroll Unenrolls user or group from a Course

を選択します。

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

capture9.png

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

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

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

capture10.png

"message" で入力されたテキストは、LMS365 管理センターのキャンセルメッセージとして表示されます。この行を変更しない、または削除した場合、キャンセルメッセージは3つのダッシュ記号で表示されます。

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

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

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

Response headerには、リクエストの結果が表示されます。例えば、「date:」行には、ユーザ/グループの登録を解除した日時が表示されます。

登録を解除されたユーザ/グループには登録解除の通知が送信されます。
また、MS365管理センターで当該コース/トレーニングプランのユーザー管理で、ユーザ/グループの登録が解除されたことを確認できます。(登録済受講者リストから削除されています。)

capture11.png