ReplaceMagicとSharePoint Online — ネイティブ大規模リンク一括修復

SharePoint OnlineはMicrosoftのクラウドベースの文書管理・コラボレーションプラットフォームであり、Microsoft 365の一部です。世界中の組織が、Word・Excel・PowerPoint・Visio・Projectファイルを構造化された文書ライブラリに保存するために利用しています。それらの組織がファイルサーバー、オンプレミスのSharePointファーム、または別のMicrosoft 365テナントから移行すると、古い場所を指していたすべてのハイパーリンク・OLEオブジェクト参照・埋め込みパスがリンク切れになります。ReplaceMagicはまさにこの問題を解決するために作られました — 大規模に、1つの文書も手動で開くことなく。

ネイティブ接続 — ドライブのマッピング不要

ReplaceMagicはMicrosoftのSharePoint REST APIとCSOM（クライアントサイドオブジェクトモデル）を通じて直接SharePoint Onlineに接続します。つまり、SharePointをネットワークドライブとしてマッピングしたり、WebDAVを設定したりする必要はありません。ネイティブAPI接続はより高速で信頼性が高く、マップドドライブでは公開できないSharePointのメタデータにReplaceMagicがアクセスできます。接続後、ReplaceMagicは文書ライブラリを列挙し、処理のためにファイルをダウンロードし、置換を適用して、修正されたファイルをアップロードできます — すべてReplaceMagicのインターフェース内で完結します。

対応認証方式

ReplaceMagicはSharePoint Onlineに対して複数の認証方式をサポートしており、テナントのさまざまなセキュリティ設定に対応できます：

SharePoint Online（ユーザー名/パスワード） — 標準のMicrosoft 365資格情報。レガシー認証が引き続き許可されているテナントに適しています。
アプリパスワードを使用したMFA — 多要素認証で保護されたアカウント向け。Microsoft 365アカウントのセキュリティ設定でアプリパスワードを生成し、通常のパスワードの代わりに使用してください。
アプリ専用認証 — Azure ADアプリを登録し、必要なSharePointアクセス許可を付与して、クライアントIDとクライアントシークレットを使用します。この方式は、対話型ログインができない自動化・無人・スケジュール実行のワークフローに最適です。

ReplaceMagicがSharePoint Onlineで保持する情報

文書の一括処理において最も重要な懸念事項の1つがメタデータの整合性です。ReplaceMagicはファイルを変更した後、以下のSharePoint Onlineプロパティを保持するよう設計されています：

最終更新日時と更新者
コンテンツ承認状態（承認済み・却下・保留中）
バージョン履歴 — 変更はバージョン履歴を上書きするのではなく、新しいバージョンとして記録されます
ドキュメントのチェックイン・チェックアウト状態 — 処理前にチェックアウトされていた文書は同じ状態で返されます

最終更新日時と更新者を保持するには、対象のサイトコレクションでサイト管理者権限が必要です。投稿者権限だけでは、この操作には不十分です。

SharePoint Onlineのスロットリング（HTTP 429）

SharePoint OnlineはAPIリクエストにレート制限を課しています。短時間に多くのリクエストが集中すると、サービスはHTTP 429（Too Many Requests）またはHTTP 503レスポンスを返します。ReplaceMagicはスロットリングを自動的に処理します：429レスポンスを検出し、Retry-Afterヘッダーを読み取り、指定された時間だけ該当スレッドを一時停止してからリクエストを再試行します。手動での操作は不要です。

スロットリングの負荷を最小限に抑えるため、SharePoint Onlineで推奨される並列処理設定は3〜5スレッドです。並列数を増やすとスロットリングがより頻繁に発生し、全体的なスループットがかえって低下する場合があります。スレッド数はReplaceMagicの処理設定パネルで調整できます。

対応ライブラリおよびページの種類

ネイティブ統合を通じて、ReplaceMagicはSharePoint Online上の以下のコンテンツタイプを処理できます：

標準文書ライブラリ（Word・Excel・PowerPoint・Visio・PDFおよびその他のファイル形式）
Wikiページ（ASPXとして保存されたEnterprise Wikiコンテンツ）
Canvasページ（SharePointモダンページ）

特殊文字の制限

ファイル名に次のいずれかの文字が含まれるファイルは、SharePoint APIによって共有リンクトークンや組織リンク情報を取得できません：~ # % & * { } \ : <> ? / + | "。これらのファイルはダウンロードされ、リンク切れを処理してから再アップロードされますが、それらを指す共有リンク形式のURLはトークンメカニズムでは修復できません。

典型的な移行シナリオ

ファイルサーバー → SharePoint Online：UNCパス（\\サーバー\共有\ファイル.xlsx）が文書ライブラリのHTTPS URLに変換されます。
オンプレミスSharePoint → SharePoint Online：イントラネットURL（http://intranet/sites/...）がクラウドURL（https://企業.sharepoint.com/sites/...）に変わります。
テナント間移行：ベースURLとSharePoint要素の内部IDの両方が変わります。IDベースのリンクは絶対URL形式への変換が必要です。

処理手順の概要

ReplaceMagicをSharePoint Onlineで使用するには、シンプルなワークフローに従います：ターゲットとしてSharePoint Onlineを選択 → 希望の方式で認証 → サイトと文書ライブラリを選択 → スキャンを実行してすべてのリンクを特定 → 検索・置換ルールを設定 → 結果グリッドで変更をプレビュー → 置換を実行。プロセス全体が記録され、SharePoint組み込みのバージョン履歴から元に戻すことができます。

関連ガイド：