@taurgis/sfccdx
v0.2.3
Published
SFCCDX is a command line interface (CLI) for Salesforce Commerce Cloud. It can be used to easily manage (meta)data (import/export) in relation to your project.
Downloads
10
Maintainers
Readme
SFCCDX (Salesforce Commerce Cloud Developer Experience)
Salesforce Commerce Cloud Developer Experience is a command line interface (CLI) for Salesforce Commerce Cloud. It can be used to easily move metadata from and to your environment.
The CLI can be used from any machine either locally or from build tools, like Jenkins, Travis CI, Bitbucket Pipelines, Heroku CI etc.
Not sure where to start? Check out the Use Cases section.
Roadmap
Want to help out? Checkout the roadmap!
Known Limitations
There are limitations to the OCAPI, and those that affect this tool have been documented here.
Required config files
Two files need to be present in the project root.
dw.json
The standard dw.json file is used to determine the hostname.
{
"hostname": "devxx-eu01-project.demandware.net",
"username": "user",
"password": "password"
}
ocapi.json
A second file named ocapi.json is used to determine the client ID and secret.
{
"clientid": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"clientsecret": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}
Business Manager
OCAPI Configuration (Data)
Since we are making use of the OCAPI Data Resources, your configured Client ID needs access to these resources.
{
"_v": "21.10",
"clients": [
{
"client_id": "<YOUR-CLIENT-ID-HERE>",
"resources": [
{
"resource_id": "/system_object_definitions",
"methods": [
"get"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*",
"methods": [
"get"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*/attribute_definitions",
"methods": [
"get"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*/attribute_definitions/*",
"methods": [
"delete",
"get",
"patch",
"put"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*/attribute_groups",
"methods": [
"get"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*/attribute_groups/*/attribute_definitions/*",
"methods": [
"delete",
"put"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
},
{
"resource_id": "/system_object_definitions/*/attribute_groups/*",
"methods": [
"delete",
"get",
"patch",
"put"
],
"read_attributes": "(**)",
"write_attributes": "(**)"
}
]
}
]
}
Using the Command Line Interface
Usage: sfccdx [options] [command]
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
environment [options] Attempts to read the current configuration either through the CLI, the dw.json & ocapi.json configuration file, or a
combination (overriding the JSON via the CLI)
verify [options] Verifies the B2C Commerce environment by making an authorization call.
attribute:get [options] Fetch all information about a given standard or custom attribute.
attribute:delete [options] Delete a custom attribute on an object.
attribute:push [options] Push a custom attribute to an object.
attributegroup:get [options] Fetch all information about a given Attribute Group.
attributegroup:delete [options] Delete a Attribute Group from an object.
attributegroup:push [options] Push a Attribute Group to an object.
attributegroup:assignment:delete [options] Delete a Attribute Group assignment.
help [command] display help for command.