EN
ES
DE
FR
NL
IT
JA
PT
PL
KO
ReplaceMagicのSharePoint設定 — 設定の完全ガイド
ReplaceMagicのSharePoint固有の設定はすべて、設定パネルのSharePointタブにあります。メインツールバーの設定ボタンをクリックしてアクセスします。このタブでは、メタデータの保持、ドキュメントロックの動作、プラットフォーム制限、ページ処理モード、エンコードオプションを制御します。大規模な処理ジョブを開始する前に各設定を理解することで、予期しない結果を回避し、SharePoint環境の整合性を保護することができます。
メタデータとドキュメント状態の設定
- 最終更新日時と更新者を保持 — ReplaceMagicが変更されたファイルをアップロードした後、元の最終更新タイムスタンプと元の編集者名を復元します。この設定には、対象サイトコレクションのサイト管理者権限が必要です。その権限がない場合、SharePointはReplaceMagicのサービスアカウントを最終編集者として記録し、更新時刻を現在の時刻に設定します。
- ドキュメントのチェックアウト / チェックイン — ReplaceMagicはダウンロード前に自動的にドキュメントをチェックアウトし、変更されたバージョンのアップロード後にチェックインします。これにより、処理中に他のユーザーがファイルを変更できないようにし、SharePointが変更を適切な新バージョンとして記録することを保証します。
- チェックインを強制（Enforce Check-in） — 有効にすると、ReplaceMagicは現在他のユーザーによってチェックアウトされているドキュメントのチェックインを強制します。このオプションは慎重に使用してください。他のユーザーがまだチェックインしていない保留中の変更が破棄されます。ライブラリが非アクティブであることが分かっている自動移行シナリオに最も適しています。
- コンテンツ承認状態を保持 — ライブラリがコンテンツ承認を使用している場合、この設定は処理後にドキュメントの元の承認済み、拒否済み、または保留中の状態を復元します。このオプションがない場合、承認済みドキュメントが変更後に保留中に戻る可能性があります。
- 公開状態を保持 — 各ドキュメントのメジャー/マイナーバージョンの表示を維持します。処理前にメジャーバージョンとして公開されていたドキュメントは、ReplaceMagicが作業を完了した後も公開されたままになります。
- バージョン管理を設定 — ドキュメントをチェックインする際にReplaceMagicがSharePointのバージョン管理システムとどのように連携するかを制御します。各処理済みドキュメントがバージョン履歴に正しく記録されるように有効にしてください。
クエリと制限の設定
- クエリ行チェック（Query Row Check） — SharePointリストクエリごとに取得するアイテムの最大数を設定します。デフォルト値は4,900で、最大値は5,000です。これはSharePointリストビューしきい値と一致します。1回のクエリで5,000アイテムを超えるとSharePointがしきい値エラーを返します。デフォルト値の4,900はその制限より安全な余裕を提供します。特定の理由がある場合にのみ調整してください。
- 最大ドキュメントID値（Max Doc ID Value） — IDベースのリンクを解決する際にReplaceMagicが取得しようとするSharePointの最大ドキュメントIDです。デフォルト値は30,000,000で、SharePointの内部最大値に合わせています。テナントに異常に高いドキュメントID範囲がある場合にのみこの値を増やしてください。
ライブラリとページスコープの設定
- すべてのSharePointライブラリ — 有効にすると、ReplaceMagicは標準のドキュメントライブラリに加えて、非表示のシステムライブラリとASPXページのコンテンツにもアクセスします。このモードは強力ですが、通常エンドユーザーには表示されないSharePointシステムファイルが公開されるため、慎重に使用する必要があります。
- リストアイテムを処理 — SharePointリストアイテムのフィールド（ドキュメントファイルだけでなく）のURL置換を有効にします。リスト列に更新が必要なハイパーリンクやファイルパスが格納されている場合に便利です。
- クイック起動と上部ナビゲーションバー — 有効にすると、ReplaceMagicはSharePointサイトのクイック起動ナビゲーションパネルと上部ナビゲーションバーに埋め込まれたURLも更新します。これは、ナビゲーションリンクが古いテナントのURLを指しているテナント間移行後に特に便利です。
エンコードとレガシー設定
- SharePointページのHTMLデコード/エンコード — HTMLエンコードされたコンテンツを格納するEnterprise Wikiページの場合、このオプションは処理前にコンテンツをデコードし、処理後に再エンコードします。特殊文字がHTMLエンティティとして格納されている特定のレガシーWikiページ形式に必要です。
- SharePointページのUnicodeデコード/エンコード — SharePointページのコンテンツを読み書きする際にUnicode正規化を適用します。ページコンテンツに正しく保持する必要があるUnicodeエスケープシーケンスが含まれている場合に有効にしてください。
- SharePointレガシー認証モード — 古いオンプレミスSharePointファームのフォームベースまたは基本認証と互換性のあるレガシーモードに認証プロトコルを切り替えます。SharePoint Onlineには影響しません。
- SharePointのネイティブリンク切れチェック — ファイルをダウンロードする代わりに、SharePoint APIを使用してリンク切れチェックをその場で実行します。この方法はReplaceMagicの標準的なファイルベースのチェックよりも大幅に遅く、大規模なライブラリには推奨されません。ファイルベースのチェックが特定のシナリオに適していない場合にのみ使用してください。
- スキップされたすべてのドキュメントを処理 — 特定のエラーコードにより前回の実行でスキップされたドキュメントをReplaceMagicに強制的に再処理させます。根本的な問題を解決した後（例：追加の権限を付与した後）、最初のパスで処理されなかったドキュメントを復元するために使用してください。
シナリオ別推奨設定
- SharePoint Onlineへの移行：最終更新日時と更新者を保持、チェックアウト/チェックイン、コンテンツ承認状態を保持、公開状態を保持を有効にします。並列スレッドを3–5に設定します。
- オンプレミスからSharePoint Onlineへの移行：上記と同様。ナビゲーションリンクの更新が必要な場合は、クイック起動と上部ナビゲーションバーも有効にします。
- テナント間移行：すべてのメタデータ保持オプションを有効にします。リストアイテムを処理とクイック起動/上部ナビゲーションバーを有効にします。最大ドキュメントID値が移行元テナントのすべてのIDベースリンクをカバーするのに十分な高さであることを確認してください。
