QualityOne Vaults allow you to manage structured teams of individual users responsible for completing specific processes within your Vault. Using Teams helps to manage change controls, audits, corrective and preventative actions, and other quality event-related processes.
When you create a new record from an object or object type that has a Team configured, you can assign users to specific Team Roles defined by that record’s Team. For example, you might assign someone as a “Lead Auditor” or an “Approver” on an Audit record. Hover over a role label to display additional information, if available.
Depending on your Admin’s configuration, object, field, and section labels may appear differently than the labels mentioned in this article.
About Constraining Roles
Your Admin can configure each team role to constrain which team members are available for selection, ensuring you assign the appropriate team member for the job using custom or matching sharing rules.
Assigning Users to a Team
You can assign users to team roles on object records where there is a configured Team. For example, when an Audit record is created, you can pair your Audit Team to the Audit record by assigning users to that Audit Team.
You can add, remove, or change members on a Team as long as those role memberships are not constrained. Depending on the team’s configuration, a role’s membership may also be exclusive, meaning that a user in that role cannot be assigned to another role on the same object record.
Vault maps these team roles to sharing settings roles. Depending on your Admin’s configuration, membership to a team role can also grant users team role membership to related records in the process. For example, when an Audit record is created, Vault could attempt to default the same team members for the new Audit record.
To assign users to Team Roles:
- Navigate to an object record with a configured Team.
- In the Team section, click Manage Team.
- Assign users to their designated team roles on the record’s details page.
- Click Save.
Depending on your Admin’s configuration, your assigned team members may change on related records that inherit Team Role configurations from a source record.
Restoring Inherited Team Members
If you’ve added, removed, or changed members of an inherited Team Role on a related record, you can attempt to restore the inherited team members by clicking Restore and then saving the Team changes. For example, after adding or removing team members in the “Approver” role, you can click Restore to replace them with the current “Approver” team members inherited from the audit.
Note: If clicking Restore triggers an error message and Vault does not complete the action, it may be that a member that should be inherited is invalid for role membership on that record.
Completing Teams
When you finish assigning all team members to their appropriate roles, your team assignment is complete. Depending on your Admin’s configuration, Vault can move the record into a defined state.
If your Vault uses Auto-Start Object Workflows, completing a team can begin the workflow for the specified process and assign relevant tasks to your Team members.
About Invalid Team Members
If you have permission to edit the team, Vault indicates when you have invalid team members on a Team. You must take corrective action on invalid team members before changing any team assignments on this record, or moving it into a state to apply the Verify Team Validity For All Roles entry criteria.
A team is invalid when:
- A user assigned to a team role has been made Inactive.
- A user assigned to an exclusive team role is also assigned to another role. This can occur if your Admin configures a role as “exclusive” after that user has been assigned to multiple roles on the same record.
- The users are in the Team members list but not in the linked constraining sharing settings role. For example, if your Vault uses sharing or matching rules to populate your constraining lifecycle role, one (1) of the fields that defines the membership of that role changes even if the team role has been assigned.
- The users are in the linked lifecycle role but not in the Team members list. This may happen if your Vault is configured to allow the assignment of workflow participants to populate directly into sharing settings roles. Contact your Admin for assistance.
- Your Admin has attempted to configure any type of sharing or matching rule on your team role’s linked sharing settings role. Contact your Admin for assistance.
- A team role does not meet the minimum required number of assignments.
Note: Vault does not support Team roles linked to sharing settings roles that use rule-based groups (Dynamic Access Control and custom and matching sharing rules).
Managing Invalid Team Members
If you have the appropriate permission to edit the team, you can take corrective action on invalid team members by clicking Manage Team to open the Manage Invalid Team Members dialog.
You can select the following actions to execute for each Team Role assignment listed in the dialog:
- Replace With: Select this action if an assignment is invalid because the User is Inactive, the role has been configured to be exclusive, or the user’s role assignment conflicts with a constraining role choice in the Team role definition. Ensure that you pick another user in the replacement selection. If there are no eligible users to replace the invalid team member, consider choosing the Remove action. Reassignment in this manner preserves any open tasks assigned to this invalid team member and reassigns those same tasks to the new replacement team member.
- Remove: Select this action if the team member is invalid and there are no eligible users to replace the invalid team member. Any open tasks assigned to this invalid team member will also be removed.
Note: Depending on your Admin’s configuration, any changes made to role assignments from this dialog will cascade to any related records that inherit their team role configurations from this record.
Removing Users from a Team Role
When you remove a user from a Team Role, Vault also removes the user from the team role’s linked sharing settings role. If the user has multiple relevant roles within the participant group, Vault won’t remove the user from the participant group until you remove the user from all relevant Team memberships. Depending on your Admin’s configuration, removing the user from the team role will cascade to any related records that inherit their team role configurations from this record.
To remove users, navigate to the Teams section and click Manage Team. Click the X beside the user you need to remove.
Task Cancellation
When you remove a user from a Team Role and the user has a task assigned for that role, Vault cancels the task because the user no longer has the correct access.
If you replace a user with another user during the same edit of the team’s membership, the new user will receive the task assigned to the Team Role before the workflow can continue.
Reporting on Teams
You can report on your teams and team members to easily assess scope and efficiency. To do so, create a report with an Application Role report type.