Configure manual decisions in a workflow
This article explains how to configure the properties of a manual decision.
To configure a manual decision in the workflow editor, right-click the manual decision, and then click Properties to open the Properties page. Then use the following procedures to configure the properties of the manual decision.
Name the decision
Follow these steps to enter a name for the manual decision.
- In the left pane, click Basic Settings.
- In the Name field, enter a unique name for the manual decision.
Enter a subject line and instructions
You must provide a subject line and instructions to users who are assigned to the manual decision. For example, if you're configuring a decision for purchase requisitions, the user who is assigned to the decision sees the subject line and instructions on the Purchase requisitions page. The subject line appears in a message bar on the page. The user can then click the icon in the message bar to view the instructions. Follow these steps to enter a subject line and instructions.
In the left pane, click Basic Settings.
On the Instructions tab, in the Work item subject field, enter the subject line.
To personalize the subject line, you can insert placeholders. Placeholders are replaced with appropriate data when the subject line is shown to users. Follow these steps to insert a placeholder:
- In the text box, click where the placeholder should appear.
- Click Insert placeholder.
- In the list that appears, select the placeholder to insert.
- Click Insert.
To add translations of the subject line, follow these steps:
- Click Translations.
- On the page that appears, click Add.
- In the list that appears, select the language that you're entering the text in.
- In the Translated text field, enter the text.
- To personalize the text, you can insert placeholders as described in step 3.
- Click Close.
In the Work item instructions field, enter the instructions.
To personalize the instructions, you can insert placeholders. Placeholders are replaced with appropriate data when the instructions are shown to users. Follow these steps to insert a placeholder:
- In the text box, click where the placeholder should appear.
- Click Insert placeholder.
- In the list that appears, select the placeholder to insert.
- Click Insert.
To add translations of the instructions, follow these steps:
- Click Translations.
- On the page that appears, click Add.
- In the list that appears, select the language that you're entering the text in.
- In the Translated text field, enter the text.
- To personalize the text, you can insert placeholders as described in step 6.
- Click Close.
Specify the possible outcomes of a decision
Typically, when a document is assigned to a decision maker, the decision maker is asked a question. The answer to this question is usually Yes or No, or True or False. Follow these steps to specify the possible outcomes of the manual decision.
In the left pane, click Basic Settings.
On the Outcomes tab, in the Outcome 1 field, enter the name of the outcome, or the option.
To add translations of the outcome, follow these steps:
- Click Translations.
- On the page that appears, click Add.
- In the list that appears, select the language that you're entering the text in.
- In the Translated text field, enter the text.
- Click Close.
In the Outcome 2 field, enter the name of the outcome, or the option.
To add translations of the outcome, follow these steps:
- Click Translations.
- On the page that appears, click Add.
- In the list that appears, select the language that you're entering the text in.
- In the Translated text field, enter the text.
- Click Close.
Specify when notifications are sent
You can send notifications to people when a decision has been made, delegated, or escalated. Follow these steps to specify when notifications are sent, and who the notifications are sent to.
In the left pane, click Notifications.
Select the check box next to the events that notifications should be sent for:
- [Choice 1] – The assigned user has selected [Choice 1].
- [Choice 2] – The assigned user has selected [Choice 2].
- Delegate – The assigned user has assigned the decision to another user.
- Escalate – The assigned user hasn't made the decision in the allotted time.
Select the row for an event that you selected in step 2.
On the Notification text tab, in the text box, enter the text of the notification.
To personalize the notification, you can insert placeholders. Placeholders are replaced with appropriate data when the notification is show to users. Follow these steps to insert a placeholder:
- In the text box, click where the placeholder should appear.
- Click Insert placeholder.
- In the list that appears, select the placeholder to insert.
- Click Insert.
To add translations of the notification, follow these steps:
- Click Translations.
- On the page that appears, click Add.
- In the list that appears, select the language that you're entering the text in.
- In the Translated text field, enter the text.
- To personalize the text, you can insert placeholders as described in step 5.
- Click Close.
On the Recipient tab, specify who the notifications are sent to. Select one of the options in the following table, and then follow the additional steps for that option before you go to step 8.
Option Notification recipients Additional steps Participant Users who are assigned to a specific group or role - After you select Participant, on the Role based tab, in the Type of participant list, select the type of group or role to send notifications to.
- In the Participant list, select the group or to send notifications to.
Workflow user Users in the current workflow - After you select Workflow user, on the Workflow user tab, in the Workflow user list, select a user who participates in the workflow.
User Specific users - After you select User, click the User tab.
- The Available users list includes all users. Select the users to send notifications to, and then move those users to the Selected users list.
Repeat steps 3 through 7 for each event that you selected in step 2.
Assign a decision
Follow these steps to specify who a manual decision should be assigned to.
In the left pane, click Assignment.
On the Assignment type tab, select one of the options in the following table, and then follow the additional steps for that option before you go to step 3.
Option Users that the decision is assigned to Additional steps Participant Users who are assigned to a specific group or role - After you select Participant, on the Role based tab, in the Type of participant list, select the type of group or role to assign the decision to.
- In the Participant list, select the group or role to assign the decision to.
Hierarchy Users in a specific organizational hierarchy - After you select Hierarchy, on the Hierarchy selection tab, in the Hierarchy type list, select the type of hierarchy to assign the decision to.
- The system must retrieve a range of user names from the hierarchy. These names represent users that the decision can be assigned to. Follow these steps to specify the starting point and ending point of the range of user names that the system retrieves:
- To specify the starting point, select a person in the Start from list.
- To specify the ending point, click Add condition. Then enter a condition that determines where in the hierarchy the system stops retrieving names.
- On the Hierarchy options tab, specify which users in the range the decision should be assigned to:
- Assign to all users retrieved – The decision is assigned to all users in the range.
- Assign only to last user retrieved – The decision is assigned to only the last user in the range.
- Exclude users with the following condition – The decision isn't assigned to any users in the range who meet a specific condition. Click Add condition to specify the condition.
Workflow user Users in the current workflow - After you select Workflow user, on the Workflow user tab, in the Workflow user list, select a user who participates in the workflow.
User Specific users - After you select User, click the User tab.
- The Available users list includes all users. Select the users to assign the decision to, and then move those users to the Selected users list.
On the Time limit tab, in the Duration field, specify how much time the user has to make the decision. Select one of the following options:
- Hours – Enter the number of hours that the user has to make the decision. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Days – Enter the number of days that the user has to make the decision. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Weeks – Enter the number of weeks that the user has to make the decision.
- Months – Select the day and week that the user must make the decision by. For example, you might want the user to make the decision by Friday of the third week of the month.
- Years – Select the day, week, and month that the user must make the decision by. For example, you might want the user to make the decision by Friday of the third week of December.
If the user doesn't make the decision in the allotted time, the decision is overdue. A decision that is overdue is escalated, based on the options that you select in the Escalation area of the page.
Specify what happens when a decision is overdue
If a user doesn't make the decision in the allotted time, the decision is overdue. A decision that is overdue can be escalated, or automatically assigned to another user. Follow these steps to escalate the decision if it's overdue.
In the left pane, click Escalation.
Select the Use escalation path check box to create an escalation path. The system automatically assigns the decision to the users who are listed in the escalation path. For example, the following table represents an escalation path.
Sequence Escalation path 1 Assign to: Donna 2 Assign to: Erin 3 Final action: [Choice 1] In this example, the system assigns the overdue decision to Donna. If Donna doesn't make the decision in the allotted time, the system assigns the decision to Erin. If Erin doesn't make the decision in the allotted time, the system selects [Choice 1] as the decision.
To add a user to the escalation path, click Add escalation. Select one of the options in the following table, and then follow the additional steps for that option before you go to step 4.
Option Users that the decision is escalated to Additional steps Hierarchy Users in a specific organizational hierarchy - After you select Hierarchy, on the Hierarchy selection tab, in the Hierarchy type list, select the type of hierarchy to escalate the decision to.
- The system must retrieve a range of user names from the hierarchy. These names represent users that the decision can be escalated to. Follow these steps to specify the starting point and ending point of the range of user names that the system retrieves:
- To specify the starting point, select a person in the Start from list.
- To specify the ending point, click Add condition. Then enter a condition that determines where in the hierarchy the system stops retrieving names.
- On the Hierarchy options tab, specify which users in the range the decision should be escalated to:
- Assign to all users retrieved – The decision is escalated to all users in the range.
- Assign only to last user retrieved – The decision is escalated to only the last user in the range.
- Exclude users with the following condition: – The decision isn't escalated to any users in the range who meet a specific condition. Click Add condition to specify the condition.
Workflow user Users in the current workflow - After you select Workflow user, on the Workflow user tab, in the Workflow user list, select a user who participates in the workflow.
User Specific users - After you select User, click the User tab.
- The Available users list includes all users. Select the users to escalate the decision to, and then move those users to the Selected users list.
On the Time limit tab, in the Duration field, specify how much time the user has to make the decision. Select one of the following options:
- Hours – Enter the number of hours that the user has to make the decision. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Days – Enter the number of days that the user has to make the decision. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Weeks – Enter the number of weeks that the user has to make the decision.
- Months – Select the day and week that the user must make the decision by. For example, you might want the user to make the decision by Friday of the third week of the month.
- Years – Select the day, week, and month that the user must make the decision by. For example, you might want the user to make the decision by Friday of the third week of December.
Repeat steps 3 through 4 for each user that should be added to the escalation path. You can change the order of the users.
If the users in the escalation path don't make the decision in the allotted time, the system makes the decision. To specify the option that the system selects, select the Action row, and then, on the End action tab, select an option.
Set a time limit
Follow these steps if the decision must be made in a specific time.
Note
The options that you select in this procedure override the options that you selected in the Assignment and Escalation areas of the page.
In the left pane, click Advanced settings.
Select the Set a time limit for the workflow element check box.
In the Duration field, specify when the decision must be made. Select one of the following options:
- Hours – Enter the number of hours. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Days – Enter the number of days. Then select the calendar that your organization uses, and enter information about your organization's work week.
- Weeks – Enter the number of weeks.
- Months – Select the day and week that the decision must be made by. For example, you might want the decision to be made by Friday of the third week of the month.
- Years – Select the day, week, and month that the decision must be made by. For example, you might want the decision to be made by Friday of the third week of December.
If the time limit is exceeded, the system makes the decision. In the Action list, select the option that the system should select.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for