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 be used.
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 behaviour with this new header:
↓ 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 |