AX Specific

Product Images

Applies to: Sana Commerce 9.1.3 + Sana 9.1.1 package for AX (and higher)

    You can equally use the procedure which Sana provides out-of-the-box and Microsoft Dynamics AX to add product images.

To add an image to a product in Microsoft Dynamics AX:

Step 1: Click: Organization administration > Setup > Document management > Document types.

In the Document types window you can create a document type for images and specify the location where the images will be saved.

The following locations are available:

• Archive directory - Images are stored in the directory specified in the Archive directory field.
• Database - Images are stored in the Microsoft Dynamics AX database.
• Original location - Images are stored in the location that was used when the file was originally attached to the record.

For more information see, 'Configure document management'.

Step 2: Click: Organization administration > Setup > Document management > Document management parameters.

Under the General tab set up document handling.

The table below provides description of the fields:

Step 3: In Microsoft Dynamics AX click: Product information management > Common > Products > Released products. Select the necessary product and under the Product tab click Product image.

To add an image to a product click New. In the Type field select the type of attachment that you created for product images and upload the image. If you add several images to the product select the default one that should be shown on the product details page in the Sana webshop.

To make a product image visible in the webshop select the Visible in webshop checkbox under the General tab.

Just in the same way you can add images to the product variants. When a customer selects a product variant from the dropdown list on the product details page the corresponding product image is shown.

Step 4: When images are added to the products in Microsoft Dynamics AX, run the Product import task in Sana Admin. Open Sana Admin and click: Tools > Scheduled tasks.

The Product import task retrieves product information from the database to build or update the webshop index.

Step 5: When the Product import task is completed start the Product image import task.

Before running the task make sure that it is configured. Click Edit on the Product image import task and enable the setting Import product images from ERP. In the Separator field enter the symbol that will be used to separate product image information in the product image filename, like item number, product variant code and order number.

For more information about product image import task, see 'Scheduled tasks'.

The Product image import task will retrieve all product images from Microsoft Dynamics AX, rename them according to the image file name format supported by the Sana webshop, and save all images to the 'ProductImages' directory of the Sana Commerce solution on the Web server.

Then the Product image import task will automatically resize all product images from the 'ProductImages' folder and put them according to the size to the 'Small', 'Medium' and 'Large' folders. This is done because product images of three different sizes are used in the Sana webshop.

For more information about product image import task and image sizes, see 'Product Images'.

When the Product image import task is completed, product images from Microsoft Dynamics AX will be shown in the Sana webshop.