【API】 ユーザー データの消去(完全削除)

  • 更新

コースカタログからユーザーを削除した場合でも、そのユーザーの記録はシステムや受講履歴には残ります。

Learn365 では、ユーザーの記録を消去(完全削除)することができます。

この操作を実行すると、以下の情報がすべて Learn365 テナントから消去(完全削除)されます。

  • 受講登録情報
  • 学習の進捗・履歴
  • 操作の記録

ユーザー データの消去(完全削除)は、Learn365 管理センターの[ユーザーの記録の消去]機能、または Learn365 API を使用して実行できます。

ここでは、API を通じて Learn365 からユーザー データを消去する手順を説明します。

補足:

この機能では、Learn365 および Flow365 ユーザーアカウントに関連するすべてのデータを消去(完全に削除)できます。

 

手順:

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

2.Users セクションに移動し、POST /odata/v2/ Users('{LoginName}')/Purge Purge user's data を選択し、右上の[Try it out]をクリックします。

Purge

 

3.パラメータを入力します。

Purge

注記:重複した「LoginName」が存在する場合、エラーになります。

同じ「LoginName」を持つユーザーが複数存在する場合、システムがユーザーを識別できないため、purge リクエストは 500 エラーで失敗します。

このような場合、LoginName の代わりに「DirectoryObjectId」の使用をお勧めします。

「DirectoryObjectId」は、Microsoft Entra ID(Azure AD)における各オブジェクトの固有の識別子であり、変更されることがなく、システムがユーザーを簡単に識別することができます。

DirectoryObjectId は、ログイン名を取得するリクエストを実行した Response body で見つけることができます。 

Purge

 

4.[Execute]を選択してリクエストを実行します。

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

  • Code 2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body に、リクエストの結果が表示されます。対象のユーザー、およびユーザーのすべてのデータ(登録、トレーニングの進捗、および操作の記録)は、すべてのコースカタログ、コース、トレーニング プランから削除され、Learn365 テナントから完全に消去されます。

ユーザとそのユーザのすべてのレコードはテナントから完全に削除され、ユーザーは、すべてのコースカタログの「ユーザー」画面から削除されます。削除されたユーザー データは復元できません。

注記:グループで登録されていたユーザーは、「ユーザー」画面に表示されます。

対象ユーザーが Microsoft Entra グループを介してコースまたはコースカタログに追加されていた場合、[ユーザーの記録を消去]を実行した後も当該ユーザーはコースカタログの「ユーザー」画面に再表示されますが、ユーザーに関する学習の記録(受講登録、進捗、履歴など)はすべて削除されています。

Purge