Combine multiple UI actions with a split button

Important

This content is archived and is not being updated. For the latest documentation, go to What's new and planned for Dynamics 365 Business Central. For the latest release plans, go to Dynamics 365 and Microsoft Power Platform release plans.

Enabled for	Public preview	General availability
Admins, makers, marketers, or analysts, automatically	Sep 1, 2022	Oct 1, 2022

Business value

As part of the new programming model for promoted actions, you can now combine multiple actions into a split button to help organize the actions that you're promoting, thereby reducing clutter and improving coherence and closeness of related actions.

Feature details

A split button can be defined for a page action group, which renders as a combination of a button and a menu.

Use the ShowAs property on action groups to specify that a certain page action group should render as a split button.

The first action will be the split button action, and when using the dropdown menu, the order will be as defined in code (or rearranged by extensibility).

As a simple scenario, see below where two action references have been combined into a single split button:

page 50105 ActionRefPage
{
    actions
    {
        area(Promoted)
        {
            group(Group)
            {
                ShowAs = SplitButton;

                actionref(MySplitButtonPromotedActionRef; MyBaseAction)
                {
                }
                
                actionref(MyOtherSplitButtonPromotedActionRef; MyBaseAction)
                {
                }
            }
        }
       
			area(Processing)
        {
            action(MyBaseAction)
            {
                Visible = true;
                trigger OnAction()
                begin
                    Message('Hello world!');
                end;
            }
        }
    }
}

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.

See also

ShowAs Property (docs)