**Source URL:** https://quality.veevavault.help/en/lr/52842/index.md

# Working with Quality Teams (QMS)

With Quality Teams, you can manage structured teams of individual users that are responsible for completing specific processes within your Vault. This is helpful when managing change controls, audits, CAPAs, and other quality event related processes.

See [Configuring Quality Teams](/en/lr/54508/) for help creating Quality Teams and Quality Team Roles.

When you create a new record from an object or object type that has a _Quality Team_ configured, you can assign users to specific _Quality Team Roles_ defined by that record's _Quality Team_. For example, you might assign someone as a "Change Manager" or a "Subject Matter Expert" on a _Change Control_ record. Hover over a role label to display additional information, if available.

## About Constraining Roles {#constraining-roles}

Admins 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](/en/lr/33946/).

## Assigning Users to a Quality Team {#assigning-users}

You can assign users to team roles on object records for which there is a configured _Quality Team_. For example, you may create a new _Change Control_ record that is paired with your _Change Control Team_, then assign users to that _Change Control Team_.

You can add, remove, or change members on a _Quality Team_ as long as those role memberships are not [constrained][1]. 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. If configured, you may not be able to manage assignments for a _Quality Team_ or some team roles when a record is in certain [locked lifecycle states](/en/lr/54508/#about-locked-states). If a team role with exclusive membership is in a locked state, membership exclusivity for that role may not be respected when updating other team role assignments within the same _Quality Team_. You can also manage _Quality Team_ assignments through the use of [bulk operations][4].

Vault maps these team roles to sharing settings roles. If configured, membership to a team role can also grant users team role membership to related records in the process. For example, in your configuration, when users create a change action from a change control, Vault could attempt to default the same team members from the change control to the change action.

To assign users to _Quality Team Roles_:

1. Navigate to an object record via a custom tab or **Business Admin**. Note that you can only assign users to team roles on object records with a configured _Quality Team_.
2. In the _Quality Team_ section, click **Manage Team**. Note that this section may be labeled differently in your Vault.
3. Assign users to their designated team roles on the record's details page. Click in the **Team Member** field to enter a name and select a matching selection from the filtered drop-down, or click the binoculars icon to perform an advanced user search using additional filtering criteria. Quality Team role restrictions are applied in the dialog.
4. Click **Save**.

Depending on your configuration, team member changes may be reflected on related records you create for this _Quality Event_.

## Restoring Inherited Team Members {#restoring-inherited-team-members}

If you've added, removed, or changed members of an inherited _Quality Team Role_ on a related record, you can attempt to restore the inherited team members by clicking **Restore** and then saving the _Quality Team_.

For example, after creating a change action from a change control and adding or removing team members in the "Subject Matter Expert" role, you can click **Restore** to replace them with the current "Subject Matter Expert" team members as inherited from the change control.

<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: If you click <strong>Restore</strong> and a member which would be inherited is invalid for role membership on that record, Vault alerts you and does not complete the action.</p>
    </div>
  </div>
</div>



## Completing Teams

When you finish assigning all team members to their appropriate roles, your team is complete and Vault can move the record into a state defined by your Admin depending on your configuration.

If your Vault uses [Auto-Start Object Workflows](/en/lr/52892/), completing a team can begin the workflow for the specified process and assign relevant tasks to your _Quality Team_ members.

### About Invalid Team Members {#invalid-team-members}

If you have [permission][2] to edit the team, Vault indicates when you have invalid team members on a team. Before changing any team assignments on this record, or moving it into a state applying the _Verify Quality Team Validity For All Roles_ entry criteria, you must take corrective action on invalid team members. A team may be invalid because:

  * 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 an Admin configures a role as exclusive after users have already been assigned to both the now-exclusive role and another role on the object record.
  * They are in the _Quality Team_ members list but not in the linked constraining sharing settings role. For example, this may happen if your Vault uses sharing or matching rules to populate your constraining lifecycle role and, after team role assignment, one of the fields that defines the membership of that role changes.
  * They are in the linked lifecycle role but not in the _Quality Team_ members list. For example, this may happen if your Vault allows the assignment of workflow participants directly into sharing settings roles. This is against best practices and, if used to populate members of a _Quality Team_ role's linked sharing settings role, results in an invalid team assignment.
  * Your Admin has attempted to configure any type of sharing or matching rule on your team role's linked sharing settings role.
  * A team role does not have at least the minimum required number of assignments.




<div class="note-border alert-info">
  <div class="alert alert-info" role="alert">
    <div><i class="far fa-info-circle"></i></div>
    <div class="alert-text">
      <p><strong>Note</strong>: Vault does not support <em>Quality Team</em> roles linked to Sharing Settings roles that use rule based groups (<a href="/en/lr/33946/">Dynamic Access Control</a> and <a href="/en/lr/25494/">custom</a> and <a href="/en/lr/36122/">matching</a> sharing rules).</p>
    </div>
  </div>
</div>



### Managing Invalid Team Members

If you have the correct permission to edit the team, you can take corrective action on invalid team members by clicking **Manage Team**. This opens the _Manage Invalid Team Members_ dialog, which allows you to remove invalid team members from the record or replace them with valid selections. Select an option for each team role assignment listed in the dialog:

  * **Replace With**: This option appears if an assignment is invalid because the _User_ is _Inactive_, the role is [exclusive][3], or because their assignment in the role conflicts with a constraining role choice in the _Quality Team_ role definition. Note that you cannot leave the replacement selection blank. If no users are eligible to replace the invalid team member, you can remove the assignment. Reassignment in this manner preserves any open tasks assigned to the invalid user because of their membership to the role. The user they are replaced with will be assigned the task. If you have a large number of users to select from, you can click the binoculars icon to perform an advanced user search to select the replacement user.
  * **Remove**: This option appears if the team member is invalid.

Changes made to role assignments in this way are passed down to any records that [inherit](/en/lr/54508/#about-inherit-behavior) their team role configurations from this record.

## Removing Users from a Quality Team Role {#removing-users-from-a-quality-team-role}

When you remove a user from a _Quality 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 her from the participant group until you remove her from all relevant _Quality Team_ memberships. You can also use a [bulk operation][4] to remove a single user from multiple _Quality Teams_.

If configured, any removal of the user from the team role is passed down to any records that [inherit](/en/lr/54508/#about-inherit-behavior) their team role configurations from this record.

### Task Cancelation

When you remove a user from a _Quality 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 _Quality Team Role_ before the workflow can continue.

## Managing Quality Team Assignments in Bulk {#bulk-management}

If you have permissions to add, remove, and replace _Quality Team_ members, you can also perform these operations in bulk from the _Quality Teams Management_ tab. An Admin must activate this tab and add it to an existing [tab collection](/en/lr/542174/).

When managing _Quality Team_ assignments via the _Quality Teams Management_ tab, Vault does not enforce [minimum required users](/en/lr/54508/#min-users) and [maximum users](/en/lr/54508/#max-users) for role membership.

### Adding Users to Quality Teams

To add one or more users to multiple _Quality Teams_:

  1. Navigate to the **Quality Teams Management** tab.
  2. Select **Add User** from the drop-down.
  3. Select an **Object** from the drop-down and select an **Object Type** if applicable. Click **Apply** to retrieve records or **Clear** to clear your previous selections.
  4. Select up to 250 records on which to add the selected user(s). You can filter by record name, lifecycle state, title, or description. Vault only displays team-enabled records of the specified object and object type that are not in [locked states](/en/lr/54508/#locked-states). Click **Continue**.
  5. Add one or more users to the desired roles. The drop-down list does not exclude ineligible users, however, selecting invalid users may result in failures.
  6. Confirm the potential updates to the records listed in the _Summary_, then click **Confirm**. Vault adds the specified user(s) to the specified _Quality Teams_ and notifies the administrator once the operation is complete. You can download a CSV file of the results from the _Notifications_ page.

### Removing a User from Quality Teams

To remove a single user from multiple _Quality Teams_:

  1. Navigate to the **Quality Teams Management** tab.
  2. Select **Remove User** from the drop-down.
  3. Select a user to remove from _Quality Teams_.
  4. Select an **Object** from the drop-down and select an **Object Type** if applicable. Click **Apply** to retrieve records or **Clear** to clear your previous selections.
  5. Select up to 250 records on which to remove the selected user. You can filter by record name, lifecycle state, or application role. Vault only displays team-enabled records that have a role assigned to the selected user and are not in [locked states](/en/lr/54508/#locked-states). Click **Continue**.
  6. Confirm the potential updates to the records listed in the _Summary_, then click **Confirm**. Vault removes the specified user from the _Quality Teams_ and notifies the administrator once the operation is complete. You can download a CSV file of the results from the _Notifications_ page.

### Replace a User on Quality Teams

To replace a single user on multiple _Quality Teams_:

  1. Navigate to the **Quality Teams Management** tab.
  2. Select **Replace User** from the drop-down.
  3. Select a **User** to replace on _Quality Teams_.
  4. Select an **Object** from the drop-down and select an **Object Type** if applicable. Click **Apply** to retrieve records or **Clear** to clear your previous selections.
  5. Assign a replacement user for each record up to 250 records. The drop-down list does not exclude ineligible users, however, selecting invalid users may result in failures. To assign the same user for all records, populate a replacement user for the first row and click the down arrow. You can filter by record name, lifecycle state, or application role. Vault only displays team-enabled records that have a role assigned to the selected user and are not in [locked states](/en/lr/54508/#locked-states). Click **Continue**.
  6. Confirm the potential updates to the records listed in the _Summary_, then click **Confirm**. Vault replaces the specified user on the _Quality Teams_ and notifies the administrator once the operation is complete. You can download a CSV file of the results from the _Notifications_ page.

## Deleting Records with Quality Team Assignments

Vault attempts to delete any _Quality Team Role_ assignments whenever a user deletes a team-enabled object record. Vault respects the object relationship's [deletion rule behavior](/en/lr/28740/) when determining whether the system can delete a team-enabled object record with _Quality Team_ assignments, and how that deletion action will affect any related records or their _Quality Team Role_ assignments.

## Reporting on Teams

You can report on your Quality teams and team members to easily assess scope and efficiency. To do so, create a report with an Application Role [report type](/en/lr/3606/#report-type).

## Related Objects & Terms

  * **Team-Enabled Object**: An object you have defined a team for.
  * **Team-Enabled Record**: An object type record that leverages a team.
  * **Quality Team Members Object**: A system managed object that Vault creates when you create a team. It stores the team role assignments of users for specific team-enabled records.
  * **Quality Team**: This component defines a _Quality Team_ you've created in your Vault. It defines the structure of the team by associating _Quality Team Roles_ and team behavior as a team-enabled record moves through its processes. It is associated to an object or object type in order to declare records of that object or object type to use a team.
  * **Quality Team Role**: A role defining which security rights members have and by which role they are constrained. This component defines the roles that are available or required for object records leveraging the associated _Quality Team_ (Change Owner, Primary Investigator, QA Approver, etc). These roles link to sharing settings roles such as _Owner_, _Reviewer_, and _Editor._ The component further defines the behavior of these roles. For example, you can define the minimum number of users required to complete a team, the maximum number of users allowed on a team, and whether or not you can select users from any group in the Vault or from a specific role on the team-enabled record.

## Related Permissions {#permissions}

To view the _Team_ section and to manage team members, users require _Read_ permission on both the relevant team-enabled object and its corresponding _Quality Team Member_ object. For example, to modify team role assignments on a _Deviation_ record, users need _Read_ permission on the _Deviation_ object and the _Deviation Quality Team Member_ object.

The ability to edit _Quality Teams_ on team-enabled objects in a given lifecycle state also depends on the lifecycle's [Atomic Security on Relationships](/en/lr/47850/#Atomic_Security_Relationships) or [locked state](/en/lr/54508/#locked-states) configuration.

To work with the [Quality Teams Bulk Management](/en/lr/52842/#bulk-management) feature, intended for Admin usage, users require the following permissions:

* _Read_ permission on the **Permission Set > Admin > Quality Teams component**
* All _API_ permissions on the **Permission Set > Application > API component**
* _View_ permission on the **Permission Set > Tabs > Quality Teams Management component**
* _View_ permission on the **Permission Set > Pages > Quality Teams Bulk Management component**
* _Read_ permission on the **Permission Set > Objects > User > System Owned User Object Field Permissions**

 [1]: #constraining-roles
 [2]: #permissions
 [3]: #assigning-users
 [4]: #bulk-management
 [5]: #invalid-team-members