b2c-site-import-export

サイトアーカイブ

サイトアーカイブの転送には、b2c job import／b2c job export を使用します。b2c が利用できない場合は、npx @salesforce/b2c-cli を使用してください。

設定とツールの選択

CLI と MCP は、解決済みの設定を共有します。対象には、SFCC_* 変数（プロジェクトの .env を含む）、プロジェクト／共有の dw.json、プラグインが含まれます。package.json は機密情報ではないデフォルト値を提供します。対象プロジェクト以外で作業する場合は、--project-directory を使用してください。b2c setup inspect --json または MCP の config_inspect で確認し、秘密情報はマスクしたままにしてください。通常、設定済みの値があれば、認証情報フラグや dw.json の手動読み込みは不要です。設定の解決に問題がある場合は、b2c-cli:b2c-config を使用してください。

アーカイブ転送専用の MCP ツールはありません。SCAPI コントラクトにない設定を含め、XML のインポートとエクスポートには CLI を使用してください。MCP の scapi_execute では、サポート対象の Admin フィールドを管理できます。メタデータレコードがあるだけでは、プロモーションの割引やターゲティングルールが設定されていることの証明にはなりません。

インポートと検証

1. 対象のサイト／カタログと、予定している変更を特定します。アーカイブには関連データのみを含め、無関係な設定と、指定された有効状態を維持してください。
2. プラットフォームのアーカイブ構造に沿って XML を作成します。b2c docs schema <name> で該当する XSD を確認し（名前の一覧は --list で表示）、ローカルで検証します。
3. ディレクトリまたは zip をインポートします。デフォルトではコマンドの完了を待機します。失敗時に --show-log を指定すると、ジョブログが表示されます。再試行する前に、処理が完了したことを確認してください。
4. 影響を受けたフィールドを読み戻します。API で取得できない場合は、該当するデータユニットをエクスポートし、関連する XML レコードを確認します。ジョブが成功しただけでは不十分です。

b2c job import ./archive --show-log
b2c job export --site MySite --site-data campaigns_and_promotions --output ./verification

--site のみを指定すると、すべてのサイトデータがエクスポートされます。対象を絞る場合は --site-data を指定してください。インスタンス全体をエクスポートするには --all を使用します。--site all、--catalog all などを指定すると、いずれか一つの種類のオブジェクトをすべて選択します。手書きの --data-units JSON よりも、これらのフラグを優先してください。ディレクトリ出力では、プラットフォームが生成する *_export ルートが保持されます。既存の移行や適用済みの移行を上書きしないでください。エクスポートには秘密情報や無関係なデフォルト値が含まれる場合があります。コミットする前に内容を確認して不要なものを削除し、XSD で必須とされているフィールドは維持してください。

関連リファレンス

• アーカイブ構造と XML ワークフロー：アーカイブのワークフロー。
• 属性／型の XML パターン：メタデータ XML。
• リモートインポート、サイズによる分割、インポートセットのオプション：インポートオプション。
• エクスポートフラグ、データユニット、簡潔な JSON 結果：b2c-job スキルのエクスポートリファレンス。
• 順序付き移行、命名、履歴、復旧：b2c-cli:b2c-import-set-migrations。
• サービス設定 XML：b2c:b2c-webservices。

ジョブでは SCAPI が優先されます。--api-backend auto を指定すると、サポート対象の拒否応答時に OCAPI にフォールバックできます。いずれの場合も、アーカイブ転送には WebDAV を使用します。ジョブのスコープ、バックエンドの選択、監視については、b2c-cli:b2c-job の該当セクションを参照してください。