---
title: "SitecoreAI環境間のコンテンツ移行"
slug: "migrating-content-between-sitecoreai-environments"
abstract: "SitecoreAI環境から別の環境へコンテンツを移行する方法や、レガシー移行ワークフローを現代的なアプローチで置き換える方法を説明しています。"
---
# SitecoreAI環境間のコンテンツ移行

[コンテンツ転送](https://api-docs.sitecore.com/sai/content-transfer-api)APIと[アイテム転送API](https://api-docs.sitecore.com/sai/item-transfer-api)を使って、SitecoreAI環境間でコンテンツを移行できます。

-   Content Transfer APIは、あるSitecoreAI環境から別の環境へ安全にコンテンツアイテムをエクスポートします。APIは、元の環境からのコンテンツデータを宛先環境の .raif ファイルにまとめます。
-   アイテム転送API .raif ファイルを宛先データベースに読み込みます。

APIは標準的なHTTPリクエストまたは[Sitecoreコマンドラインインターフェース(CLI)](https://doc.sitecore.com/sai/en/developers/sitecoreai/sitecore-command-line-interface.html)を通じて利用できます。グラフィカルなインターフェースを好む場合は、SitecoreパートナーがこれらのAPIを裏で使っているコンテンツ転送アプリを公開[Marketplace](https://portal.sitecorecloud.io/marketplace)で確認してください。

標準的なHTTPリクエストを通じてAPIを使用する手順については、「[APIを使ったコンテンツの移行](https://doc.sitecore.com/sai/ja/developers/sitecoreai/deploying-sitecoreai/migrating-content-between-sitecoreai-environments/migrate-content-between-sitecoreai-environments.html)」ウォークスルーをご覧ください。同じ指示は[、コンテンツ転送API](https://api-docs.sitecore.com/sai/content-transfer-api/section/migrating-content)の*Migrating content*セクションや[アイテム転送API](https://api-docs.sitecore.com/sai/item-transfer-api/section/migrating-content)仕様にも記載されています。これにより、OpenAPI仕様を直接消費するAIコーディングアシスタントやエージェントツールが、開発環境を離れることなく移行ワークフローを案内できます。

> !注Sitecore XM/XPサイトをSitecoreAIに移行するには(SitecoreAI環境間のコンテンツ移行ではなく)、代わりに[SitecoreAI Pathway](https://doc.sitecore.com/sai/ja/developers/sitecoreai/migrate-a-site-to-sitecoreai.html)を使用してください。

このトピックの残りは、以前Package Designerを使ってコンテンツ移行を行ったことがあり、既存のワークフローが新しいAPIにどのようにマッピングされているかを理解したい場合にのみ関係があります。

## パッケージデザイナーのワークフローとの違い

[ベースイメージバージョン1.8.24](https://developers.sitecore.com/changelog/sitecoreai/07072026/sitecoreai-base-image-release-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](https://api-docs.sitecore.com/sai/item-transfer-api#operation/uploadBlobSource) 」エンドポイントを使って直接宛先環境にアップロードできます。この方法はファイルサイズが100MBに制限されており、より小規模でアドホックな転送を想定しています。大規模なプログラム移行の場合は、Content Transfer APIを使ってチャンクストリーミングで .raifファイルを生成してください。

Sitecore Content Hubから一括抽出して .raifファイルを生成する参考実装については、[ContentHub.BulkTransfer.CLI](https://github.com/Sitecore/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*](https://doc.sitecore.com/sai/en/developers/sitecoreai/user-security/users-roles-and-domains/assign-sitecoreai-roles-with-claims-mapping.html) - 外部のアイデンティティプロバイダーの役割をSitecoreAIの役割にマッピングし、ユーザーアクセスが手動インポートせずに自動的に処理されるようにすること。
    -   [*Sitecore CLI*](https://doc.sitecore.com/sai/en/developers/sitecoreai/sitecore-command-line-interface.html) - シリアライゼーションプラグインを使ってロール管理、例えばユーザー作成をプログラム的にスクリプト化するなど。
-   *コードや設定ファイルのデプロイ* - パッケージデザイナーはDLL、設定、ハンドラーなどのファイルを直接SitecoreAI環境にインストールできます。この方法は環境が不変であるため、SitecoreAIではサポートされていません。つまり、この方法でインストールされたファイルは環境の再起動時に失われます。代わりに、すべてのコードと設定の変更をソースコントロールに含め、CI/CDパイプラインを通じてデプロイしてください。