Selling Matrix Items: To Export Product Images

The following activity will walk you through the process of exporting product images in MYOB Advanced to the BigCommerce store. These images have been added for a template and for a matrix item.

Story

Suppose that the SweetLife Fruits & Jams company wants to export to the BigCommerce 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 BigCommerce store, you need to export to the BigCommerce store an image of the JUICE template item and an image of a matrix item generated from this template item.

Configuration Overview

In the U100 dataset, for the purposes of this activity, the following items have been created:

  • On the Template Items (IN203000) form, the JUICE template item
  • On the Stock Items (IN202500) form, the PCH-32OZ-GBT stock item, which is a matrix item generated from the JUICE template

Process Overview

In this activity, you will do the following:

  1. On the Template Items (IN203000) form, add an image for the template item.
  2. On the Stock Items (IN202500) form, add an image for the stock item (which is a matrix item generated from the JUICE template).
  3. On the Prepare Data (BC501000) form, prepare the template item data for synchronization; on the Process Data (BC501500) form, process the template item data.
  4. In the control panel of the BigCommerce store, review the exported images.
  5. On the BigCommerce Stores (BC201000) form, activate the Product Image entity.
  6. On the Prepare Data (BC501000) form, prepare the product image data for synchronization; on the Process Data (BC501500) form, process the product image data.
  7. In the admin area of the BigCommerce store, review the exported images.

System Preparation

Before you complete the instructions in this activity, do the following:

  1. Make sure that the following prerequisites have been met:
  2. Download the following files to your local computer:
    • http://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice1.png
    • http://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice2.png
  3. Launch the MYOB Advanced website with the U100 dataset preloaded, and sign in with the following credentials:
    • Username: gibbs
    • Password: 123
  4. On the Enable/Disable Features (CS100000) form, make sure that the Matrix Items feature is enabled as follows:
    1. On the form toolbar, click Modify, and select the Matrix Items check box under Inventory and Order Management.
    2. On the form toolbar, click Enable.

Step 1: Adding an Image to the Template Item

To add an image to the JUICE template item, do the following:

  1. Open the Template Items (IN203000) form.
  2. In the Inventory ID box of the Summary area, select Juice.
  3. 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.

  4. On the eCommerce tab, in the Media URLs table, add a row with the settings shown in the following table.
    URL Type
    https://acumatica-builds.s3.amazonaws.com/builds/University/CommerceTraining/Juice3.png Image
  5. 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:

  1. Open the Stock Items (IN202500) form.
  2. In the Inventory ID box of the Summary area, select PCH-32OZ-GBT.
  3. On the Attributes 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.

  4. 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:

  1. Open the Prepare Data (BC501000) form.
  2. In the Store box, select SweetStore - BC.
  3. In the Prepare Mode box, leave Incremental.

    Incremental indicates that only the records that have been modified since the last successful data preparation will be prepared.

  4. In the table, select the Selected check box in the row of the Template Item entity.
  5. On the form toolbar, click Prepare.
  6. In the Processing dialog box, which opens, click Close to close the dialog box.
  7. In the row of the Template Item entity, click the link in the Ready to Process column.
  8. On the Process Data (BC501500) form, which opens with the SweetStore - BC 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).
  9. On the form toolbar, click Process.
  10. 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 BigCommerce store for the Juice template item, do the following:

  1. Sign in to the control panel of the BigCommerce store as the store administrator.
  2. In the left menu, click Products > View.
  3. On the View Products page, which opens, locate the Juice product, and click the link in the Product Name column.

    On the product management page of the Juice product, which opens, notice that the Images & Videos section contains only one image; you added this image 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

To activate the Product Image entity, do the following:

  1. Open the BigCommerce Stores (BC201000) form.
  2. In the Store Name box of the Summary area, select SweetStore - BC.
  3. On the Entity Settings tab, select the Active check box in the row of the Product Image entity.
  4. 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:

  1. Open the Prepare Data (BC501000) form.
  2. In the Summary area, specify the following settings:
    • Store: SweetStore - BC
    • Prepare Mode: Incremental
  3. In the table, select the Selected check box in the row of the Product Image entity.
  4. On the form toolbar, click Prepare.
  5. In the Processing dialog box, which opens, click Close to close the dialog box.
  6. In the row of the Product Image entity, click the link in the Ready to Process column.
  7. On the toolbar of the Process Data (BC501500) form, which opens with the SweetStore - BC store and the Product Image entity selected, click Process All.
  8. 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 BigCommerce store for the Juice template item and the matrix item, do the following:

  1. While you are signed in to the control panel of the BigCommerce store, in the left menu, click Products > View.
  2. On the View Products page, which opens, locate the Juice product, and click the link in the Product Name column.

    On the product management page of the Juice product, which opens, notice that two more images have been added. The image you attached to the JUICE template item was added to the Images & Videos section, and the image you attached to the PCH-32OZ-GBT stock item was added to the Image column of the Variants table of the Variations section.