Coding, Day to Day

Business Central – How to use PromotedActionCategories

Our intern was asking me for help on using PromotedActionCategories. She tried and she was not about to make it work. She said that no matter what captions she had placed, it just showed up as “Category 9” instead of “Request Approval”. This was how she had done it.

page 50210 "Vendor Contract"
{
    Caption = 'Vendor Contract';
    PageType = Card;
    PromotedActionCategories = 'Release, Request Approval';

...

                action(CancelApprovalRequest)
                {
                    ApplicationArea = Suite;
                    Caption = 'Cancel Approval Re&quest';
                    Image = CancelApprovalRequest;
                    Promoted = true;
                    PromotedCategory = Category9;
                    ToolTip = 'Cancel the approval request.';

...

Then this was how it was resolved.

page 50210 "Vendor Contract"
{
    Caption = 'Vendor Contract';
    PageType = Card;
    PromotedActionCategories = 'New,Process,Report,Release,Request Approval';

...
                action(CancelApprovalRequest)
                {
                    ApplicationArea = Suite;
                    Caption = 'Cancel Approval Re&quest';
                    Image = CancelApprovalRequest;
                    Promoted = true;
                    PromotedCategory = Category5;
                    ToolTip = 'Cancel the approval request.';
...

As you can see from the above example, “Category4” caption has been renamed as “Release” and “Category5” caption has been renamed as “Request Approval”.

For a clearer idea on how this was resolved, you may refer to the microsoft documentation here.