DS_TEAMS.csv

The DS_TEAMS.csv table contains information necessary to create and maintain Teams in xMatters.  When you define a team you must define the members that belong to the team in the DS_TEAM_MEMBERSHIPS.csv file. Define a team membership for every team member, regardless of whether EPIC is run using mirror mode or non-mirror mode.

DS_TEAMS.csv file elements

Column Name

Maximum Character Length

Comments

EXTERNAL_KEY

250

See Standard CSV Fields.

Note that all Teams, regardless of the Group to which they belong, require a unique key. It is recommended that external_key value for a Team also includes the external_key for the Group to which it belongs.

GROUP_KEY

250

The external_key for the Group that owns this Team.

SUB_TARGET_NAME

100

Additional name the external systems use to identify this Team within the Group (this is displayed as the Team name in the web user interface).

DESCRIPTION

(optional)

200

Description of the Team.

This value is specified on the Team Details page 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 Details page in the xMatters web user interface.

ESCALATION_SCHEDULE

255

Comma-separated list of integers specifying the escalation schedule for this Team.

This value is specified on a Group’s Coverage page in the xMatters web user interface (each comma-separated integer refers to the Wait (min) setting associated with a Team member). If you specify fewer values than the number of Team Members, the remaining Team Members are set to a zero minute delay.

IS_ROUND_ROBIN

1

Indicates whether this is a Round Robin Team (Y or N).

This value is specified on the Team Details page in the xMatters web user interface.

IS_EXTERNALLY_OWNED

1

See Standard CSV Fields.

ACTION

1

See Standard CSV Fields.

Only Basic and Event Round Robin Teams are supported; Rotation Teams are not supported.