How to: Create a New Module with Workflow
Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012
In Microsoft Dynamics AX, modules are enabled for workflow. However, in some cases, you will need to create a new module that contains workflow. In each module that contains workflow, a Workflows list menu item must be added to the Setup pane. The following procedures are described in this topic:
Creating a new module enumeration.
Creating a display menu item for the Workflows list.
Creating a menu for the new module.
How to display the new menu in the client.
To Add a Module to the ModuleAxapta Base Enum
In the Application Object Tree (AOT), expand the Data Dictionary node, expand Base Enums, right-click ModuleAxapta, and then click New Element. A new enumeration displays under the ModuleAxapta node.
Right-click the new enumeration, and then click Properties.
In the Properties sheet, select the Label property, and then enter the label of the new module.
To Create a Display Menu Item for the Workflows List
In the AOT, expand the Menu Items node.
Right-click the Display node, and then click New Menu Item. A new menu item displays under the Display node.
Right-click the new display menu item, and then click Properties.
In the Properties sheet, set the following properties.
Property
Value
Name
Set to WorkflowConfigurations<xxx> where <xxx> is replaced by a reference to the name of the new module. For example, you could set this value to WorkflowConfigurationsRecruit for a new module named Recruiting.
Label
Set text or a label that represents the text for the workflows list in the client.
ObjectType
Set to Form.
Object
Set to WorkflowTableListPage.
EnumTypeParameter
Set to ModuleAxapta.
EnumParameter
Set to the enum created in the preceding procedure.
In the AOT, right-click the new display menu item, and then click Save.
After the new module enum and display menu item are created, you can add them to the Menus node.
To Create a Menu for a New Module
In the AOT, right-click the Menus node, and then click New Menu. A new menu displays under the Menus node.
Right-click the new menu, and then click Properties.
In the Properties sheet, set the following properties.
Property
Value
Name
Set to a label or name of the new module.
Label
Set to a label that represents the text to display for the new menu in the client.
In the AOT, right-click the new menu, point to New, and then click New Submenu. A submenu node displays under menu node created in the previous step.
Right-click the new submenu node, and then click Properties.
In the Properties sheet, set the following properties.
Property
Value
Name
Set to Setup or another label that represents the text for the Setup pane in the client.
Label
Set to Setup or another label that represents the text for the Setup pane in the client.
NormalImage
Set to 3478. This will display a gears icon for the setup pane.
ImageLocation
Set to EmbeddedResource.
In the AOT, right-click the Setup node created in the previous step, point to New, and then click New Menu item. A new menu item displays under the Setup node.
Right-click the new menu item, and then click Properties.
In the Properties sheet, set the MenuItemName property to the display menu item created in the previous procedure.
In the AOT, right-click the new menu item, and then click Save.
After the menu for the new module is created, you must add a reference to the menu in the MainMenu node to display the menu in the client.
To Add a Menu to the Client
In the AOT, expand the Menus node, right click MainMenus, point to New, and then click Menu reference. The Select: Menus window is displayed.
In the Select: Menus window, select the new module menu that you created in the previous procedure, and drag the menu to the MainMenu node in the AOT.
In the AOT, right-click the MainMenu node, and then click Save.
See also
Requirements for Enabling Workflow in an Application Module
Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.