mcpField
B
b2c-job

b2c-job

github.com/salesforcecommercecloudクラウド・DevOps5794 回インストール今日更新
リポジトリ

b2c-job について

`b2c` CLI で既存の Salesforce B2C Commerce ジョブを実行、待機、確認するスキルです。サイトアーカイブのインポートとエクスポートも扱い、MCP ではコードモードでの操作を案内します。

主な機能

  1. 01ジョブの実行と任意の待機
  2. 02実行履歴の検索とログ確認
  3. 03パラメーターやシステムジョブ本文の指定
  4. 04サイトアーカイブのインポートとエクスポート

活用シーン

  1. 01スケジュール済みジョブやシステムジョブの実行
  2. 02失敗したジョブ実行の確認
  3. 03サイトデータのインポートまたはエクスポート

MCP 対応

専用の MCP ジョブツールはありません。MCP セッションではコードモードでジョブの開始、待機、確認を行い、アーカイブ転送やターミナルでの操作には CLI を使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-job

インストール後、Claude Code で/b2c-jobを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
trigger-evals.json
references/
EXPORT.md
IMPORT.md
RUN-AND-MONITOR.md

詳細

ジョブの実行と監視

既存のジョブには b2c job を使用します。ジョブステップを作成したり、jobs.xml を作成したりするには、b2c:b2c-custom-job-steps を使用します。b2c が利用できない場合は、npx @salesforce/b2c-cli を使用します。

設定とツールの選択

CLI と MCP は設定を共有します。設定には SFCC_* 変数（プロジェクトの .env を含む）、プロジェクト／共有の dw.json、プラグインが含まれます。package.json はシークレット以外のデフォルト値を提供します。対象プロジェクトの外部から実行する場合は、--project-directory を使用してください。b2c setup inspect --json または MCP の config_inspect で設定を確認できます。どちらもデフォルトでシークレットをマスクします。必要な場合にのみ、設定済みの値を上書きしてください。設定の解決に問題がある場合は、b2c-cli:b2c-config を使用してください。

専用の MCP ジョブツールはありません。MCP セッションでは、コードモード（skill://mcp/b2c-mcp/references/jobs.md）でジョブを開始し、完了を待って結果を確認してください。アーカイブの転送（インポート／エクスポート）とターミナルからの実行には CLI を使用します。

実行と確認

b2c job run my-job --wait --timeout 600
b2c job run my-job --wait -P key=value
b2c job search --job-id my-job --count 5
b2c job wait my-job execution-id --timeout 600
b2c job log my-job --failed

検索インデックスを再構築します（システムジョブでは --body を使用し、-P は使用しません）。

b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":["MySite"]}'

job run は --wait を指定しない限り、すぐに戻ります。システムジョブの生の本文、検索インデックス作成、標準的なステップの選択、実行記録の削除、バックエンドの設定については、実行と監視を参照してください。削除すると完了済みの実行記録が削除されます。ジョブはキャンセルされません。

サイトアーカイブ

b2c job import ./archive --show-log
b2c job import ./storefront-export.zip --wait-for-storefront
b2c job export --site MySite --site-data campaigns_and_promotions --output ./export
b2c job export --storefront my-storefront --output ./export
b2c job export --all --output ./full-export

インポート／エクスポートはデフォルトで完了を待ち、WebDAV 経由でファイルを転送します。ジョブでは SCAPI が優先されます（書き込みには sfcc.jobs.rw、読み取りには sfcc.jobs）。--api-backend auto は、サポート対象の SCAPI 拒否応答があった場合にフォールバックします。アクセスに失敗する場合は、実行／監視のリファレンスにあるバックエンドのセクションを参照してください。書き込みを再試行する前に、ジョブの結果を確認してください。

関連するリファレンスのみを参照してください。

  • リモートアーカイブまたはディレクトリのサブセットをインポートする場合：インポートオプション。
  • エクスポートするデータ単位または出力先を選択する場合：エクスポート。
  • XML の作成／検証と、インポートした設定の確認には、b2c-cli:b2c-site-import-export を使用します。
  • 順序付けられた追跡可能なマイグレーションの適用には、b2c-cli:b2c-import-set-migrations を使用します。

出力

ステータスの確認には通常の CLI 出力で十分です。スクリプトでは、大きな --json の結果をファイルに保存して、必要なフィールドだけを出力してください。終了コードを保持し、失敗を確認してください。エクスポートの compact-results セクションを参照してください。実行記録全体の出力や、同じ結果について JSON と人間向けの出力の両方を読み込むことは避けてください。

コメント

Markdown 対応