New Features for Dynamics 365 Business Central 2021 release wave 1 (BC18): In-app contextual help improvements (AboutTitle Property and AboutText Property)

Dynamics 365 Business Central

Hi, Readers.
Last week, the preview environment for Dynamics 365 Business Central 2021 release wave 1 (BC18) is available. Learn more:

I will continue to test and share some new features that I hope will help.

In-app contextual help improvements:

Business value:

Get up and running with Dynamics 365 Business Central faster.

Feature details:

Customers want to get up and running with Dynamics 365 Business Central easier and faster. New visual aids help call out features and key business process fields and actions in Dynamics 365 Business Central, allowing the customer to self-learn and get educated on how to start using the product. These visual aids can be authored by partners who wish to bring them onto their app offerings.

There are two new properties in pages and controls: AboutTitle Property and AboutText Property. You can set it on the page, groups, parts, fields, and actions.

(property) AboutTitle: String
Sets the title of the entity used in the About box for synopsis and callouts in the UI.

(property) AboutText: String
Sets the text of the entity used in the About box for synopsis and callouts in the UI

In BaseAppication of W1 18.0 (Platform 18.0.22913.0 + Application 18.0.22967.0), there are not many pages that use this property yet.

For easy understanding, let’s see an example. (page 143 “Posted Sales Invoices”)

When users open the Posted Sales Invoices page for the first time, they will see the following new tour message.

This is set on the page.

AboutTitle = 'About posted sales invoices';
AboutText = 'When sales invoices are posted, they appear here where you can follow the remaining amounts to be paid by your customers.';

PS: If you missed it, you can reopen it by clicking on the page name in the upper right corner.

If you choose Take tour, you can see the all information set on the page control.

Set on the field.

AboutTitle = 'The final invoice number (No.)';
AboutText = 'This is the invoice number uniquely identifying each posted sale. Your customers see this number on the invoices they receive from you.';

Set on the field.

AboutTitle = 'What remains to be paid';
AboutText = 'This column shows you what is not yet paid on each invoice. When full payment is registered, an invoice is marked as Closed.';

Set on the action.

AboutTitle = 'Your profit from a sale';
AboutText = 'Go here to see statistics about the selected invoice, your profit, and associated taxes.';


OK, let’s do some more tests.

1. We can use PageExtension to update the standard contents.

2. We can easily add tour to our own customized new pages.

3. The tour contents in the same page order as they are declared in the code (Top to bottom)

Other Information from Søren Alexandersen.

Update 2021/04/15: Information from Dynamics 365 Business Central Launch Event 2021 release wave 1


Hope this will help.

Thanks for reading.