Menu Item Properties

The following properties are available for all menu items (display, output, and action), including those used for Web menus.

Property

Description

Name

The name of the menu item.

Label

Select a label to use as the name displayed for the item in menus and on buttons.

HelpText

Create a Help string for the menu item. The text is displayed on the status bar when a user selects the object opened by the menu item (for example, a form).

NoteNote
To write a Help topic for the menu item, find the topic with the same name as your menu item in the Application Documentation/Menu Items node in the Application Object Tree for Microsoft Dynamics AX. This will then be displayed instead of any Help written about the object opened by the menu item.

Class

Select the kind of object that the menu item will open.

Object

Choose an object of object type specified in the Class property.

Parameters

Specify the arguments that are passed to the object. Optional.

EnumTypeParameter and EnumParameter

Choose an enumerated type as a parameter for the Object, and then select an enum value as the EnumParameter property. Optional.

These properties are typically used when one form is used in several different situations. You can change the behavior of the form, depending on the EnumParameter value. For example, the PriceDiscGroup form is used by three different display menu items (PriceDiscGroup_*), which each have a different EnumParameter value. In the form's init method, a switch construct checks the value, and then the form is created accordingly.

RunOn

Choose whether the menu item should be executed on the client, the server, or where it is called from. Mostly used for menu items opening reports.

This property will only determine where the application object is executed from if the object has its own RunOn property set to Called from.

  • A form is instantiated and run on the client because the FormRun class always runs on the client.

  • A report is instantiated and run as specified by the menu item's RunOn property because the ReportRun class always runs where it was called from.

  • A class' main method is run as specified by its modifier. The class itself is instantiated as specified by its RunOn property. The instantiation might happen in the main method.

ConfigurationKey

Select which configuration key is required to enable the menu item. Use the key for the module that the object belongs to.

CountryConfigurationKey

Set a country-specific key in addition to or instead of a standard configuration key. Optional.

WebConfigurationKey

Select a Web-specific configuration key in addition to a standard configuration key. Web menu items only. Optional.

SecurityKey

Select which security key is required to enable the menu item in conjunction with NeededAccessLevel.

NeededAccessLevel

Define the minimum access required if the menu item is to appear on a menu or a button. In conjunction with SecurityKey, this property is used to set access to the menu items for different user groups.

Web

Specify the URL to open when running the menu item. Only used when the Class property is set to Web.

WebSecureTransaction

Select whether the menu item requires secure transactions (SSL). Web menu items only.

WebPage

Specify the Web page that is linked to the menu item. Used only when the Class property is set to Web.

MultiSelect

Choose to allow use of the menu item on multiple record selections in forms.

CreatedBy, CreationDate, CreatedTime, ChangedBy, ChangedDate, ChangedTime, LockedBy

Read-only System Properties.

NoteNote

When you use the Parameters or EnumParameter properties, errors such as type mismatches can only be found at run time—not at compile time.


Community Additions

ADD
Show: