検索

【API】 Learn365 ユーザーアカウントの統合

  • 更新

Learn365 では、API を使って学習の進捗データを含むすべてのデータを別のアカウントに統合することができます。

ここでは、Learn365 APIを通じてアカウントを統合する手順と、アカウントを統合した際の影響（結果）について説明します。

注記：

  • アカウントの統合は、Learn365 のデータのみに適用されます。統合は元に戻すことはできません。
  • アカウントの統合は、外部ユーザーや削除済みユーザーに対しても実行できます。
  • AD グループ（Active Directory グループ）に対しては統合操作を行うことはできません。

 

Learn365 アカウントを API で統合する

アカウントを統合するには、対象となる 2 つのユーザー（アカウント）それぞれの「DirectoryObjectId」が必要です。

ユーザーの DirectoryObjectId は、GET /odata/v2/Users リクエストを使って取得できます。

このリクエストを実行し、 Response body でユーザーの名前を検索（Ctrl+F）し、それぞれの「DirectoryObjectId」をコピーします。

また、Download オプションを使用すると、リクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

 詳細は、こちらをご参照ください。

補足：どちらのアカウントを統合先にするかを判断するには、"IsDeleted "フィールドを確認します。ほとんどの場合、移行の対象となるアカウントは「 "IsDeleted "：True」 になっています。（これは、このアカウントが削除されていること示します。）

Merge user accounts1.png

 

手順：

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

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

このエンドポイントは、メインとなるアカウント（統合先アカウント）に、対象となるアカウントの学習の進捗データを含むすべてのデータを移行します。

Merge user accounts2.png

 

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

  • LoginName＊：「key: LoginName」フィールドに、統合先アカウントの「DirectoryObjectId」を入力します。ここで指定したアカウントは、統合後もそのまま残り、もう一方のアカウントの学習データを引き継ぎます。
  • parameters＊：「Edit Value」フィールドで、以下を指定します。
    • "sourceUserLoginName": "string" ＊：「string」 を統合される側のアカウントの「DirectoryObjectId」に置き換えます。ここで指定したアカウントのデータは、統合先アカウントに移行されます。統合後は、Learn365 管理センター の「ユーザー」画面のリストからは削除されますが、Microsoft Entra ID（Azure AD) には残ります。

Merge user accounts3.png

 

4．［Execute］を選択してリクエストを実行します。

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

  • Code 2xx（204など）は、リクエストが正しく動作したことを示します。
  • Response body には、リクエストの結果（アカウントの統合に関する情報）が表示されます。

Merge user accounts4.png

 

統合による影響 

Learn365 のロールや SharePoint グループへの影響

統合する 2 つのアカウントは、それぞれ異なるロールや SharePoint グループに属している場合があります。

アカウントを統合すると、次のようになります。：

  • 2 つのアカウントが Learn365 で異なるロールを持つ場合、統合先のアカウントに両方のロールが引き継がれます。
  • 統合される側のアカウントは、Learn365 のすべてのロールを失いますが、属している SharePoint グループには変更はありません。SharePoint グループからも削除したい場合は、手動で対応する必要があります。
  • 統合される側のアカウントが、Microsoft Entra グループでコースやトレーニングプランに追加されていた場合、 その登録は統合先アカウントに移行されますが、当該コースまたはトレーニング プラン内ではいかなるロールも付与されることはありません。

受講登録への影響

ユーザーは、1 つのコースまたはトレーニング プランにつき、1 つの受講登録しか持つことができません。

アカウントを統合すると、次のようになります。：

  • 統合先アカウントは受講登録をそのまま保持します。加えて、統合される側のアカウントの受講登録も引き継ぎ、それらの受講登録に紐づくすべてのデータ（進捗・履歴など）も移行されます。
  • 両方のアカウントが同じコースおよびトレーニング プランに登録されている場合、統合される側のアカウントの登録情報は期限切れとして統合先アカウントに移行されますが、関連する情報およびトレーニングの記録は統合先アカウントから確認できます。
  • ユーザーは１つのコースセッションに対して、登録を１つしか保持できないことがあります。統合先アカウントのコースセッションの登録はそのままを保持します。加えて、セカンダ リ アカウントの登録も引き継ぎ、それらの登録に紐づくすべてのデータも移行されます。

課題への影響

統合先アカウントの課題はそのまま保持されます。加えて、統合される側のアカウントの課題も引き継ぎます。

重要！：両方のアカウントで同じ課題が重複している場合は、統合される側のアカウントのデータや提出されたファイル（ドキュメント）は削除されます。