Managing Teams

The following sections describe how to view, modify and remove Teams, and how to develop templates that simplify Team creation.

Team Types

The following types of Teams are available in xMatters:

You can also keep Team members in the same position on the list by excluding them from the rotation. For more information, see ‘Freezing’ a Rotation Team Member’s Position.

Viewing and Editing Team Details

You can view and edit the details for Teams on the Team Details page.

Note: For information about adding and removing Team members, see the following section, Assigning Team Members.
To view and edit Team details:
  1. On the Groups I Supervise page, click the name of the Group containing the Team you want to view.
  2. On the Group Details page, in the Common Tasks pane, click Teams in Group.
    1. xMatters displays the Teams in Group page.
  3. In the Teams in this Group list, click the name of the Team you want to view.
    1. xMatters displays the Team Details page.
  4. To show or hide the Team details, click Show Details or Hide Details.
  5. On the Team Details page, enter the following information:
Team Details

Setting

Description

Method

(This setting appears only if you are creating a new Team, and have already created other Groups and Teams.)

Select one of the following options:

  • Copy Existing Team: creates a new Team based on an existing Team. The new Team will be created with the same members as the Team on which it is based.
  • Create New Team: creates a new Team to which you can assign a schedule and members.

Copy From

(This field appears only if you have already created other Groups, and have selected Copy Existing Team from the Method drop-down list.)

Select the Team you want to use as a template for the new Team.

New Team Name

Type a name for the new Team (e.g., “Weekend A”).

Description

Type a description for the Team (e.g., “Rotating weekend on-call team”).

Reuse

Select this option if you want to use this Team again when you create other Coverages within this Group.

Team Type

Select one of the following options:

  • Basic: xMatters sends notifications to Team members in the order they are listed; this order does not change unless modified manually.
  • Event Round Robin: After each Event, Team members switch places so that the next Event targets a different primary on-call responder; specify the direction in which Team members should rotate by selecting one of the options in the Rotation Direction drop-down list, as described below.
  • Rotation: After a defined time period, Team members switch places so that subsequent Events target a different primary on-call responder; specify the direction in which Team members should rotate by selecting one of the options in the Rotation Direction drop-down list, as described below.
  • Coverage Rotation: After a specific number of shifts, Team members switch position so that a different Team member becomes the primary responder for the next shift; specify the Coverage on which to base this rotation in the Coverage drop-down list and specify the direction in which Team members should rotate by selecting one of the options in the Rotation Direction drop-down list, as described below.

Coverage

Applies only to Coverage Rotation Teams

Select the Coverage on which to base the Team members rotation. Note that Team members will rotate based on the shifts specified in the Coverage's original Schedule. This applies in the following ways:

  • Holidays: If the Schedule for the Coverage excludes holidays, the Team members will still rotate if a holiday falls on a day that would normally include a shift. For example, if the specified Coverage is active from Monday to Friday, and the Monday of a particular week is a holiday (and the Coverage is therefore not active), the Team members will still rotate as though a shift occurred on that Monday.

Similarly, if a Coverage includes Site holidays, Team members will NOT rotate for any extra shifts that occur. For example, if a Coverage is active on Tuesdays and Thursdays, and the Monday of a particular week is a holiday (and the Coverage is therefore active), the Team members will not rotate, even though an extra shift occurred.

  • Modified shifts: If you modify a shift within a Coverage (as described in Modifying a Shift), that shift will be included when calculated Team rotation.

Rotation Direction

Applies only to Teams where members rotate; i.e., non-Basic Teams.

Select one of the following options:

  • Second to First: After each Event or rotation interval, the second Team member listed moves to the front of the list to become the primary on-call responder for the next Event. The former primary on-call is moved to the last place on the list.
  • Last to First: After each Event or rotation interval, the primary on-call responder is moved to the second place on the list, and the Team member that was in last place becomes the new primary on-call.

For examples of this setting, see "Team rotation direction examples", below.

The following settings apply only to Rotation and Coverage Rotation Teams:

Rotation Interval

Specify the duration in days, weeks, or months for the Team members to rotate.

Do one of the following:

  • For Rotation Teams, specify the duration in days, weeks, or months for the Team members to rotate.
  • For Coverage Rotation Teams, specify how often the Team members should rotate by specifying the number of shifts that should occur before each rotation. For example, to have the Team rotate members after every shift, type 1.

Start Date

Click the date-picker (or use the field) to specify the date on which you want to the Rotation Interval to begin.

Start Time

Specify the time at which you want the Rotation Interval to begin on its Start Date. (Note that this setting is not available for Coverage Rotation Teams as members rotate based on the Coverage shifts.)

  1. To discard any changes, click Reset.
  2. To save the changes to the Team details, click Save.

Team rotation direction examples

The following examples illustrate how the Rotate Direction field affects the order in which Team members will become primary, secondary, or tertiary on-call responders after each Event that targets an Event Round Robin Team, after a specific period of time passes for a Rotation Team, or after each shift of a Coverage associated with a Coverage Rotation Team.

Assume that you are creating an Event Round Robin Team with five members, assigned to the following initial order: User A, User B, Device C, User D, Group E.

The following table shows how the members would be reordered after a single Event targets the Team for notification, and after three successive Events:

Rotation Direction Starting Order After One Event After Three Events
Second to First
  1. User A
  2. User B
  3. Device C
  4. User D
  5. Group E
  1. User B
  2. Device C
  3. User D
  4. Group E
  5. User A
  1. User D
  2. Group E
  3. User A
  4. User B
  5. Device C
Last to First
  1. User A
  2. User B
  3. Device C
  4. User D
  5. Group E
  1. Group E
  2. User A
  3. User B
  4. Device C
  5. User D
  1. Device C
  2. User D
  3. Group E
  4. User A
  5. User B
Note: The same ordering would apply to a Rotation Team or Coverage Rotation Team, but members would be reordered after each rotation interval or shift occurrence, rather than after each Event.