Web Menu Item Properties

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

The following table provides a description of the properties that are specific to web menu items.

Property

Description

New in this version of
 Microsoft Dynamics AX

Big

Specifies the size of the button when it is used in an action pane. The possible values are as follows:

  • Yes – The button is displayed at full size and positioned at the start of the group.

  • No – The button is displayed at the smaller size and positioned in the right side of the group.

AX 2012

CloseDialogBehavior

Specifies the action that is taken on the parent window when the modal dialog window closes. The possible values are as follows:

  • Auto –Depending on how the modal dialog was used, the appropriate refresh actions are performed when the modal dialog is closed. This is the default value.

  • RefreshDataSource – The read-only data source on the parent form is refreshed. This preserves the current selection and performs a Research() operation on the data source.

  • RefreshPage – Refreshes the page.

  • Submit – Refreshes the parent page.

  • None – No action is performed.

AX 2012

HideActionPane

Specifies whether the action pane is visible on the page that is being opened.

AX 2012

HomePage

Specifies whether the page is a role center page, and is deployed to the main Enterprise Portal site.

NeedsRecord

When set to Yes, the menu item will be displayed when there are no records in the data set.

PageDefinition

The page that the web menu item points to.

Parameters

Specifies the arguments that are passed to the page that is being opened. Each parameter must have the following form:

name=value

If multiple parameters are to be passed, they must be separated by an ampersand character:

mode=2&category=1

URL

Specifies the URL to navigate to.

WebConfigurationKey

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

WindowMode

Specifies the type of window the page being opened will be displayed in. The possible values are as follows:

  • Inline – The page being opened will replace the existing content in the browser. If the web menu item is being accessed from a modal window, the page being opened will open in a new browser window.

  • Modal – If no modal window is open, a new modal will be created. If the web menu item is being accessed from a modal window, the page being opened will replace the content of the current modal window.

  • NewModal – The page being opened will always be displayed in a new modal window.

  • NewWindow – The page being opened will be opened in a new browser window.

AX 2012

WindowParameters

Specifies additional parameters for the SharePoint modal dialog that control its appearance. The parameters must be enclosed in braces {} and separated by commas.

The following example shows the settings for the WindowParameters property to display the modal dialog with the size 400 x 300 pixels, and having no close box or maximize buttons.

{width:400, height:300, showClose:false, allowMaximize:false}

AX 2012

WindowSize

Specifies the size of the window that the page being opened will be displayed in. The possible values are as follows:

  • Smallest – 330 x 200 pixels

  • Small – 550 x 450 pixels

  • Medium – 800 x 630 pixels

  • Large – 930 x 630 pixels

  • Maximum – The largest size that will fit in the boundaries of the main browser window.

AX 2012

For more information about additional properties, see Menu Item Properties.