Edit an approval process
If you are an ÃÛ¶¹ÊÓƵ Workfront administrator, or you have administrative access to approval processes, you can see and edit all approval processes in the system.
If you are a group administrator, you can see and edit the approval processes associated with the group or groups you manage.
For information about creating approval processes, see Create an approval process for work items.
- When you edit a global approval process that is already in use, your changes affect all objects throughout the system that are already associated with it.
- If you add a new approver to the current stage on an approval process that has already started on an object, the process for that object resets and the approvers have to start over.
- Add a stage beyond the current stage
- Add an additional approver before the current stage
Access requirements
You must have the following:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
---|---|
ÃÛ¶¹ÊÓƵ Workfront plan* | Any |
ÃÛ¶¹ÊÓƵ Workfront license* | Plan |
Access level configurations* |
Administrative access to Approval Processes if you are not a System Administrator NOTE: If you still don't have access, ask your Workfront administrator if they set additional restrictions in your access level. For information on how a Workfront administrator can modify your access level, see Create or modify custom access levels. |
*To find out what plan, license type, or access you have, contact your Workfront administrator.
Edit an existing approval process
-
Click the Main Menu icon in the upper-right corner of ÃÛ¶¹ÊÓƵ Workfront, or (if available), click the Main Menu icon in the upper-left corner, then click Setup .
-
(Conditional) If you are editing a system-level approval process, click Processes > Approvals in the left panel.
Or
If you are editing a group-level approval process, do the following:
- In the left panel, click Groups .
- Click the name of the group for which you want to list or manage group approval processes.
- In the left panel, click Approvals. You might need to click Show More first.
-
Click the Project Approvals, Task Approvals, or Issue Approvals tab, depending on the type of approval process you want to edit.
-
Select the approval process you want to edit, then click Edit at the top of the list. The Edit approval process box displays.
-
Specify the following information in the box that displays:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Approval process name Type a descriptive name for the approval process. Users see this name when applying the approval process to an object, as described in Associate a new or existing approval process with work. Description Type a description of the approval process. This displays in the Approvals section in the Setup area next to the name of the approval process. Is Active Keep this option enabled if you want other users to be able to attach the approval process to projects, tasks, and issues that they create.
This option is enabled by default.
Tip: Marking an approval process as inactive is useful when your organization no longer needs to use it, but you want to preserve historical information about its use.
This approval process can be used by If you want the approval process available for projects, tasks, issues, and templates belonging only to a particular group, start typing the name of the group, then select the name when it appears:
- If you are a system administrator or you have administrative access to approval processes, you can see any group in the system when you type its name. All groups is selected by default.
- If you are a group administrator without administrative access to approval processes, you can assign the approval process to any group you manage when you type its name. The All Groups option is not available.
This option is not available for single-use approval processes.
WARNING: When you make changes to the group-specific approval process, the existing approval processes that have already been associated with work items might change. For information about these changes, see How group and approval process changes affect assigned approval processes.
For information about listing and managing your group's approval processes from your group's page, see Group-level approval processes.
For information about administrative access to approval processes, see Grant users administrative access to certain areas.
-
Configure a path for the approval process using the following options.
A path is where you specify what needs to happen in the approval process. You create stages in a path to indicate who needs to do the approval work and in what order.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Start approval process when the status is set to Select the status that will trigger the approval process on work items. When someone updates a work item to this status, its approval process begins.
The same status cannot be selected for multiple approval process paths.
The statuses available are based on what is selected under the option This approval can be used by (explained in the table above):
-
If All groups is selected, only system-wide locked statuses are available.
-
If a specific group is selected, only the statuses available for that group are available
For information about how approval process work with statuses, see the section How approval processes rely on statuses in the article Approval process overview.
Stage Name (Optional) Type a name describing the first stage of the path. If you do not specify a stage name, the default name is Stage 1. Approvers Begin typing the name of the user, team, or job role that you want to designate as an approver for this stage, then click the name when it appears in the drop-down list. You can add only active users, job roles, and teams.
TIP:
When adding a user as an approver, notice the avatar, the user's Primary Role, or their email address to distinguish between users with identical names. Users must be associated with at least one job role to view it as you add them.
You must have the View Contact Info setting enabled in your access level for Users to view users' emails. For information, see Grant access to users
.
NOTE:
Adding a user, team, or role as an approver does not automatically give them permissions to the object associated with that approval. They receive permissions to the object when the approval step is triggered. Otherwise, the objects must be shared with them before they can make an approval decision.
You can also designate an individual as an approver by specifying the individual's role. For example, you can assign a Project Owner, Project Sponsor, Portfolio Owner, Program Owner, or Manager as an approver. These options automatically appear when you begin typing.
IMPORTANT:
-
When you assign an approval to the Project Sponsor and no one is designated as the sponsor of a project, the approval is reassigned to the Project Owner. If no one is designated as the owner of the project, the approval is assigned to the Workfront administrator.
-
When you assign an approval to a role and the option Approver not required to be on the project team is disabled, but no roles in the project team match the role on the approval, the approval is reassigned to the Project Owner. For information about approval settings, see Configure global approval settings.
-
When you assign an approval to the Project Owner and no one is designated as the owner of a project, the approval is reassigned to the main Workfront administrator as indicated in the Customer Info section in the Setup area. For information, see Configure basic information for your system.
-
When you assign job roles as approvers, all users associated with that job role that are also on the project team can make a decision on the approval.
When you assign a team as an approver, any user in that team can make a decision on the approval.
For more information about the project team, see Project Team overview. For more information about approving work, see Approving work.
Only one decision is required (Displays only if you add multiple approvers to the stage) Select this option if any one of the approvers on the stage can approve or reject the work item during this stage. This action allows the work item to leave the stage.
When this option is not selected, all of the identified approvers must approve or reject the stage (in any order) before the item leaves the stage. If any one of the approvers rejects the stage, the process interrupts and starts over so that the required changes can be made. Then the approvers can approve or reject the stage once again.
When a team is designated as an approver, any member of the team can grant or reject a stage.
Add stage (Optional) Add another a stage to the path, using the options explained in the three rows above. You can add as many stages to the path as you need. Choose what happens when the approval is rejected Select the action you want to take if the work item is rejected at any stage of the path:
-
Create an Issue: (Available only for project and task approval processes) An issue is created in the project or task where the approval process is running. The default assigned resource on the task, or the owner of the project is assigned to the issue. By default, the name of the issue created is Approval Rejected (Project or Task Name). This is a Rejection Issue, entered under the task or the project, depending on the approval process where the rejection happened.
-
Set Status to: Choose one of the following:
-
Previous Status: The rejected project, task, or issue reverts to the status prior to the status that activates the approval process.
-
Any other status in the list: The rejected object moves to the status you choose, such as On Hold. You can choose one of the default statuses or a custom statuses you added to your Workfront system.
If you select a status associated with an approval process as the rejection status for an approval path, the rejected object moves to the selected status, and it will be marked as "Pending approval".
For example, if you select On Hold for the rejection status and the On Hold status is associated with an approval process, the rejected object is placed in the status of "On Hold- Pending approval", requiring the approval.
For a system-wide approval process, only system-wide statuses are available.
For a group-specific approval process, all group statuses are available. This includes any custom statuses that the group administrator created specifically for the group, as well as any system-wide statuses.
For information about how approval process work with statuses, see the section How approval processes rely on statuses in the article Approval process overview.
-
-
-
(Optional) Click Add path to add another path to the approval process, referring to the list of options in the previous step.
The new path must be associated with another status. The path triggers when the item is updated to show this status. You cannot have two paths for the same status.
-
Click Save.
-
(Optional) Do any of the following:
- Associate the approval process with specific projects, tasks, or issues throughout your system, as described in Associate a new or existing approval process with work.
- Outside of Workfront, notify users that the approval process is available for them to associate with their projects, tasks, or issues, as described in Associate a new or existing approval process with work.
- Create another approval process that is triggered if this approval process is rejected and the item takes on another status. This gives you a way to link approval processes together.