How to: Create a Line-item Workflow

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

This procedure describes how to create a line-item workflow in the Application Object Tree (AOT). A line-item workflow is used together with a standard workflow type that was created in the AOT.

To create a line-item workflow

  1. If it does not already exist, create the workflow type for the base document.

  2. Create a workflow type for the line item document. Use the same techniques that are described in Creating a Workflow Type.

  3. In the AOT, expand the Workflow > Workflow Types node. Locate the workflow type for the base document.

  4. Expand the node for the base document workflow type.

  5. Right-click the Line Item Workflow node and then click New Line Item Workflow.

  6. Right-click the node for the new line item workflow and then click Properties.

  7. Set the properties for the line item workflow. The following table lists the available properties.

    Property

    Description

    Name

    The name for the line item workflow.

    Label

    A descriptive name for the line item workflow.

    HelpText

    A description of the line item workflow.

    LineItemWorkflowRelation

    Specifies the relation for the line item workflow.

    StartedEventHandler

    Specify the event handler class that you created for the Started event.

    CompletedEventHandler

    Specify the event handler class that you created for the Completed event.

    CanceledEventHandler

    Specify the event handler class that you created for the Canceled event.

    RecallMenuItem

    The menu item for the recall action, if it is used for the line item workflow.

    RecallWebMenuItem

    The web menu item for the recall action, if it is used for the line item workflow.

    CancelMenuItem

    The menu item for the cancel action, if it is used for the line item workflow.

    CancelWebMenuItem

    The web menu item for the cancel action, if it is used for the line item workflow.

    EnableLineItemWaitSelection

    Specifies whether the wait selection is enabled for the workflow editor.

  8. Expand the node for the line item workflow.

  9. Right-click the Line Item Workflow Types node, and then click New Line Item Workflow Type.

  10. For the new node, set the LineItemWorkflowType property to the name of the workflow type for the line item that you created in step 2.

  11. Save the changes for the base workflow type.

The line item workflow will now be available as an element in the workflow editor when you set up a workflow for the base document.

Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.