New Functionality In Microsoft Dynamics 365 Business Central 2023 Wave 1: Provide Title And Custom Actions To Error Dialogs

This post is part of the New Functionality In Microsoft Dynamics 365 Business Central 2023 Wave 1 series in which I am taking a look at the new functionality introduced in Microsoft Dynamics 365 Business Central 2023 Wave 1.

The fifth of the new functionality in the Development section is Provide Title And Custom Actions To Error Dialogs.

To help users get unblocked from issues when working with Business Central, Microsoft have introduced the capability to allow developers to unblock users when they encounter issues right away by choosing a corrective action. Making error messages more user-friendly helps build trust in Business Central while at the same time saving time in correcting common issues.

Enabled for: Users, automatically
Public Preview: Mar 2023
General Availability: Apr 2023

Feature Details

Developers can now set the Title property on Error dialogs that are presented to the user to enrich issue description. On top of that, using the ErrorInfo object, developers can add up to three custom actions that will be displayed on the Error dialog to provide users with corrective actions. This can be achieved by calling the AddAction method on the ErrorInfo object, which can be passed to AL methods that support ErrorInfo such as Error, TestField, FieldError, and others.

The AddAction method accepts three parameters:

• Caption: The text string that appears as the caption of the action in the error UI.
• CodeunitID: The ID of the Codeunit to run when the action is initiated from the error UI. The codeunit should contain at least one global method to be called by the error action. The global method must have an ErrorInfo data type parameter for accepting the ErrorInfo object.
• Method Name: The name of the method in the Codeunit, which is specified by the CodeunitID parameter, that you want to run for the action.