Behavioral Changes for Promoted Actions

APPLIES TO: Business Central 2022 release wave 2 and later

With Business Central 2022 release wave 2, we introduce a new syntax for defining promoted actions. The new syntax groups the promoted actions in a separate section, so that the code is easier to scan. And on the UI, the new syntax improves the personalization experience, by adding options for promoting actions.

Behavioral changes

New Behavior (v21)	Previous Behavior (v20)
During personalization, if you hide a base action, all actionrefs will also be hidden.	During personalization, if you clicked "Remove" on a base action, it would disappear, which was equivalent to making the action set to PromotedOnly = true; it would only show up in the promoted section.
If base actions are inside a hidden group, then the actionrefs will be also hidden, even if the base actions themselves are visible.	Promoted actions had an implicit copy of the Visible property of the base actions, which made them unrelated to the parents of the base actions. Due to this behavior, this was not an issue in v20. Note: This behavior is maintained when the feature flag Modern Action Bar on the Feature Management page is set to Disabled.
Promoted categories are never merged into the Manage system group anymore. However, if there's a custom group called Manage, the merge is done.	If you renamed one of the promoted categories to Manage, then they were merged into the Manage system group. If there are multiple promoted categories that are renamed to Manage, then actions inside were all merged into the Manage system group. This could, for example, happen if there were multiple extensions that renames different promoted categories to Manage.
When all actions inside a group has an actionref, then the group is no longer rendered. This condition is applied recursively. For example, if every action is promoted, then there'll be no Actions group visible on the right-hand side. Note: In a future release actionrefs will be treated by PromotedOnly by default in the future.	Promoted actions were rendered on the right-hand side unless PromotedOnly was set. If every action had PromotedOnly = true, then the Actions group would also not render.
If a hidden group contains actions with dynamic visibility and the visibility evaluates to true without the parent, then the actions will be ghosted during design mode even if the visibility has never been modified.	Actions with dynamic visibility were initially visible. Then, if the parent was hidden and because their visibility was never modified, they would disappear from the page.

See also

Promoted Actions
Actions in AL
Adding Actions to a Page
Actions in the User Interface
How to Promote Actions
Organizing Promoted Actions
Common Promoted Action Groups
Action Bar Improvements