DS_TEAMS.csv
The DS_TEAMS.csv table contains information necessary to create and maintain shifts in xMatters groups. When you define a shift you must define its members in the DS_TEAM_MEMBERSHIPS.csv file. By default, all shifts are created with a 24x7 schedule.
Column Name |
Maximum Character Length |
Comments |
EXTERNAL_KEY |
250 |
See Standard CSV Fields. Note that all shifts, regardless of the group to which they belong, require a unique key. It is recommended that the external_key value also includes the external_key for the group to which it belongs. |
GROUP_KEY |
250 |
The external_key for the group that owns this shift. |
SUB_TARGET_NAME |
100 |
Additional name the external systems use to identify this shift within the Group (this is displayed as the shift name in the web user interface). |
DESCRIPTION (optional) |
200 |
Description of the shift. This value is specified on the Shifts tab in the xMatters web user interface. |
USE_DEFAULT_DEVICES |
1 |
Indicates whether to use Default Devices (Y or N). This value is specified on the group overview page in the xMatters web user interface. |
ESCALATION_SCHEDULE |
255 |
Comma-separated list of integers specifying the escalation schedule for this shift. Each comma-separated integer refers to the Wait (min) setting associated with a member). If you specify fewer values than the number of members, the remaining members are set to a zero minute delay. |
IS_ROUND_ROBIN |
1 |
Indicates whether the escalation order should rotate after each alert. |
IS_EXTERNALLY_OWNED |
1 |
See Standard CSV Fields. |
ACTION |
1 |
See Standard CSV Fields. |
Only basic (non-rotating) and alert-based rotations are supported; schedule- and shift-based rotations are not supported.