Configure the Routing service

Follow the steps below to configure the Routing service.

  1. Install Sitecore.Commerce.RoutingFramework.

    • Using the Sitecore.Commerce.RoutingFramework update package (Sitecore.Commerce.RoutingFramework.8.*.*.*.update) that you previously downloaded.

    • Navigate to http://<your site>/sitecore/admin/UpdateInstallationWizard.aspx, and then follow the steps in the wizard.

  2. Install Sitecore.Commerce.DynamicsIntegration.Routing.

    • Using the Sitecore.Commerce.DynamicsIntegration.Routing update package (Sitecore.Commerce.DynamicsIntegration.Routing.8.*.*.*.update) you downloaded previously.

    • Navigate to http://<your site>/sitecore/admin/UpdateInstallationWizard.aspx, and then follow the steps in the wizard.

  3. Add the following into the web.config under /configuration/runtime/assemblyBinding/:

    <dependentAssembly name="System.Web.Razor" xmlns="urn:schemas-microsoft-com:asm.v1">
       <assemblyIdentity name="System.Web.Razor" publicKeyToken="31bf3856ad364e35" culture="neutral"/> 
       <bindingRedirect oldVersion="0.0.0.0-3.0.0.0" newVersion="3.0.0.0"/>
</dependentAssembly>

  4. Open Content Editor and edit the following items. Be sure to save all changes.

  5. Open /sitecore/Commerce/Commerce Synchronization/Commerce Endpoints/Endpoint_SitecoreWebApi_Configuration_Dev

    1. Ensure the username and password is specified.

    2. Ensure host name is set to that of the current Sitecore instance. If the Sitecore instance is different than the Commerce Server Catalog, then set the host name to the Sitecore instance server.

  6. Open /sitecore/Commerce/Commerce Synchronization/Commerce Routes/Route Requests/Contoso Commerce Route Request

    1. Ensure the enabled check box is checked.

    2. Ensure the approved check box is checked.

    3. Clear last run and requested at fields.

  7. Open /sitecore/Commerce/Dynamics Routing Extensions/Commerce Endpoints/Azure Contoso Commerce Endpoint - Dynamics Retail Crt

    1. Ensure the sync token is cleared.

    2. Ensure the database server is specified. The value should be the Dynamics AX instance URL, which needs to be accessible from where the routing console application is running.

    3. Ensure the database is specified. For example, the Dynamics AX Contoso Retail Store channel database name is retailcontosostore.

    4. If Integrated Windows Authentication is used, ensure “Trusted Connection” is checked.

    5. Ensure the port is specified. For example, the Dynamics AX channel database port, 57500.

    6. Ensure the username and password are specified. These are needed only if the SQL authentication is being used to access Dynamics AX channel database.

  8. Open /sitecore/Commerce/Dynamics Routing Extensions/Commerce Endpoints/Endpoint_FileSystem_Contoso_Dev_Archive

    • Ensure the path where the XML file is saved is valid. This is the location where previously generated Commerce Server xml files are moved to.

  9. Open /sitecore/Commerce/Dynamics Routing Extensions/Commerce Endpoints/Endpoint_FileSystem_Contoso_Dev_Working

    • Ensure the path where the XML file is saved is valid. This is the location where the generated Commerce Server xml file is placed.

  10. Open /sitecore/Commerce/Commerce Synchronization/Commerce Endpoints/Endpoint_SitecoreCommerceAgent_Sample

    • Ensure the “Commerce Site” field value matches the name of the Commerce Server site that you want catalog data to be pushed to.

  11. The actions that are performed during import can be found at /sitecore/Commerce/Commerce Synchronization/Commerce Routes/Route_SyncSitecoreCommerceChannel. By default, all of the steps at this path are enabled, but if you want to temporarily disable a step, you can do so here and then enable it again later. For example, if you do not want to map images for all products, then disable that step. Clear the "Enabled" check box for /sitecore/Commerce/Dynamics Routing Extensions/Dynamics Routes/Route_SyncSitecoreCommerceChannel_Contoso_AzureAxVm/Step_PublishExtract

  12. The execute of the import is controlled by a Sitecore task that can be found at /sitecore/system/Tasks/Schedules/Commerce Synchronization Schedule/. If you want to change the schedule this template runs by, you can do so here.