Modify Product definitions templates

Abstract

You can modify Product definition templates to suit your business needs.

There are four product definitions: CommerceProductMasterKit, CommerceProductMaster, CommerceProductKit, and CommerceProduct. They can be used for any channel.

Users can control the default channel by modifying the product definitions template, which is located at C:\inetpub\AXRefStorefront\Website\Templates\Render_DynamicsProductDefinitions.cshtml.. If you are running Synchronization from the SDK, also update the template in the SDK location.

  1. All properties that are not listed in a product definition will be exposed in the property bags in the following format: DynamicsProductProperties, DynamicsVariantProperties in the following format: name1=value1|name2=value2|. All values in property bags are XML encoded.

  2. To add a base property, which is a separate property that is outside of the property bag, the following lines must be added to a product definition:

    1. For a product property: <DefProperty axName="AXPropertyName">CSPropertyName</DefProperty>.

    2. For a variant property: <DefVariantProperty axName="AXPropertyName">CSPropertyName</DefVariantProperty>.

    You can omit the axName attribute if AXPropertyName and CSPropertyName are the same. The CS product property should match an Dynamics AX product master property, and the CS variant property should be defined in a product in Dynamics AX.

    Note

    • The Catalog import is case-sensitive, and properties will be ignored if the cases are different. The correct formats are DefProperty and DefVariantProperty.

    • Do not remove or rename existing properties. If you must rename a property, use axName.

    • If you have a previous catalog synchronized during a previous release, you must run a full synchronization during the first new synchronization. After that synchronization is completed, reset all caches, delete and update the data templates, and refresh the caches again before publishing and indexing the site.