Get in-product notifications about issues with job queue background processing

  • Article

Important

Some of the functionality described in this release plan has not been released. Delivery timelines may change and projected functionality may not be released (see Microsoft policy). Learn more: What's new and planned

Enabled for Public preview General availability
Users by admins, makers, or analysts - Oct 2024

Business value

Sometimes tasks, reports, or batch processes can take a long time to complete. To keep people productive in the meantime, companies often use Business Central's ability to run processes in the background. If something goes wrong and an important background process stops, or isn't scheduled for some reason, being notified in product of the issue can help you react quickly to resolve it.

Feature details

To be notified when there are issues with job queue processing, you can run the Set up Job Queue Notifications assisted setup guide from the Assisted Setup page.

Shows new Set up Job Queue Notifications assisted setup guide.

Choose Next on the first step of the Set up Job Queue Notifications guide to set up the users to notify about issues with job queue entries. You can choose whether to notify the user who started the job queue entry by turning on the Notify the user who initiates background task toggle. You can also choose to notify job queue notification administrators by turning on the Job Queue Administrators toggle and choosing users in the list.

Shows step where users can define who to notify when job queues have an issue

Choose Next on the second step to specify how to send notifications. You can choose whether to use in-product notifications on home pages by turning on the In-product notifications toggle.

Shows a step where users can choose how notifications will be sent.

Note

You can also use external Business Events to control notifications using, for example, Power Automate, when virtual tables and events are enabled in your Dataverse connection setup. Because the external Business Events feature is still in preview, a separate release plan explains how to set up and use this feature. This release plan focuses only on in-product notifications of issues with job queue entries.

Choose Next on the third step of the Set up Job Queue Notifications guide to specify when to send notifications if a job queue entry has an issue. You can choose to notify users immediately with in-product notifications on their home pages by turning on the Immediately, per job queue toggle or, to reduce the noise, you can choose to notify users when failure thresholds are exceeded by turning on the After a threshold is reached toggle. Use the Threshold 1 and Threshold 2 fields to define how many times a job queue entry must fail before notifying a user.

Shows step where users can define when to notify them of job queue issues.

Choose Next on the fourth step to complete the guide and Finish to apply the notification settings.

After the guide completes, if you chose Notify the user who initiates background task, the notification is enabled for all users on the My notifications page. If a user doesn't want to receive these notifications, they can turn off Job Queue Failed Notification on the page.

Job Queue Failed Notification in My notifications page

In-product notifications also let you perform actions. You can turn off the notification by choosing Don't show this again. You can also choose Restart failed job to try to start the job queue entry again, or view more details about the issue by choosing Show more details. Choosing Show more details opens the job queue entry's Job Queue Log Entries page, which contains the error message that caused the job queue entry to fail.

Show job queue issue notification in users role center together with Job Queue cues.

User home pages contain three new cues that inform them of the current state of the job queue entries they started:

  • Tasks Failed shows the number of job queue entries that failed.
  • Tasks In Process shows the number of job queue entries that are in progress.
  • Tasks in Queue shows the number of job queue entries that are waiting to start.

Each user can further set up the visual appearance of these cues by choosing the Set up cues action in the Job Queue Tasks part of the home page. The Set up Job Queue Notifications guide only sets Tasks failed thresholds.

Note

The users listed as job queue notification administrators can view the job queue entry failures for all users.

Tell us what you think

Help us improve Dynamics 365 Business Central by discussing ideas, providing suggestions, and giving feedback. Use the forum at https://aka.ms/bcideas.