BeyondERP.Newsletter
Menu

Workflow page · System administration

Workflow infrastructure configuration

A wizard that sets up how often the workflow batch jobs run.

Business process
Administer system features
Menu item
WorkflowSetupForm
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 wizard that sets up how often the workflow batch jobs run.
What you do hereUse this page to choose the batch group and run interval for the workflow message processing, due date processing and line-item notification batch jobs.
ExampleFor example, BEAT runs the wizard once, places the three workflow batch jobs in a dedicated batch group, and then marks Workflow message processing as a critical job on the Batch jobs page.
Workflow infrastructure configuration 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 processAdminister system features
Menu pathSystem administration › Workflow › Workflow infrastructure configuration
Set up firstBatch group Microsoft Learn Set up Batch group
Used next byBatch jobs Microsoft Learn
Related pagesWorkflow parameters 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 Workflow infrastructure configuration

Use this page to choose the batch group and run interval for the workflow message processing, due date processing and line-item notification batch jobs.

Steps from Microsoft

  1. Go to System administration > Workflow > Workflow infrastructure configuration.
  2. On the welcome page, select Next.
  3. For the workflow message processing batch job, select a batch group, and then select Next.
  4. For the workflow due date processing batch job, select a batch group and enter how many hours apart it runs.
  5. For the line-item workflow notifications batch job, select a batch group and enter how many minutes apart it runs.
  6. Select Finish to close the wizard.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Workflow message processingThe batch job that processes workflow messages; the most important workflow job.Microsoft Learn
Due date processing intervalHow many hours apart the due date job runs.Microsoft Learn
Line-item notifications intervalHow many minutes apart the line-item notification job runs.Microsoft Learn

Common errors and fixes

MessageWhat to do
Submitted documents stay pending and no work item reaches the approverOpen Batch jobs, find Workflow message processing and check it is Waiting or Executing, not Withhold or Error. Microsoft Learn

Test checklist

  1. Go to System administration > Inquiries > Batch jobs and filter on Workflow message processing.
  2. Check that the job exists, is in a runnable state and has Critical job selected.
  3. Submit a document to an active workflow and check that the work item reaches the assigned user within a few minutes.
  4. Review the job's batch history for errors.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Workflow infrastructure configurationKeep the Workflow message processing batch job running and mark it as a Critical jobSubmitted workflows are queued and run by the Workflow message processing batch job, which processes the queue at one-minute intervals. If workflow is key to your business, Learn advises marking this job critical so failures are tracked.Is Workflow message processing a critical job?Using the workflow batch jobs to fix a missing Submit button. Workflow message processing only moves documents that were already submitted; it doesn't decide whether a draft can be submitted.Test: The workflow job is critical and running

Feature management and licence

Licence or add-inOn this system the page opens for Information technology manager. No Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyShared: the workflow batch jobs serve every legal entity. Microsoft Learn
Can it be undoneReversible: The batch jobs that run workflow can be edited, rescheduled or marked critical at any time on the Batch jobs page. Microsoft Learn
If you change it laterIf Workflow message processing stops, no workflow moves. Marked as critical, its failures are tracked so support can act. Microsoft Learn
Technical architect

6Technical

Menu itemWorkflowSetupForm Checked in Dynamics 365
FormWorkflowSetupForm Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itInformation technology manager SysServerITManagerGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=WorkflowSetupForm
Data migrationLoad order: Workflow infrastructure configuration has no data entity in Data management, so it can't be loaded from a file or a configuration template. The wizard creates batch jobs; run it in each environment.Checked in Dynamics 365
Everyone

8Sources