bldr logo
Get Started

Contexts

BLDR defines SFMC Contexts as the builders/studios and objects/assets within SFMC. The processing and BLDR support may vary based on each specific context. In regard to BLDR commands, search and clone require a context flag to be used.


Context Flags

ContextFlag
Content Builder--cb, --content-builder
Automation Studio--as, --automation-studio
Data Extension--de, --data-extension



Content Builder Support

All assets within Content Builder are defined by their assetType and are identified by their assetId; because of this there are no sub-context distinctions made for asset types.

Fully Supported Assets

Fully supported assets are asset types that when cloned from SFMC are created as fully editable .html files.

  • html emails
  • code snippet content blocks
  • html content blocks

Partially Supported Assets

Partially supported assets are asset types that when cloned from SFMC are created as .json files. These files can still be updated/edited directly in the JSON structure and updated within SFMC.

Asset types that are partially supported are any not listed in the Fully Supported Assets section above.


CloudPages and Code Resource Pages

Support for CloudPages and Code Resource Pages falls somewhere in-between fully supported and partially supported.

These asset types will not show up or be cloned down when running the clone command for a folder Id -- these assets are stored under the root Content Builder folder. To access and clone CloudPages and Code Resource Pages, run bldr search --cb {cloudpage/resource name}. As long as the asset exists it will be displayed, then run bldr clone --cb -a <assetId>.

Once cloned, they will be created in the root Content Builder folder in your local directory.

Updating these assets in SFMC will be successful up until the point of publish. There is currently no API support for publishing CloudPages or Code Resource pages via API, however the code in the resource will be updated.


Automation Studio

Assets within Automation Studio are separated out into sub-contexts based on activity type. Currently, the following sub-contexts are available based on BLDRs support for activities.

Sub-ContextFlag
SQL Query:sql
Script Activity:ssjs

Sub-context flags can be used directly following the -f and -a flags. bldr search --as -a:sql <query name>
bldr clone --as -f:ssjs <ssjs folder id>


Fully Supported Assets

Fully supported assets are asset types that when cloned from SFMC are created as fully editable .html/.sql files.

  • query activities
  • script activities

Partially Supported Assets

Partially supported assets are asset types that when cloned from SFMC are created as .json files. These files can still be updated/edited directly in the JSON structure and updated within SFMC. Asset types that are partially supported are any not listed in the Fully Supported Assets section above.

SecurityConfig