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.

DS_TEAMS.csv file elements

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.