SitecoreAI環境間のコンテンツ移行
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
コンテンツ転送APIとアイテム転送APIを使って、SitecoreAI環境間でコンテンツを移行できます。
- Content Transfer APIは、あるSitecoreAI環境から別の環境へ安全にコンテンツアイテムをエクスポートします。APIは、元の環境からのコンテンツデータを宛先環境の .raif ファイルにまとめます。
- アイテム転送API .raif ファイルを宛先データベースに読み込みます。
APIは標準的なHTTPリクエストまたはSitecoreコマンドラインインターフェース(CLI)を通じて利用できます。グラフィカルなインターフェースを好む場合は、SitecoreパートナーがこれらのAPIを裏で使っているコンテンツ転送アプリを公開Marketplaceで確認してください。
標準的なHTTPリクエストを通じてAPIを使用する手順については、「APIを使ったコンテンツの移行」ウォークスルーをご覧ください。同じ指示は、コンテンツ転送APIのMigrating contentセクションやアイテム転送API仕様にも記載されています。これにより、OpenAPI仕様を直接消費するAIコーディングアシスタントやエージェントツールが、開発環境を離れることなく移行ワークフローを案内できます。
!注Sitecore XM/XPサイトをSitecoreAIに移行するには(SitecoreAI環境間のコンテンツ移行ではなく)、代わりにSitecoreAI Pathwayを使用してください。
このトピックの残りは、以前Package Designerを使ってコンテンツ移行を行ったことがあり、既存のワークフローが新しいAPIにどのようにマッピングされているかを理解したい場合にのみ関係があります。
パッケージデザイナーのワークフローとの違い
ベースイメージバージョン1.8.24から2026年7月7日より、パッケージデザイナーはSitecoreAIで利用できなくなりました。以前はパッケージデザイナーを使ってSitecoreAI環境間でコンテンツを転送していた場合、今はコンテンツ転送APIとアイテム転送APIを使って同じ作業を行えます。
パッケージデザイナーは、.zipパッケージを生成して別のSitecoreAI環境にインストールすることで、SitecoreAI環境からアイテム、ファイル、セキュリティアカウントをエクスポートすることができました。新しいAPIはこれをサーバー側の転送機構に置き換え、以下の利点があります。
- サイズ制限はありません 。Content Transfer APIはチャンクストリーミングを使用しているため、大規模な移行を複数の小さなパッケージに分割する必要がありません。アイテム転送APIを使ってローカルファイルシステムから直接 .raif ファイルをアップロードする場合(コンテンツ転送APIを使わず)、100MBのファイルサイズ制限が適用されます。
- 手動のファイルのダウンロードやアップロードは不要 で、APIを通じて環境間で直接データストリームが行われます。
- マージ戦略は事前に設定されており 、インストール時に競合解決オプションを選択する代わりに、転送操作を作成する際に MergeStrategy を指定します。
以下のセクションでは、パッケージデザイナーのタスクやコンセプトを新しいワークフロー内の同等のものにマッピングします。
コンテンツ移行の概念
以下のパッケージデザイナーの概念は、コンテンツ転送APIおよびアイテム転送APIに直接対応しています。
パッケージデザイナーの概念
現代の同等物
アイテム追加
Scope: SingleItem において DataTrees
サブアイテムで追加
Scope: ItemAndDescendants において DataTrees
上書き(インストールオプション)
MergeStrategy: OverrideExistingItem
スキップ(インストールオプション)
MergeStrategy: KeepExistingItem
ツリー全体をマージする(インストールオプション)
MergeStrategy: OverrideExistingTree
生成 .zip
転送を作成しチャンクセットを完成させ、 .raif ファイルを生成します
インストールウィザード
アイテム転送API
.zip パッケージファイル
.raif ファイル
!警告OverrideExistingTreeは既存のアイテムを削除する唯一のマージ戦略です。転送された項目を書き込む前に、そのアイテムとそのすべての子孫を宛先から削除します。
プログラムによるパッケージ生成
以前にパッケージデザイナーではなくコードでプログラム的にパッケージを生成していた場合は、コード内で .raifファイルを生成し、アイテム転送APIの「 Upload a blob source 」エンドポイントを使って直接宛先環境にアップロードできます。この方法はファイルサイズが100MBに制限されており、より小規模でアドホックな転送を想定しています。大規模なプログラム移行の場合は、Content Transfer APIを使ってチャンクストリーミングで .raifファイルを生成してください。
Sitecore Content Hubから一括抽出して .raifファイルを生成する参考実装については、ContentHub.BulkTransfer.CLIを参照してください。このオープンソース.NET CLIツールは、Content HubエンティティをSitecoreアイテムにマッピングし、それらを .raifファイルに書き込む方法を示しています。これらはItem Transfer APIで消費されます。
あるいは、.raifファイルをソース管理を通じてビルドアーティファクトとしてデプロイすることも可能です。ファイルをプロジェクトリポジトリの {projectName}\App_Data\sitecore transferred items\master\ に入れ、そのフォルダをビルド設定に含めてください。この方法で展開されたファイルは1ファイルあたり最大5GBをサポートし、展開後はItem Transfer APIを使って手動で消費されます。
他のパッケージデザイナータスクの代替
コンテンツ転送APIおよびアイテム転送APIは、コンテンツ移行タスクでパッケージデザイナーを直接置き換えますが、デザイナーは新しいAPIがカバーしない他のタスクにも使用可能です。
- セキュリティアカウントの移行 - パッケージデザイナーはユーザーやロールのエクスポートとインストールが可能です。SitecoreAIで推奨される代替手段は以下の通りです:
- Claims mapping - 外部のアイデンティティプロバイダーの役割をSitecoreAIの役割にマッピングし、ユーザーアクセスが手動インポートせずに自動的に処理されるようにすること。
- Sitecore CLI - シリアライゼーションプラグインを使ってロール管理、例えばユーザー作成をプログラム的にスクリプト化するなど。
- コードや設定ファイルのデプロイ - パッケージデザイナーはDLL、設定、ハンドラーなどのファイルを直接SitecoreAI環境にインストールできます。この方法は環境が不変であるため、SitecoreAIではサポートされていません。つまり、この方法でインストールされたファイルは環境の再起動時に失われます。代わりに、すべてのコードと設定の変更をソースコントロールに含め、CI/CDパイプラインを通じてデプロイしてください。