Product Catalogue & Starter Kit Integration
The following page aims to explain how the information contained within the Product Catalogue is integrated with StarterKit.
There are two parts that need to happen for a product to appear on the Starter Kit Websites:
- Updating products in the product catalogue
- Create product pages in the Starter Kit back office
This document is intended to give you a list of steps needed to edit a product ready for the starter kit, it is not a full overview of the features available in the product catalogue to access this visit the Build Studio Help Site. It is likely that an agency is creating the website and the product pages so that will not be outlined in this document.
Below are the steps needed to edit a product:
- Log in to product catalogue. You should already have been sent information on how to do this when your user account was set up.
- Your language may be set automatically by your browser, if not select your language by pressing Menu > Language > then selecting a language
- In the search box enter an SKU number (also known as MDM Number or Drawing Number) then click search or press enter
If a match is found a product will be returned. You should only edit products that are in the staged catalogue. Represented by the value Staged when on the grid view or by a red circle split into two pieces. If there are two versions of a product one starting EA_ and one starting CAR_ you will need to click on the one starting EA_ to edit an Each
Double click on the product to open the editor area and start to add product information. As you click to the next field product data will be saved automatically.
To upload an image, scroll down to the Multimedia section then press the symbol […]
Then follow the on screen instructions to upload an image, it should look similar to the following after an image has been uploaded
For the product to be available for selection in the CMS/Starter Kit it needs to be Approved and Synchronized. Without the following steps PRODUCT DATA WILL NOT APPEAR ON A WEBSITE.
To approve a product click the Star symbol at the top of the editor pane then click Approved (Depending on your language settings these values are likely to be translated). Approval is apparent by the appearance of a green tick.
To synchronize the product data click the blue circle that is split into two pieces in the editor area section:
One of two things will now happen depending on your user permissions.
Path A: If you have access to all markets you will have been given a global synchronization job so the synchronization will start immediately. This will synchronize all languages for the selected product. This may take between 1‑2 minutes but will synchronize all the relevant products data and images.
Path B: If you have access to 1 market (or a group of markets) a pop up will appear:
a. Click the Target tab. A series of Synchronization jobs will appear. Yours will differ slightly: LocalSync_es should match the language in your market eg. United States should be LocalSync_en_US, and if you are in a market, which has multiple languages, you will have access to more synchronization jobs.If it is the first time you have edited this product then all three synchronization jobs need to be run. CreateProductInOnlineCatalog must be run first in order to create the product.
If the product has been synchronized before then run the NoneLocalSync job and the local sync job(s) e.g. LocalSync_es
b. To synchronize click on a synchronization job then click SynchronizeAfter a short while the red circle split into two pieces will show green:
c. Repeat the synchronization for the other two jobs:
The search box should still have the product code in it so click search again. If the synchronization jobs have run successfully then you should see two products:
The above two products should now be identical; the data in the Online catalogue represented by Online will be available to the Starter Kit back office (providing the relevant steps have been completed by the agency).
If you need to make any changes to the product, just double click the product with the code Staged make your changes and then run the synchronization jobs again. This allows you to start making changes to a product without affecting the data on the websites.
You can then repeat the above steps for all of the products that need to be on the website.
To give you an idea of how it looks when completed, see the example from Dobendan in Germany.
Important information
- Making a change in the product catalogue does not automatically change the website. The product page will need to be refreshed in the Umbraco back office of the Starter Kit site.
- Unless the following steps are completed the product will not be available in the Umbraco back office:
- All relevant synchronization jobs are run
- A product is set to approved
- The relevant configuration has been added to Umbraco (done by agency)
- A good way to check if the product information has been synchronized is to go to the http://productexplorer.digital-rb.com/ then choose the market, language then brand you are interested in . If you see the product you are interested in the it should be available in the back end of Umbraco, if it is not visible go back and check if the product is approved, synchronized or if it has data in the language you are looking at
Helpfull Video
The way that the Product Catalogue is integrated with StarterKIt is also explained in a video here
Do note that you will need Build Studio access to access the above link. If you do not have it yet, please raise a request with Assist Support so as to obtain it.
Related articles