Sale of Matrix Items: To Export Product Images
The following activity will walk you through the process of exporting the product images added for a template item and for a matrix item in MYOB Advanced to the Shopify store.
Story
Suppose that the SweetLife Fruits & Jams company wants to export to the Shopify store the images it has added for the JUICE template and for one of its variants. Some images of the template item are stored in external storage. The others, however, are attached to items in MYOB Advanced. Acting as an implementation consultant helping SweetLife to set up the integration of MYOB Advanced with the Shopify store, you need to export to the Shopify store an image of the JUICE template item and a matrix item generated from this template item.
Configuration Overview
In the U100 dataset, for the purposes of this activity, the following steps have been performed:
- On the Enable/Disable Features (CS100000) form, the Matrix Items feature has been enabled.
- On the Template Items (IN203000) form, the JUICE template item has been created.
- On the Stock Items (IN202500) form, the PCH-32OZ-GBT matrix item has been generated from the JUICE template item.
Process Overview
In this activity, you will do the following:
- On the Template Items (IN203000) form, add an image for the template item.
- On the Stock Items (IN202500) form, add an image for the stock item (which is a matrix item generated from the JUICE template).
- On the Prepare Data (BC501000) form, prepare the template item data for synchronization; on the Process Data (BC501500) form, process the template item data.
- In the admin area of the Shopify store, review the exported images.
- On the Shopify Stores (BC201010) form, activate the Product Image entity.
- On the Prepare Data (BC501000) form, prepare the product image data for synchronization; on the Process Data (BC501500) form, process the product image data.
- In the admin area of the Shopify store, review the exported images.
System Preparation
Before you complete the instructions in this activity, do the following:
- Make sure that the following prerequisites have been met:
- The Shopify store has been created and configured, as described in Initial Configuration: To Set Up a Shopify Store.
- The connection to the Shopify store has been established and the initial configuration has been performed, as described in Initial Configuration: To Configure the Store Connection.
- Download the following files to your computer:
- http://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice1.png
- http://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice2.png
- Launch the MYOB Advanced website with the U100 dataset preloaded, and sign in with the
following credentials:
- Username: gibbs
- Password: 123
Step 1: Adding an Image to the Template Item
To add an image to the JUICE template item, do the following:
- Open the Template Items (IN203000) form.
- In the Summary area, in the Inventory ID box, select Juice.
- On the Configuration tab, drag the
Juice1.png file, which you have downloaded, to the
Image area.
The file is uploaded, and you can browse it in the Image area or access it by clicking Files on the form title bar.
- On the eCommerce tab, in the Media
URLs table, add a row with the settings shown in the following
table.
URL Type http://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice3.png Image - On the form toolbar, click Save.
Step 2: Adding an Image to the Matrix Item
To add an image to the PCH-32OZ-GBT stock item, which is a matrix item based on the JUICE template item, do the following:
- Open the Stock Items (IN202500) form.
- In the Summary area, in the Inventory ID box, select PCH-32OZ-GBT.
- On the Attribute tab, drag the
Juice2.png file, which you downloaded, to the Image
area.
The file is uploaded, and you can browse it in the Image area or access it by clicking Files on the form title bar.
- On the form toolbar, click Save.
Step 3: Synchronizing the Template Item Data
To prepare and process the template item data (which includes the data of the matrix items generated from the template item) for synchronization, do the following:
- Open the Prepare Data (BC501000) form.
- In the Summary area of the form, specify the following settings:
- Store: SweetStore - SP
- Prepare Mode: Incremental
Incremental indicates that only the records that have been modified since the last successful data synchronization will be prepared.
- In the table, select the Selected check box in the row of the Template Item entity.
- On the form toolbar, click Prepare.
- In the Processing dialog box, which opens, click Close to close the dialog box.
- In the row of the Template Item entity, click the link in the Ready to Process column.
- On the Process Data (BC501500) form, which opens with the SweetStore - SP store and the Template Item entity selected, select the unlabeled check box in the row of the JUICE template item (for which the ERP ID column shows Juice).
- On the form toolbar, click Process.
- In the Processing dialog box, which opens, click Close to close the dialog box.
Step 4: Reviewing the Synchronized Images
To review the images that have been exported to the Shopify store for the Juice template item, do the following:
- Sign in to the admin area of the Shopify store as the store administrator.
- In the left menu, click Products.
- On the Products page, which opens, click the row of the
Juice product to open its product management page.
On the product management page of the Juice product, which opens, notice that the Media section contains only one image; this is the image you added to the Juice template item as an external link in the Media URLs table on the eCommerce tab of the Template Items (IN203000) form. Images added to this table are synchronized as part of the synchronization of the Template Item entity.
Step 5: Activating the Product Image Entity
You can skip this step if you have completed the following activity: Product Synchronization: To Sync Product Images.
To activate the Product Image entity, do the following:
- Open the Shopify Stores (BC201010) form.
- In the Store Name box of the Summary area, select SweetStore - SP.
- On the Entity Settings tab, select the Active check box in the row of the Product Image entity.
- On the form toolbar, click Save.
Step 6: Synchronizing the Product Image Data
To prepare and process the product image data (which includes the data of the images attached to template items and matrix items) for synchronization, do the following:
- Open the Prepare Data (BC501000) form.
- In the Summary area of the form, specify the following settings:
- Store: SweetStore - SP
- Prepare Mode: Incremental
- In the table, select the Selected check box in the row of the Product Image entity.
- On the form toolbar, click Prepare.
- In the Processing dialog box, which opens, click Close to close the dialog box.
- In the row of the Product Image entity, click the link in the Ready to Process column.
- On the toolbar of the Process Data (BC501500) form, which opens with the SweetStore - SP store and the Product Image entity selected, click Process All.
- In the Processing dialog box, which opens, click Close to close the dialog box.
Step 7: Reviewing the Exported Images
To review the images that have been exported to the Shopify store for the Juice template item and the matrix item, do the following:
- In the left menu of the admin area of the Shopify store, click Products.
- On the Products page, which opens, click the row of the
Juice product.
On the product management page of the Juice product, which opens, notice that two more images have been added to the Media section: one added for the JUICE template item on the Configuration tab of the Template Items (IN203000) form, and the other added for the PCH-32OZ-GBT stock item on the Attributes tab of the Stock Items (IN202500) form. Both images were exported during the synchronization of the Product Image entity. The image that was attached to the template item on the Configuration tab of the Template Items form is the main product image and appears larger than other thumbnails.
In the Variants section, notice that the image added for the PCH-32OZ-GBT stock item is also displayed for the peach juice as a thumbnail image.
- In the top right, click Preview, and review how the imported images are displayed on the product page on the storefront.
- At the top of the page, click Catalog, locate the Juice product, and review how the main product image is displayed on the product listing page.