NoteNote

The content in this topic only applies to Microsoft Dynamics NAV 2009 SP1. For Microsoft Dynamics NAV 2009 content, see Developer and IT Pro Help for Microsoft Dynamics NAV 2009.

Promoted actions are actions that are displayed in the Action Pane of the RoleTailored client. You can organize promoted actions into different categories, where each category is indicated by a caption in the Action Pane. You define up to 10 categories for a page. The following figure illustrates a page that has promoted actions under the following categories:

Action Pane with four categories.

You assign a promoted action to a category by setting the PromotedCategory property of the action. You can choose among the following categories:

By default, these category names correspond to the captions that are displayed for the category on the page in the RoleTailored client. You will typically want to change these captions, especially the Category4 through Category10 captions.

You change category captions on a page-by-page basis and for each RoleTailored client language.

To define promoted action category captions

  1. In the Classic client, on the Tools menu, click Object Designer.

  2. In Object Designer, click Page, select the page, and then click Design.

  3. In Page Designer, select a blank row.

  4. In the View menu, click Properties.

  5. In the Page - Properties window, locate the PromotedActionsCategoriesML property, click the Value field, and then click the AssistButton to open the Multilanguage Editor.

  6. In the Multilanguage Editor, set the Language field to the language version of the categories that you want to define.

  7. In the Value field for the language, type the category captions as follows:

    New_caption,Process_caption,Reports_caption,Category4_caption,Category5_caption,Category6_caption,Category7_caption,Category8_caption,Category9_caption,Category10_caption

    Substitute the italic text with the text that you want for each caption. Separate each caption with a comma. The position of the caption in the list determines its corresponding category setting in the PromotedCategory property for actions, as shown in the following table:

    PromotedActionsCategoriesML caption position PromotedCategory property value

    First

    New

    Second

    Process

    Third

    Reports

    Fourth

    Category4

    Fifth

    Category5

    Sixth

    Category6

    Seventh

    Category7

    Eighth

    Category8

    Ninth

    Category9

    Tenth

    Category10

    For example, to define the captions for the figure at the beginning of this topic, you enter the following text:

    New,Tasks,Reports,Discounts

    Then, to assign a promoted action to the caption Tasks, in the Action Designer, set the PromotedCategory property value for the action to Process.

    NoteNote

    You only need to define captions for the number of categories that you want to use on a page. You do not need to define captions for all 10 categrories.

  8. Close the page properties and save the page.

See Also