Activating a Workflow

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

After you create a workflow in Microsoft Dynamics AX, you must implement a way to activate the workflow at runtime to display the workflow in your application.

Application users start a workflow when they click the Submit button on forms that are enabled for workflow and have a valid workflow configuration.

The Submit button is controlled by an action menu item set on the SubmitToWorkflowMenuItem property for the workflow type. The action menu item references the class that you must implement to activate the workflow and other business logic associated with activating a workflow.

Depending on the needs of your application, you can activate a workflow by using any of the methods listed in the following table.

Method	Description
Workflow::activateFromWorkflowType Method	Used to activate a specific workflow type without knowing which configuration to use.
Workflow::activateFromWorkflowConfigurationId Method	Used to activate a specific version of a configuration.
Workflow::activateFromWorkflowSequenceNumber Method	Used to activate a configuration without knowing the specific version.

For more information about how to activate a workflow, see Requirements for Enabling Workflow in an Application Module.

In This Section

• How to: Activate a Workflow from a Workflow Type
  Use this activation method to run the default configuration for a workflow type, or when a specific configuration is not needed or specified.

• How to: Activate a Workflow using the Configuration ID
  Use this activation method when there are several versions of the same configuration and you need to select a specific version of that configuration.

• How to: Activate a Workflow using the Sequence Number
  Use this activation method when there are several versions of the same configuration and you always want to run the active version of that configuration, regardless of the version.

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.