Configure the properties of a workflow

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

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

To configure the properties of a workflow, open the workflow in the workflow editor. Click the canvas of the workflow editor and then click Properties to open the Properties form. Use the following procedures to configure the properties of the workflow.

Name the workflow

Follow these steps to enter a name for the workflow.

  1. In the left pane, click Basic Settings.

  2. In the Name field, enter a unique name for the workflow.

    For example, if you create purchase requisition workflows for each country or region in which you operate, you can name a purchase requisition workflow Purchase Requisitions Denmark or Purchase Requisitions Spain.

Specify the workflow owner

The workflow owner is the person who manages and maintains this workflow. Follow these steps to specify the workflow owner.

  1. In the left pane, click Basic Settings.

  2. From the Owner list, select the name of the person who will manage this workflow.

Select an email template

Follow these steps to select the email template that will be used to generate notification messages regarding this workflow.

  1. In the left pane, click Basic Settings.

  2. From the Email template for workflow notifications list, select the template.

Enter instructions for users

You can provide instructions to users who submit documents for processing and approval. This documentation refers to these users as originators.

For example, suppose that you are creating a purchase requisition workflow. The instructions that you provide can be viewed by users entering purchase requisitions in the Purchase requisitions form.

To view instructions, the originator clicks the icon in the workflow message bar. The following figure shows the location of the workflow message bar and the icon that originators click to view instructions.

Workflow message bar with the Submit button

Follow these steps to enter instructions for users.

  1. In the left pane, click Basic Settings.

  2. In the Submission instructions text box, enter the instructions.

  3. To personalize the instructions, you can insert placeholders, which are replaced with the appropriate data when they are displayed to users. To insert a placeholder, follow these steps:

    1. Click in the text box to specify where the placeholder should appear.

    2. Click Insert placeholder.

    3. From the list that is displayed, select the placeholder to insert.

    4. Click Insert.

  4. To add translations of the instructions, click Translations. In the form that is displayed, follow these steps:

    1. Click the Add button.

    2. In the list that is displayed, select the language in which you will enter the text.

    3. In the Translated text text box, enter the text.

    4. To personalize the text, you can insert placeholders. See the previous step for instructions about how to enter a placeholder.

    5. Click Close.

Specify when this workflow is used

You can create multiple workflows that are based on the same type. For example, you can create a purchase requisition workflow for each country or region in which you operate, such as Purchase Requisitions Denmark and Purchase Requisitions Spain.

When you have multiple workflows that are based on the same type, you must specify when each workflow is used. Continuing with the example, you would specify the following conditions:

  • Purchase Requisitions Denmark is used when: country/region = DK

  • Purchase Requisitions Spain is used when: country/region = ES

Follow these steps to specify when the workflow that you are configuring is used.

  1. On the left pane, click Activation.

  2. Select the Set the conditions for running this workflow check box.

  3. Click Add condition.

  4. Enter a condition.

  5. Enter additional conditions, if they are required.

  6. To verify that the conditions that you entered are set correctly, click Test. The Test workflow condition form is displayed.

    Select a record in the Validate condition area of the form. Click Test. The system evaluates the record to determine whether it meets the conditions that you specified.

    For example, if you create a purchase requisition workflow for Spain, the Validate condition area of the form displays a list of purchase requisitions. When you click Test, the system evaluates the selected purchase requisition to determine whether the country/region = ES.

    Click OK or Cancel to return to the Properties form.

Specify when notifications are sent

When a document is submitted for processing, a workflow instance is created. You can send notifications to users when workflow instances that are based on this workflow are started, completed, terminated, or stopped because of an error.

Follow these steps to specify when notifications are sent.

  1. On the left pane, click Notifications.

  2. Select the check box for each event that will trigger notifications:

    • Started - Send notifications when a workflow instance starts.

    • Stopped - Send notifications when a workflow instance stops because of an error.

    • Completed - Send notifications when a workflow instance is completed.

    • Unrecoverable - Send notifications when a workflow instance stops because of an unrecoverable error.

    • Terminated - Send notifications when a workflow instance is terminated.

  3. Select the row of an event that you selected in step 2.

  4. Click the Notification text tab.

  5. In the text box, enter the text of the notification.

  6. To personalize the text, you can insert placeholders, which are replaced with the appropriate data when they are displayed to users. To insert a placeholder, follow these steps:

    1. Click in the text box to specify where the placeholder should appear.

    2. Click Insert placeholder.

    3. From the list that is displayed, select the placeholder to insert.

    4. Click Insert.

  7. To add translations of the text, click Translations. In the form that is displayed, follow these steps:

    1. Click the Add button.

    2. In the list that is displayed, select the language in which you will enter the text.

    3. In the Translated text text box, enter the text.

    4. To personalize the text, you can insert placeholders. See the previous step for instructions about how to enter a placeholder.

    5. Click Close.

  8. Click the Recipient tab.

  9. Specify who receives the notifications from following options.

    Option

    Select this option to send notifications to…

    To send notifications, do this…

    Participant

    Users who are assigned to a specific group or role

    1. On the Recipient tab, click Participant.

    2. Click the Role based tab.

    3. From the Type of participant list, select the type of group or role to send notifications to.

    4. From the Participant list, select the group or role to send notifications to.

    Workflow user

    Users who are participants in this workflow

    1. On the Recipient tab, click Workflow user.

    2. Click the Workflow user tab.

    3. From the Workflow user list, select a participant in this workflow.

    User

    Specific Microsoft Dynamics AX users

    1. On the Recipient tab, click User.

    2. Click the User tab.

    3. The Available users: list includes all Microsoft Dynamics AX users. Select the users to send notifications to, and move those users into the Selected users: list.

  10. Repeat steps 3 through 9 for each event that you selected in step 2.

Enter comments about the changes that you made to this workflow

To enter comments about the changes that you made to this workflow, follow these steps.

  1. In the left pane, click Notes.

  2. In the Enter comments about the workflow text box, enter your comments.

  3. Review your comments. After you add comments, you cannot modify them.

  4. Click Add to add comments to the Comment history area.

See also

About the workflow editor

Create a workflow

Configure workflow elements