BeyondERP.Newsletter
Menu

Setup step on the Commerce shared parameters page · Retail and Commerce

Set up Commerce shared parameters

Use this page to register the identity providers and relying parties that may call Retail Server, set security settings such as the Real-time Service profile and password algorithms, enable Azure Maps, and enter configuration keys that switch optional CDX and notification behaviour on or off.

Used by
Retail operations manager, Retail store IT, Retail store manager
Business process
Manage sales channels
Menu item
RetailSharedParameters
Main table
RetailSharedParameters
Data entity
RetailSharedParameterEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page holding Commerce settings that are shared across all legal entities, with tabs such as Identity providers, Security, Azure Maps and Configuration parameters where feature keys and their values are entered.
What you do hereUse this page to register the identity providers and relying parties that may call Retail Server, set security settings such as the Real-time Service profile and password algorithms, enable Azure Maps, and enter configuration keys that switch optional CDX and notification behaviour on or off.
ExampleFor example, to delay the creation of download sessions until a device is activated you add the key CDX_ENABLE_DELAYED_OFFLINE_DOWNLOAD_SESSION_CREATION with the value 1 under Configuration parameters.
Commerce shared parameters page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processDevelop sales policies › Manage sales channels
Menu pathRetail and Commerce › Headquarters setup › Parameters › Commerce shared parameters
Used next byDistribution schedule (job 1110 Global configuration) Microsoft Learn
Related pagesConnector for Microsoft Dynamics AX Microsoft Learn Microsoft Entra applications Microsoft Learn Clean up email notification logs Microsoft Learn
In this process Set up Loyalty schemes · Set up Payment methods
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Commerce shared parameters

Use this page to register the identity providers and relying parties that may call Retail Server, set security settings such as the Real-time Service profile and password algorithms, enable Azure Maps, and enter configuration keys that switch optional CDX and notification behaviour on or off.

Steps from Microsoft

  1. Go to Retail and Commerce > Headquarters setup > Parameters > Commerce shared parameters.
  2. On the left pane, select Configuration parameters.
  3. Enter the key in the Name field.
  4. Enter the setting in the Value field.
  5. Select Save, then run distribution schedule job 1110 so the channel database receives the change.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Name (Configuration parameters)The configuration key being set.Microsoft Learn
Value (Configuration parameters)The value for that key, for example 0 or 1.Microsoft Learn
Issuer Value (Identity providers)The token issuer URL of an identity provider trusted by Retail Server.Microsoft Learn
Relying partiesClient IDs of applications allowed to call Retail Server, with their Type and UserType.Microsoft Learn
Real-time Service profile (Security)The Connector for Microsoft Dynamics AX profile used for AX 2012 R3 channels.Microsoft Learn
TS password encryption name (Security)Algorithm used to connect to the transaction service; set to SHA256.Microsoft Learn
Enable Azure MapsTurns Azure Maps on for DOM, the e-commerce store locator and the Store Commerce app.Microsoft Learn Enabled
Azure Maps KeyYour own Azure Maps license key.Microsoft Learn

Test checklist

  1. Under Configuration parameters, check CDX_ENABLE_ROLLBACK_ON_FAILURE has Value 0.
  2. On Identity providers, check the relying party entry has the right client ID and the Server resource IDs entry matches the Retail Server.
  3. Run job 1110 and activate a POS device to confirm sign-in works.
  4. If Azure Maps is used, check Enable Azure Maps = Yes with a valid key.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Commerce shared parametersIn Configuration parameters set CDX_ENABLE_ROLLBACK_ON_FAILURE = 0, and add CDX_ENABLE_UPDATE_STATISTICS_FOR_REQUIRED_TABLE = 1 when Optimize database statistics automatically is usedLearn says not to use the roll back on failure key because of a known issue and to change it from its default 1 to 0, and to add the statistics flag when statistics optimisation is on.Changing identity providers, relying parties or server resource IDs and not running job 1110, so channels keep the old settings.

Number sequences

ReferenceShared or per companyNote
Customer hierarchy IDSharedBEAT uses number sequence Cust_1. Checked in Dynamics 365
Store numberSharedBEAT uses number sequence Comm_80. Checked in Dynamics 365
Register numberSharedBEAT uses number sequence Comm_81. Checked in Dynamics 365
Discount codeSharedBEAT uses number sequence Comm_82. Checked in Dynamics 365
Assortment IDSharedBEAT uses number sequence Comm_83. Checked in Dynamics 365
ConfigurationSharedBEAT uses number sequence Comm_84. Checked in Dynamics 365
Card numberSharedBEAT uses number sequence Comm_85. Checked in Dynamics 365
Kit assembly order nameSharedBEAT uses number sequence Comm_86. Checked in Dynamics 365
Loyalty adjustment IDSharedBEAT uses number sequence Comm_87. Checked in Dynamics 365
Retail Channel IdSharedBEAT uses number sequence ATLAS-CHN. Checked in Dynamics 365
Catalog numberSharedBEAT uses number sequence Comm_88. Checked in Dynamics 365
Device IDSharedBEAT uses number sequence Comm_89. Checked in Dynamics 365
Fiscal technical profile numberSharedBEAT uses number sequence Comm_90. Checked in Dynamics 365
Registration process numberSharedBEAT uses number sequence Comm_91. Checked in Dynamics 365
Fiscal connector group numberSharedBEAT uses number sequence Comm_92. Checked in Dynamics 365
Other loyalty activity type IDSharedBEAT uses number sequence Comm_93. Checked in Dynamics 365
Loyalty non-transaction IDSharedBEAT uses number sequence Comm_94. Checked in Dynamics 365
SafesSharedBEAT uses number sequence Comm_95. Checked in Dynamics 365
Retail document operation identifierSharedBEAT uses number sequence Comm_96. Checked in Dynamics 365
Number sequence for validation IdSharedBEAT uses number sequence Comm_97. Checked in Dynamics 365
Solution architect

5Design impact

Can it be undoneReversible: Values can be changed; channel-side settings change after job 1110 runs.
If you change it laterSwitching off Azure Maps here makes the feature unavailable across Commerce, and changes on this page only reach channels after job 1110 is run. Microsoft Learn
Technical architect

6Technical

Menu itemRetailSharedParameters Checked in Dynamics 365
FormRetailSharedParameters Checked in Dynamics 365
TableRetailSharedParametersShown as “COMMERCE SHARED PARAMETERS” in Record infoChecked in Dynamics 365
Data entitiesRetailSharedParameterEntityCommerce shared parameters Checked in Dynamics 365RetailSharedAzureMapsParameterEntityRetail shared Azure Maps parameters Checked in Dynamics 365RetailSharedBingParameterEntityRetail shared Bing Maps parameters Checked in Dynamics 365RetailSharedFacebookParameterEntityRetail shared Facebook application parameters Checked in Dynamics 365RetailSharedTwitterParameterEntityRetail shared Twitter application parameters Checked in Dynamics 365
Who can open itPrivilegesMaintain retail shared parameters RetailSharedParametersMaintainDutiesMaintain retail parameters RetailParametersMaintain
3 security rolesRetail operations manager RetailOperationsManagerRetail store IT RetailStoreITRetail store manager RetailStoreManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail operations manager RetailOperationsManagerRetail store manager RetailStoreManagerRetail store IT RetailStoreITGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailSharedParameters
Integrate withRetailSharedParameterEntity data entity Checked in Dynamics 365
Everyone

8Sources