SharePointテナント間移行後の壊れたリンクを修正する

テナント間移行はSharePointの最も複雑なシナリオの一つです — ベースURLとSharePointアイテムの内部IDの両方が変わるため、すべてのOfficeドキュメントに埋め込まれたすべてのリンクが壊れます。このガイドでは、何が壊れるのか、なぜ壊れるのか、そしてReplaceMagicが3種類のリンクを一括修復する方法を説明します。

テナント移行は3種類すべてのリンクを壊します：絶対URL リンク、相対パスリンク、SharePoint IDベースリンク
手動修復は企業規模では現実的ではありません — リンクが10個ある1,000ドキュメントだけでも10,000回の手動編集が必要です
ReplaceMagicは3種類すべてのリンクを自動的に処理します。IDベースリンクの変換も含みます（ユーザーが提供する検索/置換の組み合わせに基づいて）

テナント間移行でドキュメントのリンクが壊れる理由

企業がMicrosoft 365のあるテナントから別のテナントに移行する場合 — 買収、合併、または分割により — テナントドメインが変わるため、すべてのSharePoint URLが変わります（company.sharepoint.comがnewcompany.sharepoint.comになります）。さらに、各SharePointアイテムはそのテナント固有の内部IDを持っており — このIDは新しいテナントには引き継がれません。その結果、すべてのドキュメントに埋め込まれたすべてのリンクが切り替え時点で壊れます。

1. 絶対URLリンク

これらは古いテナントドメインを直接参照します（例：https://oldcompany.sharepoint.com/sites/Finance/...）。移行後、そのドメインは無効になります。解決策：すべてのドキュメントで古いドメインを新しいドメインに置き換えます。

2. 相対パスリンク

これらはSharePointサイト階層内の相対パスを使ってドキュメントを参照します。移行中にサイト構造が変わると壊れる可能性があります。解決策：変更されたパスコンポーネントを更新します。

3. IDベースリンク（最も重要）

SharePointはリンクの一部をアイテムの内部データベースID参照として保存します（例：/sites/Finance/_layouts/15/Doc.aspx?sourcedoc={GUID}）。これらのGUIDはテナント固有のものであり、移行先テナントには存在しません。移行後、これらのリンクはどこも指しません。解決策：ReplaceMagicはユーザーが提供する検索/置換の組み合わせに基づいて、IDベースリンクを正しいURLベースリンクに変換します。移行前または移行後に実施することで、新しいテナントでも機能し続けます。

すべての変更は、ユーザーが提供する検索/置換ルールに基づいて実施

ReplaceMagicはユーザーが提供する検索/置換ルールに基づいてすべての変更を実施します。ReplaceMagic.SmartMapperはこれらのルール作成を自動化します — SharePointのDocIDを解決し、テナント切り替え前にソース → ターゲットのマッピングから必要なパターンを直接生成します。詳細はSmartMapperガイドをご覧ください。

ReplaceMagicが3種類のリンクを修正する方法

ステップ1 — 移行前の分析

移行元テナントでReplaceMagicを実行して、すべてのドキュメントとすべてのリンクタイプの完全なインベントリを作成します。絶対リンク、相対リンク、IDベースリンクがそれぞれいくつあるかを確認します。このインベントリは置換ルールに直接活用され、移行後の検証のベースラインを提供します。

ステップ2 — 置換ルールの設定

ドメインの置換（古いURL → 新しいURL）を設定します。IDベースリンクについては、ReplaceMagicはユーザーが提供する検索/置換ルールに基づいて変換できます。すべてのルールタイプは1つのインポートファイルで設定され、1回の処理ステップで実行されます。

ステップ3 — プレビューと検証

プレビューモードで実行して、確定前にすべての提案された変更を確認します。置換ルールが分析で見つかったすべてのリンクバリエーションをカバーしていることを確認します。エッジケースが見つかった場合はルールを調整します。

ステップ4 — 実行

置換を実行します。ReplaceMagicはすべてのドキュメントを並列処理し、ファイルを一切開かずに3種類のリンクすべてを1ステップで更新します。サイト管理者権限で実行した場合、SharePointのメタデータ（最終更新日、作成者）は保持されます。

ステップ5 — 移行後の検証

移行先テナントで再度スキャンして、すべてのリンクが正しく解決されることを確認します。プロジェクト承認と監査文書化のために検証レポートをエクスポートします。

置換準備パッケージの役割

何百ものパスバリエーションや大量のIDベースリンクを含む複雑なテナント間移行の場合、ReplaceMagicチームがすべての置換文字列の組み合わせを代わりに準備できます。このサービスでは移行元テナントを分析し、すべての固有のリンクパターンを特定して、インポートすぐに使える置換ルールファイルを提供します。詳細は置換準備パッケージをご覧ください。