PromotedCategory Property
Version: Available or changed with runtime version 1.0.
Sets a category for a promoted action.
Applies to
- Page Action
Property value
| Value | Available or changed with | Description |
|---|---|---|
| New | runtime version 1.0 | Actions will appear in the New menu. |
| Process | runtime version 1.0 | Actions will appear in the Process menu. |
| Report | runtime version 1.0 | Actions will appear in the Report menu. |
| Category4 | runtime version 1.0 | Actions will appear in the Category 4 menu. |
| Category5 | runtime version 1.0 | Actions will appear in the Category 5 menu. |
| Category6 | runtime version 1.0 | Actions will appear in the Category 6 menu. |
| Category7 | runtime version 1.0 | Actions will appear in the Category 7 menu. |
| Category8 | runtime version 1.0 | Actions will appear in the Category 8 menu. |
| Category9 | runtime version 1.0 | Actions will appear in the Category 9 menu. |
| Category10 | runtime version 1.0 | Actions will appear in the Category 10 menu. |
| Category11 | runtime version 1.0 | Actions will appear in the Category 11 menu. |
| Category12 | runtime version 1.0 | Actions will appear in the Category 12 menu. |
| Category13 | runtime version 1.0 | Actions will appear in the Category 13 menu. |
| Category14 | runtime version 1.0 | Actions will appear in the Category 14 menu. |
| Category15 | runtime version 1.0 | Actions will appear in the Category 15 menu. |
| Category16 | runtime version 1.0 | Actions will appear in the Category 16 menu. |
| Category17 | runtime version 1.0 | Actions will appear in the Category 17 menu. |
| Category18 | runtime version 1.0 | Actions will appear in the Category 18 menu. |
| Category19 | runtime version 1.0 | Actions will appear in the Category 19 menu. |
| Category20 | runtime version 1.0 | Actions will appear in the Category 20 menu. |
Example
The following code sample illustrates how to set the PromotedCategory property.
page 50110 PageName
{
PageType = Card;
actions
{
// Adds the action called "My Actions" to the Action menu
area(Processing)
{
action("My Actions")
{
Promoted = true;
PromotedCategory = Process;
ApplicationArea = All;
...
Remarks
Note
With Business Central 2022 release wave 2, the way that you promote actions on pages or page extensions has changed. Promoting actions is defined in a specific section of the page definition and contains a reference to the action. For more information, see Promoted Actions.
Promoted actions appear in the action bar on a page. You promote an action by setting the Promoted Property. Categories allow you to group similar actions under a common caption. You can choose between 10 categories: New, Process, Report, and Category4 through Category10. By default, the category names are used as the captions in the ribbon.