JSON BackOffice configuration

Dec 8, 2021


Concept

BackOffice configuration on your Studio project can now be done not only with a CSV file, but also with a JSON file. JSON files are lightweight, text-based, human-readable, and can be edited using a text editor.


How-to

Step 1: Choose a project

1- You need to choose a project. Here let’s choose “Anousha”

 

Step 2: Back office tab

1- You need to be on the “Back Office” tab.

 

2- Once you are on your “Back Office” tab, please click on “Add new configuration”.

 

4- Enter the name you wish to give to the file.

 

5- Choose the JSON file.

 

6- Add your JSON file.

 

7- Save your changes.

You will get this view :

 

Step 3: Semantics tab

When you access “Semantics tab”, you need to enter the fields and perform the steps you usually do.

Step 4: Send your data

When sending your data, add an new header (swConfigurationName) to specify which configuration you want to use.

POST {root_url}/vcloud/v1/stores/{storeId}/items Headers: swConfigurationName: MENDY Content-Type: application/json Ocp-Apim-Subscription-Key: •••••••••••••••••••••••••••••••• [ { "ID": "1245", "SKU": "ABCDE" } ]

For more information regarding how to send data, please refer to https://api-portal-eu.vusion.io/Quickstart-VCloudAPI-vcloud or https://api-portal-us.vusion.io/Quickstart-VCloudAPI-vcloud

Please note the following behavior with this new header:

↓ sent header \ Studio configurations→

None

One

Many

↓ sent header \ Studio configurations→

None

One

Many

null or missing

process as usual

process as usual

process as usual

default

process as usual

Use this configuration

Fail (data is ignored)

Known value (from the list of configurations)

n/a

Use this configuration

Use the specified one

Unknown value

fail

fail

fail