EN
ES
DE
FR
NL
IT
JA
PT
PL
KO
ReplaceMagic使用時のSharePoint既知制限事項
ReplaceMagicはSharePointでのドキュメント処理の複雑さをすべて処理できるように設計されていますが、他のベンダーが作成したプラットフォーム内で動作するツールと同様に、特定の制約が適用されます。このページに記載されている制限事項は、SharePoint自体、WindowsオペレーティングシステムまたはOfficeファイル形式の仕様によって課されるものです。大規模な移行プロジェクトを開始する前にこれらの制限を理解しておくことで、効果的に計画を立て、予期せぬ問題を回避することができます。
グループ1: ファイルとパスの制限事項
- ファイル名の特殊文字 — 名前に以下のいずれかの文字を含むファイルは、SharePoint APIを通じて共有リンクトークンや組織リンクを取得できません: ~ # % & * { } \ : <> ? / + | "。これらのファイルはダウンロードされ、コンテンツ内の壊れたリンクを検出するために処理され、再アップロードされますが、トークンでファイルを参照する共有リンク形式のURLは修復できません。これはReplaceMagicではなく、SharePoint REST APIの制限です。
-
Windowsパス長制限（260文字） — ReplaceMagicがSharePointからファイルを処理のためにローカルの一時パスにダウンロードする場合、一時フォルダーパスとファイル名の合計長が260文字を超えてはなりません。ReplaceMagicの処理設定に回避策があります: 長いパスのサポートを有効にするか、一時フォルダーパスを
C:\Tempのようなルートレベルのディレクトリに短縮してください。 - ExcelのリンクソースパスYの長さ — Excelは外部リンクソースのパス長に最大値を課しています。古いExcel形式（.xls）では、リンクソースの最大パス長は253文字です。新しい形式（.xlsx、.xlsm）では、制限は2,000文字です。置換によってこれらの制限を超えるURLやファイルパスが生成された場合、ReplaceMagicはその特定のリンクをスキップし、結果レポートに記録します。ドキュメント自体は処理されますが、長すぎるリンクのみがスキップされます。
グループ2: SharePointプラットフォームの制限事項
- SharePointリストビューのしきい値（5,000アイテム） — SharePoint Onlineおよびオンプレミスはリストクエリごとに最大5,000アイテムを課しています。ReplaceMagicはこのしきい値を安全に下回るように、デフォルトのクエリ行制限として4,900を使用します。SharePoint設定タブでこの値を下げると、クエリは小さくなり安全になりますが、大規模なライブラリの列挙に時間がかかります。
- 最大ドキュメントID（30,000,000） — IDベースのSharePointリンクを解決する際、ReplaceMagicは設定された最大値までドキュメントIDを反復処理します。デフォルト値の30,000,000はSharePointの実際の上限と一致しています。テナントにこの値を超えるIDを持つドキュメントがある場合（非常に大規模で長期間運用されているテナントでは稀ながら可能）、設定の最大ドキュメントID設定を増やしてください。
- SharePointレート制限（HTTP 429 / 503） — SharePoint OnlineはAPIリクエストにレート制限を課しています。ReplaceMagicはスロットリング応答を検出して自動的に再試行しますが、高い並列処理を持続させると、スロットリングによる遅延が発生します。SharePoint Onlineに推奨されるスレッド数は3〜5です。スロットリングが利益を打ち消すため、より多くのスレッドを使用してもSharePoint Onlineではスループットが比例して向上しません。
- モダン認証の要件 — テナント管理者はMicrosoft 365でレガシー認証プロトコルを無効にできます。これにより、ユーザー名/パスワードおよびアプリパスワードのサインイン方法が機能しない場合があります。この場合、Azure ADアプリ登録を使用したアプリ専用認証を使用してください。アプリ専用認証はレガシー認証の制限を受けません。
グループ3: メタデータとバージョン管理
- 最終更新日と作成者の保持にはサイト管理者権限が必要 — ReplaceMagicは、元の編集者と変更タイムスタンプを復元するために、SharePoint APIへの特権呼び出しを使用します。この呼び出しはサイト管理者権限（サイトコレクション管理者）を持つアカウントのみが使用できます。投稿者またはメンバーの権限では不十分です。処理アカウントが投稿者権限のみを持つ場合、変更者フィールドには処理アカウントが表示され、変更日は処理時点に設定されます。
- ネイティブSharePointモードではドキュメントバックアップが利用不可 — ReplaceMagicの組み込みファイルバックアップ機能（変更前にオリジナルをバックアップフォルダーにコピーする）は、SharePoint APIを通じてネイティブにドキュメントを処理する場合は機能しません。SharePointの組み込みバージョン履歴をセーフティネットとして使用してください。処理ジョブを実行する前に、対象ライブラリでバージョン管理が有効になっていることを確認してください。
- コンテンツ承認状態の保持には適切な権限が必要 — 処理後にドキュメントのコンテンツ承認状態を復元するには、処理アカウントがライブラリ内のアイテムを承認および却下する権限を持っている必要があります。承認権限がない場合、ReplaceMagicはコンテンツの変更を完了しますが、承認状態を復元できません。
グループ4: 接続性
- ローカルネットワークアクセスが必要 — オンプレミスのSharePointの場合、ReplaceMagicはネットワーク経由でSharePointサーバーに到達できるマシンにインストールする必要があります。マシンはDNSでSharePointサーバーのホスト名を解決し、適切なHTTPまたはHTTPSポートで接続できる必要があります。SharePointサーバー自体にはコンポーネントはインストールされませんが、ネットワークの可視性は必須です。
- 企業プロキシとファイアウォール — 組織が発信HTTPSトラフィックを企業プロキシやファイアウォール経由でルーティングしている場合、SharePoint OnlineへのReplaceMagicの接続がブロックされるかプロキシ認証が必要になる場合があります。ReplaceMagicの処理設定パネルでプロキシ設定を構成してください。プロキシでSSLインスペクションが有効になっている場合、SharePoint Onlineの証明書が無効と表示される場合があります — ネットワークチームと連携して必要な例外を追加してください。
これらの制限事項は、移行プロジェクトを正確に計画するためのものです。ここに記載されていない特定のシナリオが発生した場合は、support@replacemagic.comまでお問い合わせください。喜んでアドバイスいたします。
