b2c-job

# Run and Monitor Jobs Use `b2c job` for existing jobs. To create job steps or author `jobs.xml`, use `b2c:b2c-custom-job-steps`. If `b2c` is unavailable, use `npx @salesforce/b2c-cli`. ## Configuration and tool choice CLI and MCP share configuration: `SFCC_*` variables (including project `.env`), project/shared `dw.json`, and plugins; `package.json` provides nonsecret defaults. Use `--project-directory` when running outside the target project. Inspect with `b2c setup inspect --json` or MCP `config_inspect`; both mask secrets by default. Override configured values only when needed. For resolution issues, use `b2c-cli:b2c-config`. No dedicated MCP job tool exists. In an MCP session, start, wait for, and review jobs in code mode (`skill://mcp/b2c-mcp-scapi/references/jobs.md`); use the CLI for archive transfer (import/export) and when running from a terminal. ## Run and inspect ```bash 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 ``` Rebuild a search index (system jobs take `--body`, never `-P`): ```bash b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":["MySite"]}' ``` `job run` returns immediately unless `--wait` is supplied. For raw system-job bodies, search indexing, standard step choices, execution deletion, and backend configuration: [run and monitor](references/RUN-AND-MONITOR.md). Deletion removes completed execution records; it does not cancel jobs. ## Site archives ```bash 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 ``` Import/export wait by default and transfer files over WebDAV. Jobs prefer SCAPI (`sfcc.jobs.rw` for writes, `sfcc.jobs` for reads); `--api-backend auto` falls back on supported SCAPI rejections. See the backend section in the run/monitor reference if access fails. Check job outcome before retrying a write. Read only the relevant reference: - Import remote archives or directory subsets: [import options](references/IMPORT.md). - Choose export data units or output paths: [export](references/EXPORT.md). - Author/validate XML and verify imported settings: `b2c-cli:b2c-site-import-export`. - Apply ordered, tracked migrations: `b2c-cli:b2c-import-set-migrations`. ## Output Normal CLI output suffices for status. For scripting, save large `--json` results to a file and print selected fields; keep the exit code and inspect failures. See [export](references/EXPORT.md), section `compact-results`. Avoid dumping full execution records or reading both JSON and human output for the same result.