BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Initialize commerce scheduler

A dialog page that creates or refreshes the base Commerce Data Exchange configuration data (scheduler jobs, subjobs, channel schema and distribution schedules), with an option to delete the existing configuration first.

Business process
Manage sales channels
Menu item
RetailCDXInitializeMenuItem
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA dialog page that creates or refreshes the base Commerce Data Exchange configuration data (scheduler jobs, subjobs, channel schema and distribution schedules), with an option to delete the existing configuration first.
What you do hereUse this page after every service update, after enabling a Commerce feature that affects a configuration key, or after deploying a CDX extension, so that configuration data for new tables and columns is set correctly.
ExampleFor example, after an extension registers a custom job in a resource file, running this initialization creates the custom job and subjobs in CDX automatically.
Initialize commerce scheduler 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 › Commerce scheduler › Initialize commerce scheduler
Set up firstCommerce parameters (Initialize) Microsoft Learn
Used next byChannel database (Full data sync) Microsoft Learn Scheduler subjobs Microsoft Learn
Related pagesFeature management Microsoft Learn
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 Initialize commerce scheduler

Use this page after every service update, after enabling a Commerce feature that affects a configuration key, or after deploying a CDX extension, so that configuration data for new tables and columns is set correctly.

Steps from Microsoft

  1. Go to Retail and Commerce > Headquarters setup > Commerce scheduler > Initialize commerce scheduler.
  2. Leave Delete existing configuration set to No unless you have been told to delete it or are in a non-production environment.
  3. Select OK.
  4. Confirm the prompt to initialize the base configuration data.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Delete existing configurationWhen Yes, the current scheduler configuration is removed before the defaults are recreated; normally left at No.Microsoft Learn

Test checklist

  1. After a service update in a sandbox, open Initialize commerce scheduler, leave Delete existing configuration at No and select OK.
  2. Check on Scheduler jobs and Distribution schedule that the standard jobs exist.
  3. Run a full data sync for a channel database and check download sessions reach Applied.
  4. Check that any custom jobs and subjobs are still present.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Initialize commerce schedulerRun after every service update and after enabling a Commerce feature that affects a configuration key, with Delete existing configuration = NoRunning it after every update sets the configuration data for new tables and columns correctly. Microsoft says to leave Delete existing configuration at No unless explicitly instructed, or on a non-production environment where losing the configuration has no impact.Setting Delete existing configuration to Yes in production. The existing scheduler configuration is deleted.

Feature management and licence

Feature to turn onRun "Initialize commerce scheduler" after Headquarters is updated (Optional)

Microsoft Learn

Solution architect

5Design impact

Can it be undoneOne-way: Warning: with Delete existing configuration = Yes, the current Commerce scheduler configuration is deleted when you select OK. With No, initialization only refreshes base configuration data and can be rerun. Microsoft Learn
If you change it laterRunning it with Delete existing configuration set to Yes wipes the current scheduler configuration; Microsoft reserves that for sandbox troubleshooting or when explicitly instructed. Microsoft Learn
Technical architect

6Technical

Menu itemRetailCDXInitializeMenuItem Checked in Dynamics 365
FormRetailCDXInitializeDialog Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceRetail operations manager RetailOperationsManagerRetail store manager RetailStoreManagerRetail store IT RetailStoreITGive people one of these roles. On this system, 4 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailCDXInitializeMenuItem
Everyone

8Sources