SFRA Content Assets Integration

Use Builder's Plugin to create HTML Content Assets from Builder content entries. This is an API-only integration and doesn't require a cartridge installation.

How the integration works

The SFCC Content Assets Plugin works with a webhook that listens for any content changes on the Builder side and creates, updates, or deletes the HTML equivalent as a Content Asset in your SFCC library.

Diagram of the SFCC workflow. the first block says Builder Contant editor with a note that says allows dragon drop page building capabilities. This triggers SFCC web hook when content is changed or created. Arrow goes from this block to the SFCC web hook block. SFCC Web hook that says this web hook creates updates or deletes HTML content assets in FSFCC based on the content created by the user in the editor. Then there's an arrow that says saves to and it saves to the SFCC content library, which says builder content will appear as assets in your library of choice. There's also another arrow that goes both directions to and from the first SFCC web hook, it says Builder HTMLAPI, using the HTML API you can transform any content built with Builder Jason format into its HTML equivalent.

Set up in the SFCC API client

Assign the access permissions to your API client

In SFCC Business Manager, go to Administration > Site Development > Open Commerce API Settings
From the Select Type field, select ‘Data’
From the Select Context field, select ‘Global’
In the text field add the client ID from step 1 to the following json and paste it

{ "_v": "20.4", "clients": [ { "client_id": "Change this to match your API Client ID", "resources": [ { "resource_id": "/libraries/{library_id}/content/{content_id}", "methods": [ "get", "put", "patch", "delete" ], "read_attributes": "(**)", "write_attributes": "(**)" }, { "resource_id": "/libraries/{library_id}/content/{content_id}/folders", "methods": [ "get" ], "read_attributes": "(**)", "write_attributes": "(**)" }, { "resource_id": "/libraries/{library_id}/folders/{folder_id}", "methods": [ "get", "put" ], "read_attributes": "(**)", "write_attributes": "(**)" }, { "resource_id": "/libraries/{library_id}/folders/{folder_id}/content", "methods": [ "get" ], "read_attributes": "(**)", "write_attributes": "(**)" }, { "resource_id": "/libraries/{library_id}/folder_assignments/{content_id}/{folder_id}", "methods": [ "get", "put", "delete" ], "read_attributes": "(**)", "write_attributes": "(**)" }, { "resource_id": "/libraries/{library_id}/folders/{folder_id}/sub_folders", "methods": [ "get" ], "read_attributes": "(**)", "write_attributes": "(**)" } ] } ] }

Use the client ID and secret to connect to Builder

Go to Integrations and enable the SFRA/Site Genesis plugin

Add the client ID, password, main content assets library name and your instance path in the plugin configurations

Creating a Section model

In the Builder UI, create a Section model so you can create your content assets under it.

You can start by clicking Models in the left side nav on the Dashboard.

Click +Create Model.

Select Section from the list.

Enter Content Asset as the name for your new Section model or any name that make sense to your use case and click Create.

Establish SFCC content asset connection

Hit Show more options

Press Sync To SFCC

Press Save

You're all set now, try creating a new entry on the model you created, and upon publishing you should see it in your SFCC Content Assets Library