EN
ES
DE
FR
NL
IT
JA
PT
PL
KO
ReplaceMagicとSharePointの統合 — 壊れたリンクをネイティブに修復
ReplaceMagicはSharePointを操作するための2つの方法を提供しています：ネイティブAPI統合（推奨）とマッピングドライブによるアクセスです。この2つの方法の違いを理解することで、お使いの環境に適したアプローチを選択でき、データの損失やメタデータの破損なしにドキュメント処理プロジェクトを正常に完了できます。
ネイティブ統合とマッピングドライブの比較
SharePointをWebDAV経由でネットワークドライブとしてマッピングすると、WindowsはSharePointライブラリをファイルシステムフォルダとして表示します。このアプローチは設定が簡単ですが、重要な制限があります：メタデータにアクセスできず、ドキュメントのチェックアウトとチェックインが管理されず、バージョン情報が処理ツールから見えません。また、特にVPNやWAN接続では速度が遅く、信頼性が低い場合があります。
一方、ネイティブAPI統合はREST APIとCSOMを通じてSharePointと直接通信します。これにより、ReplaceMagicはドキュメントのプロパティ、ライブラリの設定、WebDAVでは公開できないプラットフォームレベルの機能に完全にアクセスできます。ネイティブ統合はより高速で信頼性が高く、SharePoint向けReplaceMagicの全機能をサポートする唯一のモードです。
ネイティブ統合で可能なこと
ネイティブAPI統合を通じてのみ利用可能な機能 — マッピングドライブでは利用不可 — には以下が含まれます：
- 変更後の最終更新日時と作成者の保持
- 処理前の自動チェックアウトと完了後のチェックイン
- バージョン履歴の維持（変更は上書きではなく新しいバージョンとして表示）
- コンテンツ承認状態の保持
- WikiページとCanvasページ（モダンページ）の処理
- SharePointのスロットリング（HTTP 429）の適切な処理
- URLを置換するためのSharePointクイック起動バーと上部ナビゲーションバーへのアクセス
対応プラットフォーム
ReplaceMagicのネイティブ統合レイヤーは、ドキュメントストレージバックエンドとしてSharePoint APIを使用する以下のMicrosoftプラットフォームに対応しています：
- SharePoint Online — Microsoft 365クラウドでホストされるSharePoint
- SharePoint オンプレミス — 2010、2013、2016、2019およびSubscription Editionバージョン
- Microsoft Teams — TeamsチャンネルのファイルはSharePointドキュメントライブラリに保存され、ReplaceMagicは同じSharePoint APIを通じて処理します
- OneDrive for Business — OneDrive for BusinessはSharePointで動作し、そこに保存されたファイルは同じネイティブ統合を通じてアクセス可能です
認証モードの概要
ReplaceMagicはすべてのSharePoint展開シナリオに対応するため、6つの認証モードをサポートしています：
- オンライン（ユーザー名/パスワード） — SharePoint Online向けの標準Microsoft 365資格情報
- Windows認証 — オンプレミスSharePoint向けのドメイン資格情報
- 匿名 — 資格情報が不要な公開アクセスサイト向け
- アプリパスワードによるMFA — 多要素認証で保護されたMicrosoft 365アカウント向け
- アプリのみの認証 — 自動化された無人ワークフロー向けのAzure AD アプリケーション資格情報
- レガシー認証モード — モダン認証プロトコルが無効になっているオンプレミス環境向け
ネイティブ統合で処理されるコンテンツの種類
SharePointのネイティブAPIを通じて、ReplaceMagicは以下を処理できます：
- 標準ドキュメントライブラリ（すべてのOfficeファイル形式、PDFなど）
- SharePointリストアイテム（リストアイテムの処理オプションが有効の場合）
- エンタープライズWikiページとCanvasページ（モダンページ）
- SharePoint内のASPXページ（すべてのSharePointライブラリモードが有効の場合）
- クイック起動バーと上部ナビゲーションバーのURL
パフォーマンスと設定
ネイティブ統合は設定可能な並列処理をサポートしています。SharePoint Onlineの場合、Microsoftのスロットリング制限内に収まるよう3〜5スレッドを推奨します。オンプレミス環境では、より多くのスレッドを使用できます。組み込みのスロットリング検出機能は、429レスポンスを受信すると自動的に一時停止して再試行し、手動介入なしに処理が継続されることを保証します。
競合ツールと比較した優位性
ReplaceMagicのSharePointネイティブ統合は、処理マシンにMicrosoft Officeがインストールされている必要がありません。Office Automation（COM相互運用）を使用しないため、GUIなしのサーバーや、GUIを必要としないスケジュールタスクとして実行できます。移行ワークフローやスクリプトへの統合のためのコマンドラインモードが利用可能で、手動操作が実用的でない大規模なエンタープライズ展開にReplaceMagicを適したものにしています。
