Professional Documents
Culture Documents
Objectives
The objectives are:
Chapter 5: Workflow
5-1
Introduction
5-2
Chapter 5: Workflow
To better understand this workflow, suppose that Sam submits an expense report
for 7,000 U.S. Dollars (USD). In this scenario, Ivan must review the receipts that
Sam routed to him. Then Frank and Sue must approve the expense report.
Now suppose that Sam submits an expense report for 11,000 USD. In this
scenario, Ivan must review the receipts and Frank, Sue, and Ann must approve
the expense report.
Workflow Benefits
Process visibility: The workflow system lets you track the status,
history, and performance metrics of a specific workflow instance.
This helps you determine whether changes should be made to the
workflow to improve efficiency.
There are several benefits of using the workflow system in your organization:
Workflow Introduced
Workflow Improvements
o
o
o
o
o
o
o
o
o
o
Automated tasks.
Workflow history
General Features
5-4
5-3
Chapter 5: Workflow
Automated Tasks
A message queue
The messaging batch job or the workflow runtime API can invoke the application
code, if it is required. The X++ workflow runtime is compiled into the common
intermediate language (CIL) of the .NET Framework.
The workflow infrastructure consists of two components that are hosted on the
AOS: the X++ workflow runtime and the managed workflow runtime.
Sara, the Chief Financial Officer (CFO), would like a credit check to be
performed for any sales order over 500.00 USD.
Architecture
You can now add an automated task to your workflows. An automated task runs
on business logic and requires no human interaction. For example, an automated
task can perform a credit check, run a report, or update a record.
5-6
5-5
Chapter 5: Workflow
The following diagram provides the high-level architecture of the workflow
infrastructure.
Step
Runtime
Activity
Users can use the workflow forms and controls in the Microsoft Dynamics AX
client and in Enterprise Portal to participate in business processes.
Programmatically, any components that can invoke X++ code can use X++ to
invoke a workflow or submit a document to a workflow. The following table
describes the workflow steps that occur when a user submits an expense report to
the workflow system for approval.
X++
Workflow
Runtime
5-7
Step
X++
Workflow
Runtime
Managed
Workflow
Runtime
Runtime
Activity
The workflow architecture provides for a reliable and durable messaging system.
It makes sure that the state of the workflow is always synchronized with the state
of the application. In case of an unexpected hardware or software failure, the
workflow instance state is returned to its last known save point and the message
stays in the queue. So, from an architecture perspective, the recovery model is to
fix the problem and resume the workflow.
Both
5-8
The workflow owner is the person who will manage and maintain this workflow.
Use the following steps to specify the workflow owner.
Chapter 5: Workflow
Create a Workflow
Use the following procedures to create and configure a workflow.
For example, suppose you are creating a purchase requisition workflow. The
instructions you provide can be viewed by users entering purchase requisitions in
the Purchase requisitions form.
You can provide instructions to users who will be submitting documents for
processing and approval. (This documentation refers to these users as
originators.)
Use the following steps to select the email template that will be used for
notifications sent regarding this workflow.
5-10
5-9
Chapter 5: Workflow
3. If you want to personalize the text, you can insert placeholders.
Placeholders will be replaced with the appropriate data when
displayed to users. To insert a placeholder:
a. Click in the text box to specify where the placeholder should
appear.
b. Click Insert placeholder.
c. From the list that is displayed, select the placeholder that you
want to insert.
d. Click Insert.
4. If you want to add translations for the text, click Translations. In the
form that appears, do the following:
a. From the Translate to field, select the language in which you
will enter text.
b. In the Translated text box, enter text in the language you
selected.
c. Click Close.
When you have multiple workflows that are based on the same type, you need to
specify when each workflow should be used. Continuing with the example, you
would need to specify that:
Use the following steps to specify when the workflow you are configuring should
be used.
1.
2.
3.
4.
5.
5-11
1.
2.
3.
4.
5.
6.
7.
8.
9.
10. Repeat this procedure for each event that will trigger notifications.
6. If you want to verify the conditions you entered are set correctly,
click Test. The Workflow condition editor form is displayed.
7. Select a record in the Validate condition area of the form. Click
Test. The system will evaluate the record to determine if it meets the
conditions you specified. For example, suppose you are creating a
purchase requisition workflow for Spain. The Validate condition
area of the form will display a list of purchase requisitions. When
you click Test, the system will evaluate the selected purchase
requisition to determine if country/region = ES.
8. Click OK. The Properties form is redisplayed.
5-12
Chapter 5: Workflow
The workflow editor is a graphical interface you can use to create Microsoft
Dynamics AX workflows by arranging workflow elements on a design surface.
This is similar to how you would graphically model a business process using
Microsoft Visio. You can add, delete, and reposition workflow elements so that
they precisely model the business processes you want to automate.
You can also add flow-controls, such as manual and automated decisions and
parallel activities so you can create complex workflows that exactly model the
business processes you want to automate. The following illustration outlines the
areas of the workflow editor.
Action Pane: The Action Pane that runs along the top of the
workflow editor contains buttons you can use to navigate in the
workflow, copy and paste workflow elements, and configure
properties. To configure properties of the whole workflow, select the
canvas. To configure properties of a specific workflow element,
select that element.
5-13
Canvas: The canvas is the main area where you arrange the
workflow elements. The flow of the business process you are
modeling is indicated by connectors that join the elements. Some
elements can contain other elements, that creates a parent-child
relationship. For example, an approval element contains one or more
approval steps, that are child elements of the parent approval
element. If you double-click the approval element, you can add and
configure the approval steps.
1. Click New.
2. In the Create workflow form, select the workflow type you want to
create, and then click Create workflow. The workflow editor opens
displaying only the Start element and the End element on the canvas.
To open the workflow editor to create a new workflow, follow these steps:
1. Open the module you want to work in, and then click Setup >
Workflows.
2. In the Workflows list page for that module, use one of the following
procedures.
You open the workflow editor when you create a new workflow or modify an
existing workflow.
5-14
Chapter 5: Workflow
You can change how you view the workflow on the canvas by using the zoom
and pan controls in the lower right corner of the canvas window.
To widen the focus when you are zoomed in to include more of the
workflow, click Zoom out.
You can zoom into the canvas to view more detail in part of the workflow and
then zoom out to view more of the workflow.
To close the Overview window, click the close icon in the upper
right corner of the Overview window.
If you have zoomed in to focus on just a part of the workflow, you can use the
Overview pane to quickly pan to another part of the workflow.
5-15
Right-click the element you are working with and select View
parent. The canvas now displays the parent element. You can repeat
this procedure as long as there are parent elements to view.
Tasks
Line-item elements
Approval process
Manual task
Automated task
o
o
Flow-control elements
Manual decision
Conditional decision
Parallel activity
Subworkflow
A manual task is a unit of work that must be performed by a user. For example,
an expense report workflow can have manual tasks that require the assigned users
to:
Manual Task
o
o
o
o
Workflow Elements
In the breadcrumb path in the top left corner of the canvas, click the
parent element you want to return to. If you click Flowchart, you
will return to the main workflow.
When you are zoomed in, the Overview window displays a yellow rectangle
superimposed on a view of the whole canvas, indicating the area that is currently
visible. If you want to view another part of the workflow, use the mouse pointer
to drag the rectangle to a new location.
5-16
Automated Task
Chapter 5: Workflow
An automated task is a unit of work that must be performed by the system. (It
requires no human interaction.) For example, a sales order workflow can have
automated tasks that:
Creates a customer record for the customer, if one does not already
exist.
Approval Process
An approval process is a process that consists of separate steps. The user at each
approval step can:
Line-Item Elements
A workflow can be created to process documents, or the line items on a
document. For example, assume that you have created an approval workflow for
timesheets. (This workflow will be referred to as the document workflow.) You
can add a line-item element to that document workflow. When the line-item
element is executed, each line item on the document is submitted for processing.
You can have all the line items processed by the same line-item workflow, or you
can have each line item processed by a different line-item workflow.
Suppose that an employee has submitted a timesheet that resembles the following
figure.
5-17
TIP: Each workflow configuration has a Start node and an End node by default.
The first action should always connect from the Start node to the desired node,
and the last step should always connect from the desired "last step node" to the
End node.
1. From the Workflow editor form select the desired node in the
Workflow elements pane on the left.
2. Drag and drop the element onto the Canvas. The element can be
repositioned on the canvas by dragging and dropping it again.
3. Each workflow element must be connected in the correct sequence.
This is done by hovering over the "starting" element with your
mouse and then clicking one of the connector points. With the mouse
button held down, drag the mouse pointer to the "next" element.
Release the mouse button when you have hovered over one of the
connector points on the "next" element.
4. Repeat steps 2 and 3 for each desired element.
You can use the following elements to design workflows that have alternate
branches or branches that run concurrently.
5-18
Chapter 5: Workflow
Procedure: Remove Elements from the Canvas
If you have added an element to the canvas that you no longer need, you can
remove the element. To remove an element from the canvas, follow these steps:
1. In the Workflow editor form, highlight the element you want to
remove.
2. Click Delete in the Edit group of the Action Pane.
3. Or, you can right-click and select Delete.
NOTE: Each type of workflow element has different properties and therefore
different tabs and buttons. The following sections describe steps for configuring
each element type.
Configuring the basic settings including the name, subject line, and
instructions.
To begin configuring an approval step, right-click the approval step node on the
Canvas and click Properties. The Properties form is displayed. Use the
following procedures to configure the properties of the approval step.
NOTE: Not all workflow types have approval elements available.
5-19
1. In the Properties window for the Approval Step node, click the
Assignment tab.
TIP: Similar steps are used for setting up the name, subject line and instructions
that are described in the Procedure: Configure Properties of a Workflow. Instead
of selecting the outer workflow node, select the node on the canvas that you want
to configure and use the buttons in the Modify workflow group of the Action
Pane or right-click the node and select Properties.
5-20
Chapter 5: Workflow
c. Workflow user: If you want to assigns the task to users of this
workflow, select the Workflow originator, Work item owner, or
Workflow owner on the Workflow user tab.
d. User: If you want the task assigned to specific users, click this
option and select the appropriate users on the Users tab.
3. Click the Time limit tab and specify how much time a user has to act
on, or respond to documents that reach this approval step. Select one
of the following options:
a. Hours: If you select this option, enter the number of hours the
user has to respond, and then select the calendar your
organization uses.
b. Days: If you select this option, enter the number of days the user
has to respond, and then select the calendar your organization
uses.
c. Weeks: If you select this option, enter the number of weeks the
user has to respond.
d. Months: If you select this option, select the day and week by
which the user must respond. For example, you can have the user
respond by Friday of the third week of the month.
e. Years: If you select this option, select the day, week, and month
by which the user must respond. For example, you can have the
user to respond by Friday of the third week of December.
4. If the approver does not act on a document in the time allowed, the
document is considered overdue and will be escalated according to
the options you selected on the Escalation tab.
5. Click the Completion policy tab.
Single Approver
If you select this option, the action applied to the document is determined by the
first person who responds.
For example, assume that Sam has submitted an expense report for 15,000 USD
and that it is currently assigned to Sue, Jo, and Bill. If Sue is the first person to
respond to the document, the action she takes is applied to the document. For
example, if Sue approves it, the document is sent to Ann for approval. If Sue
rejects it, the document is rejected and sent back to Sam.
5-21
If Sue and Jo approve the document, the document is sent to Ann for
approval.
Sam has submitted an expense report for 15,000 USD and that it is
currently assigned to Sue, Jo, and Bill.
If Sue and Jo approve the document, the document is sent to Ann for
approval.
If you select this option, all of the approvers must approve the document in order
for the workflow to continue. For example, consider the workflow previously
illustrated. Assume that Sam has submitted an expense report for 15,000 USD
and that it is currently assigned to Sue, Jo, and Bill. If all of the approvers (Sue,
Jo, and Bill) approve the document, it is sent to Ann for approval. If one person
rejects the document, the document is rejected and sent back to Sam.
All Approvers
In this scenario, the first two approvers who respond determine the action applied
to the document. This is because the 50 percent requirement is met. Assume that
Sue and Jo are the first two approvers to respond.
If you select this option, the action applied to the document is determined when a
specific percentage of the approvers respond. For example, consider the
workflow previously illustrated. Assume that:
Percentage of Approvers
For example, consider the workflow previously illustrated. Assume that Sam has
submitted an expense report for 15,000 USD and that it is currently assigned to
Sue, Jo, and Bill. The first two approvers who respondSue and Jodetermine
the action applied to the document.
If you select this option, the action applied to the document is determined when a
majority of approvers respond.
Majority of Approvers
5-22
Chapter 5: Workflow
When a user fails to act on a document in the time allowed, the document is
considered overdue. Use the following procedure to specify what should happen
to overdue documents.
1. In the left pane of the Properties form of the Approval node, click
the Escalation tab.
2. Select the Use escalation path check box to create an escalation
path. The system will automatically assign the document to the users
listed in the escalation path.
3. To add a user to the escalation path, click Add escalation. Then do
the following:
4. Click the Person tab. Select whether you want the approval step
assigned to a Hierarchy, Workflow user, or a User.
5. Continue adding users to the escalation path and arranging the order
of the users as needed.
6. If the users in the escalation path fail to act on the document in the
time allowed, the system will automatically act on the document. To
specify the action the system should take, select the Action row.
Then select an action in the End action tab.
5-23
In some instances the approval step you are configuring is required only under
specific conditions. For example, suppose you are configuring an approval step
for a purchase requisition workflow. You can have the approval step occur only
when the purchase requisition is greater than 10,000 USD.
Specify when this approval step is required. The approval step can always be
required, or only under specific conditions.
For example, suppose you have added Donna and Erin to the escalation path and
you have selected Approve as the action the system should take. In this scenario,
the system will assign the overdue document to Donna. If Donna fails to act on
the document in the time allowed, the system will assign the document to Erin. If
Erin fails to act on the document in the time allowed, the system will approve the
document.
5-24
Chapter 5: Workflow
Challenge Yourself!
Using the information provided, create a new user request workflow and add an
approval element that requires all new user requests to be approved. When you
are finished configuring the workflow, activate it and export the configuration so
that later it can be imported into another environment.
Create connections from the Start to the Approval and the Approval
to the End.
Step by Step
1.
2.
3.
4.
5-25
5. Create a connection between the Start node and the new Approve
user request node by clicking and dragging the mouse from the
Start node connector to the Approve user request node connector.
6. Create a connection between the Approve user request node and
the End node by clicking and dragging the mouse from the Approve
user request node to the End node.
7. Right-click on the outer Workflow pane in the canvas and select
Properties.
8. On the Basic settings tab, select Admin for the Owner field, and in
the Submissions instructions field enter detailed instructions such
as "Please submit the user request for approval."
9. Close the Properties form.
10. Right-click the Approve user request node on the canvas and select
Properties.
11. On the Properties window, click the Advanced settings tab.
12. Select the Use final approver check box and select Admin for the
user.
13. Close the Properties form.
14. Highlight the Approve user request node in the canvas, and then
click Level down in the Action Pane.
15. Right-click the Step 1 node in the canvas and select Properties.
16. On the Basic Settings tab, enter a name for the node such as
"Approval."
17. Enter a Work item subject such as "Vendor User Request Approval."
18. Enter a Work item instruction such as "Please approve the vendor
user request."
19. Click the Assignment tab.
20. Select User from the list on the Assignment type tab.
5-26
Chapter 5: Workflow
21. Click the User tab.
22. Select Admin in the Available user pane and then click the arrow
(>) button to move the user to the Selected user pane.
23. Close the Properties window.
24. Click Level up on the Action Pane.
25. If the Error pane is not open, click Error pane in the Show group
of the Action Pane. Verify there are no errors.
26. Click Save and close.
27. Enter a version description such as "Original version", and then click
OK.
28. Click OK.
29. On the User workflows list page, click the Versions button.
30. On the Workflow versions form, click Make active.
31. Click the double arrow (>>) button and select Export.
32. Click the yellow folder icon and browse to Documents to save the
file.
33. Click Save, and then click OK.
34. Close the Workflow versions form.
5-27
3. Select the entire row of the event you selected in step 2. Click the
Notification text tab and in the text box, enter the text of the
notification.
4. To personalize the text, click Insert placeholders.
5. To add translations for the text, click Translations.
1.
2.
3.
4.
Configure Decisions
5-28
Chapter 5: Workflow
6. Click the Person tab. Specify who should receive the notification.
Select one of the following options.
a. Participant: If you select this option, click the Role based tab to
select a participant.
b. Workflow user: If you select this option, click the Workflow
user tab to select the user.
c. User: If you select this option, click the User tab to select the
users.
7. Repeat steps 3 through 7 for each event you selected in step 2.
User: Select this option if you want the decision assigned to any
Microsoft Dynamics AX users.
Workflow user: Select this option if you want the decision assigned
to users in the workflow.
Specify who the decision should be assigned to. You can assign a decision to one
of the following:
TIP: Keep in mind that although you can assign the decision to multiple people,
only one person can make the decision.
To assign the decision to a participant, complete the following steps.
1.
2.
3.
4.
5-29
b.
c.
d.
e.
To specify the starting point, select a person from the Start from
list.
When you use a hierarchy to assign a task, the system must retrieve a range of
employee names from the hierarchy. These names represent employees the task
could possibly be assigned to. For the system to retrieve a range of names, you
need to specify the starting point and ending point of the range.
If the user does not complete the task in the time allowed, the task is considered
overdue and will be escalated according to the options you selected in the
Escalation area.
Days: If you select this option, enter the number of days the user
has to complete the task. Select the calendar your organization
uses. Then enter the information about your organizations work
week.
Weeks: If you select this option, enter the number of weeks that
the user has to complete the task.
Months: If you select this option, select the day and week by
which the user must complete the task. For example, you can
have the user complete the task by Friday of the third week of
the month.
Years: If you select this option, select the day, week, and month
by which the user must complete the task. For example, you can
have the user complete the task by Friday of the third week of
December.
5-30
Chapter 5: Workflow
Procedure: Assign a Task to a Hierarchy
To assign a task to a hierarchy, complete the following steps.
1. In the left pane of the Properties form, click Assignment. On the
Person tab, click Hierarchy.
2. Click the Hierarchy selection tab.
3. To specify the starting point, select a person from the Start from
list.
4. To specify the ending point, click Add condition.
5. Click the Hierarchy options tab.
5-31
If the user does not complete the task in the time allowed, the task is considered
overdue and will be escalated according to the options you selected in the
Escalation area.
5-32
Chapter 5: Workflow
Procedure: Assign a Task to a User
5-34
You can use a parallel activity for two or more processes to execute at the same
time. To configure a parallel activity to a workflow configuration, follow these
steps:
If the user does not complete the task in the time allowed, the task is considered
overdue and will be escalated according to the options that you select on in the
Escalation area.
5-33
Chapter 5: Workflow
To configure the steps of each branch in the parallel activity, click the Level
down button on the Action Pane or double-click the parallel activity in the
Canvas.
By default each parallel activity will have two branches. To add additional
branches drag the Branch node from the Workflow elements pane into the
Canvas. To configure one of the parallel branches, double click the node. Or,
you can click the expand button to enlarge the branch. Use the collapse icon to
return to the original view.
To return to the main workflow window, click Level up or click Workflow and
in the workflow breadcrumb bar.
5-35
Use the following steps to select the workflow that will run when this
subworkflow element is executed.
Configure a Subworkflow
5-36
Chapter 5: Workflow
5-37
Use the following steps to specify when the system should automatically act on
the task.
For example, suppose you have a task that requires a member of your Expense
Reports Department to review the receipts submitted with an expense report.
According to company policy, this task must be performed when the expense
report is over 100 USD. In this scenario, you would configure the system to
automatically mark the task as Complete when the total amount is less than 100
USD.
You can configure the system to automatically act on the task under certain
conditions.
Automatic Actions
1.
2.
3.
4.
5.
6.
7.
8.
9.
Configure Tasks
5-38
Chapter 5: Workflow
Procedure: Specify Which Actions will be Available
When a task is assigned to a user, the user must act on the task. Select the actions
you want to be available to the user.
NOTE: The actions available will vary, depending on how the software
developer designed the task.
1.
2.
3.
4.
5.
6.
7.
In the left pane of the Properties window for a task, click Advanced
settings.
Select the Complete check box if you want the user to mark this task
as complete.
Select the Reject check box if you want the user to reject the
document that is submitted.
Select the Request change check box if you want the user to request
changes to the document that was submitted.
Select the Delegate check box if you want the user to assign this task
to another user.
Select the Reassign check box if you want the user to reassign this
task to another user in the work item queue.
Select the Release check box if you want the user to reassign this
task back to the work item queue so that another user can complete
it.
5-39
1. From the Workflow editor, click the Error panes button in the
Show group of the Action Pane.
You can also have multiple versions of the same workflow type. However, if
more than one configuration of the same type exists, only one can be the default.
The version created first is set to the default workflow configuration by default
for the selected type.
Each workflow can have multiple versions. The original version is called 1.0.0.0
and the version numbers are updated automatically by the system when saving a
new version. Each time you modify an active version of a workflow, the system
saves the original version. When a new version is activated, the older version is
deactivated. There can only be one active version of each workflow
configuration.
When you save a new version of a workflow for the first time, you are prompted
with two options: if you want to activate the new version, or if you want to save
and close.
Once you have finished making changes in the workflow editor, you will need to
review the errors and save the changes. If any errors exist they must be resolved
before the workflow configuration can be activated.
5-40
Chapter 5: Workflow
2. Use the information in the Error Pane window to resolve any
issues.
3. Double-click an error message to open the source that is causing the
error.
4. When all errors are resolved click Save and close.
5. On the Save workflow dialog enter a description about the changes
you have made to this version of the workflow and click OK.
6. On the Activate workflow dialog, select one of the following:
a. Select Activate the new version to save the changes and
activate the new version (which will deactivate on an older
version if one exists).
b. Select Keep the previous version activated to save the changes
without activating them. The new version can be activated later.
7. Click OK.
NOTE: You can also click Save and close when errors exist. When you do this,
the Save workflow dialog will appear. Enter any version notes and then click
OK. The Activate workflow dialog will not open. The workflow cannot be
activated until all errors are resolved.
TIP: If you want to disregard any changes in the workflow editor, click Cancel.
5-41
Copy
Delete
Make
active
Modify
View
Button
Open the workflow editor, so that you can modify the selected
version of the workflow.
Description
1. Open the module you are working in, and then click Setup >
[Module name] workflows.
2. In the Workflows list page, select the workflow you want to
activate, and click Versions in the Action Pane. The Workflow
version form opens.
Each workflow configuration can have multiple versions. Only one version of a
workflow can be activated at a time. To view or edit workflow versions, follow
these steps:
5-42
Import
Button
Import a workflow from a file. For example, this is useful when
moving a workflow configuration from a testing environment
into a production environment. The Export button must be used
to create a file that can be imported into another environment.
Description
Chapter 5: Workflow
Export
Export the selected version of the workflow to a file. For
example, this is useful when preparing to move a workflow
configuration from a one environment into another environment.
Some organizations require journals be approved by a user other than the person
who entered the journal. Based on journal names, you can require manual
approval, workflow approval, or no approval. If workflow approval is set up for a
journal, additional controls are displayed at the top of the Journal form. These
include a yellow information bar and a Submit button or an Actions menu.
Some buttons in the Journal and Journal voucher forms are not available when a
journal is submitted for workflow journal approval. When the journal is
approved, the options in the Post menu are available, and the other controls and
fields in the form are not. If a user edits an approved journal, the workflow status
is reset, the options in the Post menu are not available, and the other controls and
fields are available. When the changes are made, the journal must be resubmitted
for approval.
View the journal: This allows you to review the journal without
making changes.
Edit the journal: When changes are complete, you must resubmit
the journal for approval.
The following options are available for payment journals that have a workflow
status of Approved:
Payment journal
Invoice journal
Invoice register
Vendor disbursement
Approval
Invoice register
Journal type
You can use workflow approvals for the following journals and journal types in
Accounts payable.
1. Open the module you are working in, and then click Setup >
[Module name] workflows.
2. In the Workflows list page, select the workflow you want to
activate, and click Versions in the action pane. The Workflow
version form opens.
3. Select the version of the workflow you want to activate, and then
click Make active. A checkmark will appear in the Active column
next to the activated workflow. After you activate a workflow
version, it remains active until you delete it or activate another
version of the workflow.
Remittance journal
Workflow Types
Microsoft Dynamics AX 2012 provides approximately 60 workflow types out-ofthe-box. Each workflow type is designed for a specific type of transaction.
5-44
Each module that supports workflow has its own workflow form located in the
Setup folder of that module. ([Module] > Setup > [Module] workflows). There
are a few exceptions to this rule: In the System administration module, the
workflows are located in System administration > Setup > Workflow > User
workflows. In addition, the workflows in the Organization administration
module are located in Organization administration > Setup > Workflow >
Organization workflows.
The following topics provide a high level overview of each workflow type
organized by module.
5-43
Chapter 5: Workflow
Type
The following workflow types are available for Accounts payable. You must
create at least one workflow configuration for each type you want to use
workflow approvals for.
Purchase agreement
approval
Vendor disbursement
journal workflow
Vendor invoice
Vendor redraw
promissory note journal
workflow
Vendor settle
promissory note journal
workflow
5-45
Calculated Field
Description
Based on journal names, you can require manual approval, workflow approval, or
no approval. If workflow approval is set up for an accounts receivable journal,
additional controls are displayed at the top of the Journal form. If a user edits an
approved journal, the workflow status is reset, the options for the Post button are
not available, and the other controls and fields are available. When the changes
are made, the journal must be resubmitted for approval.
Journal Workflows
The following calculated fields and expressions are used with Accounts payable
workflow journal approvals. For each configuration, you can set up conditions
that include these calculated fields and expressions.
5-46
Chapter 5: Workflow
View the journal: This allows you to review the journal without
making changes.
Edit the journal: When changes are complete, you must resubmit
the journal for approval.
The following options are available for payment journals that have a workflow
status of Approved:
Remittance journal
Payment journal
Customer payment
Journal type
You can use workflow approvals for the following journals and journal types in
Accounts receivable.
5-47
Customer bank
remittance workflow
Customer payment
workflow
Type
Customer recurring
invoice workflow
The following table lists the types of workflows that you can create in Accounts
receivable.
5-48
Chapter 5: Workflow
The following calculated fields and expressions are used with Accounts
receivable workflow journal approvals. For each configuration, you can set up
conditions that include these calculated fields and expressions.
Maximum voucher
debit amount
Maximum voucher
credit amount
Invoice total
Description
Minimum voucher
credit amount
Calculated field
Minimum voucher
debit amount
5-49
Journal type
Allocation
Daily
General journal
Allocation
Elimination
Type
To create General ledger and Fixed asset workflows, follow these steps:
The following workflow types are available for General ledger and Fixed assets.
Each type corresponds to a journal type. You must create at least one workflow
configuration for each journal type that you want to use workflow approvals for.
Elimination
Fixed assets
You can use workflow approvals for the following journals and journal types in
General ledger and Fixed assets.
5-50
Chapter 5: Workflow
The following calculated fields and expressions are used with General ledger and
Fixed asset workflow journal approvals. For each configuration, you can set up
conditions that include these calculated fields and expressions.
The following workflow types are available for Budgeting. After you assign a
workflow to a budget code, all budget register entries using that budget code are
submitted to workflow.
Budget register
entry workflow
Type
Commitments
approval
Description
Calculated Field
5-52
Budget account
entry workflow
Budgeting Workflow
Some organizations require that budget register entries and budget account
entries be approved by a user other than the person who entered them. You can
require manual approval, workflow approval, or no approval. If you use budget
control, you can set up workflows so that a budget manager approves the entries.
You can also set up budget transfer rules to work with Budgeting workflows. For
example, you could set up a budget transfer rule to allow only budget transfers
within departments. After the budget transfer rule is defined, you could create a
workflow to route a budget transfer to a specific user to approve for budget
transfers between departments.
If workflow approval is set up, additional controls are displayed at the top of the
Budget register entry form. These include a yellow information bar and a
Submit button or an Actions menu.
5-51
Chapter 5: Workflow
You can use the workflow system within Microsoft Dynamics AX to set up an
expense report approval and notifications workflow in the Expense management
module. Workflow approvals can be created for expense report submission,
approval, and return. The following process is an example of an expense
management workflow process for an expense report.
1. Create and save an expense report document.
2. Submit the expense report for approval.
a. An approver is found through the defined workflow rules.
b. Approver receives notification of expense report ready for
approval.
c. Approver verifies that no policies are violated or verifies
business justification for any policy violations or exceptions.
d. Approver verifies electronic receipts.
3. Approve expense report.
a. Status of expense report is changed.
b. Expense report is assigned to the Accounts payable coordinator
for posting.
4. Post the expense report.
a. If automatic posting is configured, then the process moves to the
next to last step in this section. If automatic posting is not
configured, the next three processes will need to be completed.
Verify all original receipts are submitted.
Match receipts to the expense report.
Verify tax codes entered on the expense report are correct.
Process the expense report for payment.
Status of expense report is changed.
b.
c.
d.
e.
f.
5-53
Travel
requisition
Expense line
item
Expense line
item auto
posting
Expense report
Expense report
auto posting
Dispute
management
Cash advance
request
Type
1. Open Travel and expense > Setup > Travel and expense
workflows.
2. On the Action Pane, click New.
3. Select the type of workflow you want to create, and then click
Create workflow. The workflow editor is displayed. Design the
workflow by dragging workflow elements onto the canvas.
4. Configure each element of the workflow.
5. Repeat steps 2 through 4 to create additional workflows for Travel
and expense.
VAT tax
recovery
The following workflow types are available for Travel and expense. You must
create at least one workflow configuration for each type you want to use
workflow approvals for.
5-54
Vendor category
application
workflow
Purchase order
workflow
Purchase
requisition
review
Purchase
requisition line
review
Purchase order
line workflow
Unconfirmed
product receipt
rejection
notification
workflow
Type
Vendor category
justification
workflow
Chapter 5: Workflow
When you use purchase requisitions, you must create a workflow for the header
and/or line level that purchase requisitions will flow through. You can create an
approval workflow process or other task related flows by using the workflow
editor.
Vendor add
application
workflow
Invoice received
notification
workflow
Delivery due
date notification
workflow
Catalog import
approval
Catalog import
product
approval
Type
The following workflow types are available for Procurement and sourcing. You
must create at least one workflow configuration for each type you want to use
workflow approvals for.
There are several other workflows available in the Procurement and sourcing
module to help you manage catalog, and vendor requests that are generated from
the Enterprise Portal on the Vendor Portal and the Employee Services pages.
When you use change management for purchase orders, you must also create a
workflow for the header and/or line purchase orders will flow through. You can
optionally create purchase order workflows when change management is not
enabled.
Vendor add
justification
workflow
5-56
Vendor status
workflow
Product receipt
failed
notification
workflow
5-55
Chapter 5: Workflow
To create Procurement and sourcing workflows, follow these steps:
1. Open Procurement and sourcing > Setup > Procurement and
sourcing workflows.
2. On the Action Pane, click New.
3. Select the type of workflow you want to create, and then click
Create workflow. The workflow editor is displayed. Design the
workflow by dragging workflow elements onto the canvas.
4. Configure each element of the workflow.
5. Repeat steps 2 through 4 to create additional workflows for
Procurement and sourcing.
Type
User Workflow
Type
User request
workflow
Review original
budget
When you use project budgeting, you can specify that any project budgets and
revisions made to the original budgets must be approved by someone other than
the person submitting them. You can create an approval workflow process by
using the workflow editor.
Review budget
revision
Inactivate user
request workflow
The following workflow types are available for System administration. You must
create at least one workflow configuration for each type you want to use
workflow approvals for.
5-58
The workflow actions available in the Project budget and Project budget
revision forms change to reflect the status of the workflow.
NOTE: When revisions are made to an approved budget, the workflow status is
reset and the changes must be resubmitted for approval.
Review timesheets
The following workflow types are available for Project management and
accounting. You must create at least one workflow configuration for each type
you want to use workflow approvals for.
Review timesheet
lines
5-57
Chapter 5: Workflow
Organization Workflow
Type
Create a workflow for cases. This workflow type
contains a task for completing cases.
4. Click OK.
1. Open System administration > Setup > System > System service
accounts.
When you have finished installing the AOS and prior to using workflow, you
must specify the workflow execution account. The workflow execution account
is used for running application business logic and accessing Microsoft Dynamics
AX data. To select a domain account to serve as the workflow execution account,
follow these steps:
Case management
workflow
Create a workflow for attaching documents. This
workflow type contains a task for reviewing
document handling fields.
5-60
If your organization uses case management, you can require a case be reviewed
or approved. If your organization uses document handling, you can require that
document attachments be reviewed, routed, or approved. Also, if your
organization uses signing limits, you can require that someone approves the
changes or additions to signing limits before they are activated.
Document handling
The following workflow types are available for Organization administration. You
must create at least one workflow configuration for each type you want to use
workflow approvals for.
Signing limits
workflow
Administration
Set up work item queue groups, work item queues, and work item
queue assignments. (Optional)
Several tasks and set up procedures must be completed before workflow is fully
functional in the system. A list of tasks that must be set up before the workflow
system can be used follows. Some steps are optional and are noted as such.
5-59
Chapter 5: Workflow
Procedure: Run the Workflow Infrastructure Configuration
Wizard
Run the Workflow infrastructure configuration wizard to specify how often
workflow batch jobs should run. If the batch jobs are not set up, notifications will
not be sent. To run the Workflow infrastructure configuration wizard, follow
these steps:
1.
2.
3.
4.
5-61
You must specify an email ID for any functions related to what you want to send
with your email messages. You can use the email ID to create templates in
different languages, so that the email messages sent from Microsoft Dynamics
AX are based on a unique email ID. Then, if this email ID contains templates in
different languages, email messages can be sent out to users in their native
language. The language that is set up for a user in the Language field in the
Options form determines what template is applied when an email message is sent
to that user.
You can use templates to create the layout of messages that are sent by email.
Email messages can be generated from notifications that are configured on a
workflow. The email template provides predefined content for the message, and
the data of the message is provided through the function (workflow notification
set up) that uses the email template.
5-62
Chapter 5: Workflow
NOTE: The default language code for the email ID determines what template to
use if the user has set a language that differs from the language of any available
template.
5-63
a.
b.
c.
d.
You can use one email template for all workflow notifications, or you can use a
different email template for each workflow that you create. For example, if you
have a purchase requisition workflow, you may want to use an email template
that was written specifically for purchase requisitions.
4. Click in the lower pane. Create more lines in the lower pane of the
E-mail templates form to create templates in different languages.
For each template version, enter the following information:
5-64
Chapter 5: Workflow
Complete the following procedure to specify the default email template that will
be used to generate workflow notifications that do not have an associated email
template. For example, if you did not select an email template when you created
the purchase requisition workflow, the default email template will be used.
1. Open Organization administration > Setup > Workflow >
Workflow parameters.
2. Click New.
3. In the Name field, enter a name for the queue group.
4. In the Description field, enter a description to help you identify the
queue group.
1.
2.
3.
4.
To add or remove a queue from the group, complete the following procedure.
5-66
5-65
Chapter 5: Workflow
Procedure: Create a Work Item Queue
When you create a queue, you will automatically be assigned as an administrator
of the queue. Queue administrators can change the status of the queue, assign or
unassign users from the queue, specify the conditions under which this queue is
used, and reassign documents in the queue to other users.
To create a queue, complete the following procedure.
1. Open Organization administration > Setup > Workflow > Work
item queues.
2.
3.
4.
5.
6.
Click New.
In the Name field, enter a name for the queue.
In the Description field, enter a description to help you identify the
queue.
In the Document field, select the type of document that will be sent
to this queue for processing.
In the Status field, select one of the following options:
a. Active: Documents can be sent to the queue for processing.
b. On hold: Documents cannot be sent to the queue for processing.
Use this status when you want to process all of the documents in
the queue before setting the queue's status to Inactive.
c. Inactive: Documents cannot be sent to the queue for processing.
5-67
4. To unassign a user from the queue, select the row for that user. Then
do the following:
a. Click Remove.
b. Confirm that you want to unassign the user from the queue.
5-68
Chapter 5: Workflow
3. Expand the General tab.
4. In the Status field, select one of the following options:
a. Active: Documents can be sent to the queue for processing.
b. On hold: Documents cannot be sent to the queue for processing.
Use this status when you want to process all of the documents in
the queue before setting the queue's status to Inactive.
c. Inactive: Documents cannot be sent to the queue for processing.
Total amount
> 10,000
USD.
You can use the following assignment rules for purchase requisition queues.
Vendor =
Contoso, Ltd.
Conditions the
rule applies to
Total amount
> 10,000
USD.
Assignmen
t rule
Vendor =
Adventure
Works
Evaluation
order
Vendor =
Contoso, Ltd.
Rule A
Rule C
Rule B
Rule D
Vendor =
Adventure
Works
To better understand how these assignment rules are used, assume an employee
has submitted a purchase requisition totaling 15,000 USD for Adventure Works.
In this scenario:
5-69
3. Select a type of document from the Document list. This indicates the
rule you are about to create will apply to a queue that is configured
for the selected type of document.
4. Click New to create a new assignment rule.
Now suppose an employee submitted a purchase requisition totaling 100 USD for
Contoso, Ltd. In this scenario:
5-70
Chapter 5: Workflow
5. In the Create a new work item assignment rule form that appears,
do the following:
a. In the Name field, enter a name for the assignment rule.
b. In the Description field, enter a brief description to help you
identify the rule.
c. In the Queue name field, select a queue. Documents that meet
the specified conditions of the rule will be sent to this queue.
d. Click Create rule to create the rule.
6. To specify the conditions under which this rule applies, do the
following:
a. Select the rule in the left pane of the form.
b. Expand the Conditions tab, and click Add condition.
c. Enter a condition.
d. Enter additional conditions, if necessary.
7. To specify when this rule is evaluated, select the Move up or Move
down buttons.
5-71
Open the Work item queue form and verify the purchase requisition
is waiting for review.
Select item number 1003, and then save and submit the purchase
requisition.
Modify the Assign-to property to use the work item queue created in
step 1.
Use the information that is provided to create a work item queue and modify the
Automatic purchase requisition approval workflow to use the new work item
queue. When you are finished, create and submit a purchase requisition and
verify that the purchase requisition appears in the new work item queue.
Challenge Yourself!
Alicia and Lisa are valid Microsoft Dynamics AX users who are authorized to
take workflow actions on requisitions and can view, and update requisitions.
Inga has privileges to create, update queues and to take workflow actions on
requisitions and also to view, update and create requisitions in user-defined legal
entities.
Inga, the Purchasing Manager, wants to set up a work item queue that will
contain tasks for non-catalog requisitions submitted. Ingas team is responsible
for realizing better cost savings and enforces compliance with corporate quality
standards.
Scenario
This lab demonstrates how to create a work item queue, open the workflow
editor, and how to modify a workflow to use the work item queue.
5-72
Chapter 5: Workflow
Step by Step: Create a Work Item Queue
To create a work item queue, follow these steps.
1. Select Organizational administration > Setup > Workflow >
Work item queues to open the Work item queue set up form.
2. Click New and enter Requisition review queue into the Name field.
3. Select Purchase requisition as the Document type.
4. Expand the User Fast Tab.
5. Click the Add button to add more users to the Requisition review
queue.
6. Set the status of the queue to Active.
7. Close the Work item queue form.
8. Open Procurement and sourcing > Setup > Procurement and
sourcing workflows.
9. Select the Automatic purchase requisition approval workflow.
10. Click Edit to update the workflow.
11. Right-click the Purchase requisition review 1 task and select
Properties.
12. Click Assignment on the left pane and select Queue as the
Assignment type for this workflow.
13. Click the Queue based tab and select Work item queues in the
Queue type field.
14. Select Requisition review queue as the Queue name.
NOTE: In the Hyper-V image click Automatic actions, then deselect Enable
automatic actions.
15. Click Close to close the Properties window.
16. Click Save and close to close the workflow editor.
17. Enter a Version note such as "Changed to use a queue" and click
OK.
18. On the Activate workflow dialog, select Activate the new version
and then click OK.
19. Click Set as default.
5-73
9. Open the Work item queue form for purchasing by clicking the
Procurement and sourcing > Common > Purchase requisitions >
Purchase requisitions assigned to my queues menu item.
10. Review the Work item queue.
NOTE: The workflow batch jobs run periodically so it may take a minute or two
before the purchase requisition is available in the Purchase requisition assigned
to my queues menu item.
NOTE: The workflow batch jobs must be running for workflows to move between
job steps. Run the Workflow infrastructure configuration form to setup these
jobs. System administration > Setup > Workflow > Workflow infrastructure
configuration
5-74
Chapter 5: Workflow
You can view workflow history and the status of an active or completed
workflow and its elements that includes data about new workflow features. These
features include: advanced flow-controls, automated tasks, line item approvals,
and work item queues. You can view this data in the Microsoft Dynamics AX
client or the Enterprise Portal for Microsoft Dynamics AX.
After Alicia speaks with Annie's manager, she learns that Annie is no longer with
the company and April, the Accounts Payable Coordinator, is temporarily taking
over Annie's tasks. So, Alicia uses the Reassign button on the View workflow
history form to assign the workflow to April.
Alicia, the Purchasing Agent, would like to research the status of an important
Purchase Requisition that has not been moving through the workflow process.
She opens the View workflow history form and filters for the purchase
requisition ID. She notices that the workflow has been assigned to Annie, the
Bookkeeper, for several weeks without any action.
5-76
5-75
Summary
Chapter 5: Workflow
( ) Organization model
( ) Security
Flow-control elements
Line-item elements
Approval process
Tasks
( ) How much time is spent to perform the business tasks that comprise
the workflow.
( ) 64-bit support.
( ) Multi-threading.
4. What are the advantages of moving workflow from the IIS to the AOS?
(Select all that apply)
( ) Performance
( ) Workflow history
_____ 1. Advanced
flow controls
_____ 2. Line level
workflow
_____ 3. Work item
queue
_____ 4. AOS hosting
_____ 5. Graphical
workflow editor
( ) Relational database
( ) Financial dimension
5-78
There are several different types of workflow elements that can be added to a
workflow. Each type element requires different properties to be specified. The
workflow elements include:
5-77
Chapter 5: Workflow
Take a moment and write down three key points you have learned from this
chapter
1.
2.
3.
5-79
() How much time is spent to perform the business tasks that comprise
the workflow.
( ) 64-bit support.
( ) Multi-threading.
4. What are the advantages of moving workflow from the IIS to the AOS?
(Select all that apply)
( ) Performance
() Workflow history
e 1. Advanced flow
controls
c 2. Line level
workflow
b 3. Work item
queue
d 4. AOS hosting
a 5. Graphical
workflow editor
() Relational database
() Security
() Organization model
() Financial dimension
Solutions
5-80