Version: Available from runtime version 1.0.
Specifies whether a page action is added to a promoted category in the action bar.
Important
The Promoted property is part of the legacy syntax for promoted actions. We recommend that you use the actionref syntax introduced in Business Central 2022 release wave 2. Learn more in Promoted actions.
Note
Removing the Promoted property from a published action is a breaking change. Learn more in AppSourceCop error AS0031.
The Promoted property also applies to profiles. Learn more in Promoted property for profiles.
Applies to
- Page actions
Property value
Set the property to true to promote the action. Otherwise, set it to false. The default is false.
Example
The following example uses the legacy syntax to promote an action to the Process category.
action(MyAction)
{
Caption = 'Process order';
ApplicationArea = All;
Promoted = true;
PromotedCategory = Process;
trigger OnAction()
begin
Message('The order was processed.');
end;
}
Remarks
Use the PromotedCategory property to specify where the promoted action appears. The Promoted property has an effect on actions on Card, Document, List, ListPlus, and Worksheet pages. It has no effect on actions in cue groups.
For information about using Promoted with Scope, see Scope property for page actions.
Related information
PromotedIsBig property
PromotedOnly property
Promoted property for profiles
Actions overview