Retrieve Product Variant Attachments from inRiver


In some cases product attachments cannot be retrieved directly from inRiver, for example due to the inRiver API or network limitations. Nevertheless, there is a possibility to retrieve product attachments using an external file storage. For more information, see "Retrieve Files from External File Storage".

Product attachments in Sana are files and links added to the product or a product variant and they are shown on the product details page in the Sana web store.

For example, you are selling electronics or some complex equipment used in mechanical engineering, and you need to provide some manuals to your customers online. These documents can be attached to the products or product variants and shown on the product details page in the Sana web store.

In Sana, any file can be a product variant attachment. In inRiver an item-to-resource relation can be considered as the Sana product variant attachment. You need to create item-to-resource relations in inRiver and then define which of these relations will be considered as Sana product variant attachments.

Step 1: To find the necessary relation in inRiver, open the inRiver Item Model. On the right side of the page you will see 2 sections: Included in and Includes. You need to click on Includes to see the list of relations, because the item-to-resource relation is the parent-to-child relation.

Step 2: You can create a new relation or use the already existing relations. If you create a new relation, the target entity type of this relation must be Resource. Since the resource entity type links to the Item Model in inRiver, such relation is considered as item-to-resource in inRiver and is used for the Sana product variant attachments.

On the screenshot below you can see several link types with the Resource target entity type. You need the Link Type Id of the relations you are going to use. Link type Ids are necessary to create a server setting. You can use one or several relations to create a server string.

For example, you want to transfer the Product Variant Attachment relation to Sana. Then you need the Link Type Id of this relation, which is: VariantAttachment.

Step 3: Create the server setting for the item-to-resource relations. Go to the Settings in the inRiver Control Center and create the SANA_VARIANTATTACHMENTS_RELATIONS server setting. In the value of this server setting enter the Link Type Id.

The server setting should look in the following way: the key is SANA_VARIANTATTACHMENTS_RELATIONS and the value is VariantAttachment.

Step 4: When the server setting is created, you need to rebuild the product index. Open Sana Admin and click: Tools > Scheduled tasks. Run Rebuild index for the Product import task. Then, refresh the site cache.

If attachments are added to the product variants in the inRiver Enrichment Portal, then after product index is rebuilt, product variant attachments from inRiver will be available in the Sana web store.