service-process Commands
service-process deploy
This command deploys supported Service Process metadata, including:
- Service Process Attributes (anchor, custom, context)
- Intake flow
- Fulfillment flow
- Preprocessor reference
All other dependencies must already exist in the target org. Examples of these dependencies include:
- Apex classes used in flows
- Apex classes referenced by the preprocessor
- Unified Catalog context definition allowlisting
If any required dependency is missing in the org, the deployment fails.
Examples for service-process deploy
Deploy a Service Process from a ZIP file to an org with alias "prod":
1sf service-process deploy --input-zip ./service-process.zip --target-org prodDeploy while linking an existing intake flow:
1sf service-process deploy --input-zip ./service-process.zip --target-org prod --link-intakeDeploy while linking existing intake and fulfillment artifacts:
1sf service-process deploy --input-zip ./service-process.zip --target-org prod --link-intake --link-fulfillmentParameters
- --json
- Optional
-
Format output as json.
- Type: boolean
- --flags-dir FLAGS-DIR
- Optional
-
Import flag values from a directory.
- Type: option
- -o | --target-org TARGET-ORG
- Required
-
Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
- Type: option
- --api-version API-VERSION
- Optional
-
Override the api version used for api requests made by this command
- Type: option
- -z | --input-zip INPUT-ZIP
- Required
-
Path to the ZIP file that contains the Service Process metadata to deploy.
You typically generate this ZIP file with the `service-process retrieve` CLI command. The ZIP file contains the Service Process definition and supported metadata.
- Type: option
- --link-intake
- Optional
-
Link an existing intake flow instead of deploying a new one.
When specified, the command links the existing intake flow in the target org instead of deploying the intake flow from the ZIP file.
- Type: boolean
- --link-fulfillment
- Optional
-
Link an existing fulfillment artifact instead of deploying one.
When specified, the command links an existing fulfillment artifact (flow or flow orchestrator) in the target org instead of deploying the fulfillment flow from the ZIP file.
- Type: boolean
service-process list
To ensure predictable performance and avoid excessively large output, the command limits the number of records returned. If the maximum limit is reached, the results are truncated and a warning is displayed.
Use the `--limit` flag to control the maximum number of Service Processes returned.
Examples for service-process list
List the available Service Processes in the org with alias "devSandbox"; use the default limit:
1sf service-process list --target-org devSandboxList up to 100 Service Processes:
1sf service-process list --target-org devSandbox --limit 100Parameters
- --json
- Optional
-
Format output as json.
- Type: boolean
- --flags-dir FLAGS-DIR
- Optional
-
Import flag values from a directory.
- Type: option
- -o | --target-org TARGET-ORG
- Required
-
Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
- Type: option
- --api-version API-VERSION
- Optional
-
Override the api version used for api requests made by this command
- Type: option
- --limit LIMIT
- Optional
-
Maximum number of Service Processes to return.
Allowed range is 1–2000. Default is 1000.
- Type: option
- Default value: 1000
service-process retrieve
The command downloads the Service Process definition, identifies supported dependent metadata, retrieves those components, and bundles everything into a deployable artifact.
Supported metadata retrieved by this command includes:
- Service Process Attributes (anchor, custom, context)\
- Intake flow
- Fulfillment flow
- Preprocessor reference
Other dependencies, such as Apex classes used by flows or preprocessors, aren't retrieved and must already exist in the target org before deployment.
Examples for service-process retrieve
Retrieve a Service Process using its ID from the org with alias "devSandbox":
1sf service-process retrieve --service-process-id 0SPxx0000008ABC --target-org devSandboxRetrieve a Service Process and write the artifacts to a custom directory:
1sf service-process retrieve --service-process-id 0SPxx0000008ABC --target-org devSandbox --output-dir ./sp-artifactsParameters
- --json
- Optional
-
Format output as json.
- Type: boolean
- --flags-dir FLAGS-DIR
- Optional
-
Import flag values from a directory.
- Type: option
- -i | --service-process-id SERVICE-PROCESS-ID
- Required
-
ID of the Unified Catalog Service Process to retrieve from the source org.
- Type: option
- -d | --output-dir OUTPUT-DIR
- Optional
-
Directory where the retrieved Service Process artifacts and the generated ZIP file are written. If not specified, artifacts are written to `./service-process`.
- Type: option
- -o | --target-org TARGET-ORG
- Required
-
Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
- Type: option
- --api-version API-VERSION
- Optional
-
Override the api version used for api requests made by this command
- Type: option