Business Portals Job Queue

In the Business Portals module, task queues are used to automatically execute recurring or time-controlled processes in the background. This keeps the application efficient and reliable while important tasks such as notifications, archiving, or user management are handled efficiently.

Task Queue	Purpose	Notes / Recommendations	Executing Object	Parameter String
Business Portals-User Expired	If an expiration date has been set for a web user, the task queue takes over the automatic deactivation. There is neither deletion nor a deletion notification. The user is deactivated but remains in the system.	Standard interval: every minute.	Codeunit 5492810	USER_EXPIRED
Business Portals - User Delete	If the user's last login is further back than defined in the module setup, the system adds a notification to the email queue (delayed or direct), sets a final deletion date, and moves the user to the deletion queue. Deletion occurs when the date is reached.	Standard interval: every minute.	Codeunit 5492810	USER_DELETE
Business Portals - Archive Completed Order	Archives completed orders after a configurable period defined in the module setup.	Standard interval: every minute. Only relevant if an archiving formula has been configured in the module setup.	Codeunit 5492810	ARCHIVE_COMPLETED_ORDER
Business Portals - Send Emails	Sends emails that are in the email queue.	Standard interval: every minute. Only relevant if delayed sending is active in the module setup.	Codeunit 5492810	SENT_EMAILS
Business Portals - Send App News	Responsible for sending news to the Business Portals app. Administrators can configure messages (e.g., "Merry Christmas") with date and time. The task queue checks the schedule and sends the message to all mobile users.	Standard interval: every minute. Only relevant if an app is used.	Codeunit 5492810	SEND_APP_NEWS
Business Portals - Send Calendar Notif	Sends calendar-related notifications to users of the Business Portals Mobile App. Based on user-specific appointments, it checks the schedule and sends reminders.	Standard interval: every minute. Only relevant if calendar-related notifications have been configured.	Codeunit 5492810	SEND_CALENDAR_NOTIF
Business Portals - Send App Ticket Notif	Sends app notifications about ticket events to users of Business Portals. Notifications are triggered as soon as the status, priority, or other relevant information of a ticket changes.	Standard interval: every minute. Only relevant if app notifications are used in the ticket system.	Codeunit 5492810	SEND_APP_TICKET_NOTIF
Business Portals - Clear Upload Buffer	Cleans up temporarily buffered ticket uploads. Attachments are temporarily stored and automatically removed after processing to save space and ensure system performance.	Standard interval: every minute. Only relevant if the ticket system is set up and used.	Codeunit 5492810	CLEAR_UPLOAD_BUFFER

Info

You can control when and how often queues are executed in Business Central. Execution intervals can be adjusted or individual queues can be deactivated as needed. This can prevent automatic processes from being executed during a maintenance window.

Additional Usage Notes

Adjusting Execution Intervals

Administrators can adjust the interval of each task queue (e.g., every minute, hourly) to performance requirements, maintenance windows, or system load.

Monitoring and Maintenance

Regularly check the status of the Business Portals queues on the Job Queue Entries page.
Analyze entries in the Error status before increasing the allowable error value.
In sandbox environments, you can deactivate unnecessary queues to avoid unnecessary processing.

Info

Check the task queues after an update. In some cases, it may be necessary to restart the task queues to ensure that all processes continue to run correctly and completely. Even if a restart is not always necessary, it is advisable to check the current status of the task queues.

Creating a New Task Queue Entry

Follow these steps to create a new task queue entry:

Start as Business Portals Administrator in the role center.
Open the Task Queue Entries via search or by scrolling down to the Job Queue Entries section.
Click on Job Queue Entries to open the drop-down menu.
Click on New.
The Task Queue Entry Card, where you can make individual configurations, will open.

Various configuration options are available. You can choose whether to use a report or a codeunit as the executing object. Additionally, execution parameters as well as options for report formats and repetitions can be set. The configuration allows tasks to be executed automatically via the task queue to make processes efficient.

Setting Up Business Portals Task Queue Entries

Task queues can be individually configured to meet your system requirements, such as setting the start time, end time, and the interval in minutes between executions.

Follow these steps to configure a specific task queue entry:

Start as Business Portals Administrator in the role center.
Open the Task Queue Entries via search or by scrolling down to the Job Queue Entries section.
Click on the three dots and select Edit or View to open the task queue entry card.
To edit the task queue entry, first set it to On Hold.
In the Repetition section, you can:
Configure a Start and End Time for when the task queue should begin and end processing the shipping entries.
Configure the Number of Minutes Between Executions to set the interval at which the task queue is executed.

Creating Standard Business Portals Task Queue Entries

It is possible to create standard task queue entries for Business Portals. These queues define how shipping tasks are automatically processed in the background to ensure efficient and reliable handling.

Follow these steps to create standard task queue entries:

Start as Business Portals Administrator in the role center.
Navigate to the Job Queue Entries section by scrolling down.
Click on Job Queue Entries and select the action Create Standard Entries.