DS_USERS.csv

The DS_USERS.csv file contains information necessary to create and maintain Users in xMatters:

DS_USERS.csv file columns

Column Name

Maximum Character Length

Comments

EXTERNAL_KEY

250

See Standard CSV Fields.

SITE_NAME

100

The user’s site (by external_key).

This value is specified on the user’s details page in the xMatters web user interface.

ROLE_LIST

2000

Comma-separated list of roles (by name) for the user (case-sensitive), and note that this list can change depending on the roles specified for a particular company. Replaces all current roles for the user.

See Valid field values for valid out-of-the-box values.

STATUS

30

Indicates whether this user is active or inactive (ACTIVE or INACTIVE; case-sensitive).

This value is specified on the user’s details page in the xMatters web user interface.

LAST_NAME

100

User’s last name.

This value is specified on the user’s details page in the xMatters web user interface.

FIRST_NAME

100

User’s first name.

This value is specified on the user’s details page in the xMatters web user interface.

LANGUAGE_OVERRIDE

(optional)

100

If present, the name of the user’s preferred language for web user interface and device interaction (currently, the only valid value is "English"). If not present, the language specified for the user’s site is used.

TIMEZONE_OVERRIDE

(optional)

100

If present, the name of the timezone used for date and time information presentation (case-sensitive; see below for valid values). If not present, the timezone specified for the user’s site is used.

RECORDED_NAME

(optional)

100

Recorded (Phone) name for this user.

It is recommended that the RECORDED_NAME value match the USER_ID value.

WEB_LOGIN

(optional)

30

The web login user name for the User.

By default the web password is set to be the User ID (target name) for the user.

PHONE_LOGIN

(optional)

100

The phone login user name for the user.

USER_ID

100

Target name that outside systems use to identify the user.

Value in this column must not match any GROUP_NAME value in the ds_groups table.

IS_EXTERNALLY_OWNED

1

See Standard CSV Fields.

ACTION

1

See Standard CSV Fields.

Valid TIMEZONE_OVERRIDE Values

Values must include the general area or country, and the specific zone or location within that area, formatted as <Area>/<Location>; for example:

Asia/Hong_Kong
Area Locations
Africa Abidjan, Accra, Addis_Ababa, Algiers, Asmera, Bamako, Bangui, Banjul, Bissau, Blantyre, Brazzaville, Bujumbura, Cairo, Casablanca, Ceuta, Conakry, Dakar, Dar_es_Salaam, Djibouti, Douala, El_Aaiun, Freetown, Gaborone, Harare, Johannesburg, Kampala, Khartoum, Kigali, Kinshasa, Lagos, Libreville, Lome, Luanda, Lubumbashi, Lusaka, Malabo, Maputo, Maseru, Mbabane, Mogadishu, Monrovia, Nairobi, Ndjamena, Niamey, Nouakchott, Ouagadougou, Porto-Novo, Sao_Tome, Tripoli, Tunis, Windhoek
America Adak, Anchorage, Anguilla, Antigua, Araguaina, Aruba, Asuncion, Bahia, Barbados, Belem, Belize, Boa_Vista, Bogota, Boise, Buenos_Aires, Cambridge_Bay, Campo_Grande, Cancun, Caracas, Catamarca, Cayenne, Cayman, Chicago, Chihuahua, Cordoba, Costa_Rica, Cuiaba, Curacao, Danmarkshavn, Dawson, Dawson_Creek, Denver, Detroit, Dominica, Edmonton, Eirunepe, El_Salvador, Fortaleza, Glace_Bay, Godthab, Goose_Bay, Grand_Turk, Grenada, Guadeloupe, Guatemala, Guayaquil, Guyana, Halifax, Havana, Hermosillo, Indiana/Indianapolis, Indiana/Knox, Indiana/Marengo, Indiana/Vevay, Inuvik, Iqaluit, Jamaica, Jujuy, Juneau, Kentucky/Louisville, Kentucky/Monticello, La_Paz, Lima, Los_Angeles, Maceio, Managua, Manaus, Martinique, Mazatlan, Mendoza, Menominee, Merida, Mexico_City, Miquelon, Monterrey, Montevideo, Montreal, Montserrat, Nassau, New_York, Nipigon, Nome, Noronha, North_Dakota/Center, Panama, Pangnirtung, Paramaribo, Phoenix, Port-au-Prince, Port_of_Spain, Porto_Velho, Puerto_Rico, Rainy_River, Rankin_Inlet, Recife, Regina, Rio_Branco, Santiago, Santo_Domingo, Sao_Paulo, Scoresbysund, Shiprock, St_Johns, St_Kitts, St_Lucia, St_Thomas, St_Vincent, Swift_Current, Tegucigalpa, Thule, Thunder_Bay, Tijuana, Toronto, Tortola, Vancouver, Whitehorse, Winnipeg, Yakutat, Yellowknife
Antarctica Casey, Davis, Dumont d'Urville, Mawson, McMurdo, Palmer, Rothera, South_Pole, Syowa, Vostok
Arctic Longyearbyen
Asia Aden, Almaty, Amman, Anadyr, Aqtau, Aqtobe, Ashgabat, Baghdad, Bahrain, Baku, Bangkok, Beirut, Bishkek, Brunei, Calcutta, Choibalsan, Chongqing, Colombo, Damascus, Dhaka, Dili, Dubai, Dushanbe, Gaza, Harbin, Hong_Kong, Hovd, Irkutsk, Istanbul, Jakarta, Jayapura, Jerusalem, Kabul, Kamchatka, Karachi, Kashgar, Katmandu, Krasnoyarsk, Kuala_Lumpur, Kuching, Kuwait, Macau, Magadan, Makassar, Manila, Muscat, Nicosia, Novosibirsk, Omsk, Oral, Phnom_Penh, Pontianak, Pyongyang, Qatar, Qyzylorda, Rangoon, Riyadh, Saigon, Sakhalin, Samarkand, Seoul, Shanghai, Singapore, Taipei, Tashkent, Tbilisi, Tehran, Thimphu, Tokyo, Ulaanbaatar, Urumqi, Vientiane, Vladivostok, Yakutsk, Yekaterinburg, Yerevan
Atlantic Azores, Bermuda, Canary, Cape_Verde, Faeroe, Jan_Mayen, Madeira, Reykjavik, South_Georgia, St_Helena
Australia Adelaide, Brisbane, Broken_Hill, Darwin, Hobart, Lindeman, Lord_Howe, Melbourne, Perth, Sydney
Canada Atlantic, Central, East-Saskatchewan, Eastern, Mountain, Newfoundland, Pacific, Saskatchewan, Yukon
Europe Amsterdam, Andorra, Athens, Belgrade, Berlin, Bratislava, Brussels, Bucharest, Budapest, Chisinau, Copenhagen, Dublin, Gibraltar, Helsinki, Istanbul, Kaliningrad, Kiev, Lisbon, Ljubljana, London, Luxembourg, Madrid, Malta, Minsk, Monaco, Moscow, Nicosia, Oslo, Paris, Prague, Riga, Rome, Samara, San_Marino, Sarajevo, Simferopol, Skopje, Sofia, Stockholm, Tallinn, Tirane, Uzhgorod, Vaduz, Vatican, Vienna, Vilnius, Warsaw, Zagreb, Zaporozhye, Zurich
GMT  
Greenwich  
Indian Antananarivo, Chagos, Christmas, Cocos, Comoro, Kerguelen, Mahe, Maldives, Mauritius, Mayotte, Reunion
Pacific Apia, Auckland, Chatham, Easter, Efate, Enderbury, Fakaofo, Fiji, Funafuti, Galapagos, Gambier, Guadalcanal, Guam, Honolulu, Johnston, Kiritimati, Kosrae, Kwajalein, Majuro, Marquesas, Midway, Nauru, Niue, Norfolk, Noumea, Pago_Pago, Palau, Pitcairn, Ponape, Port_Moresby, Rarotonga, Saipan, Tahiti, Tarawa, Tongatapu, Truk, Wake, Wallis
US Alaska, Aleutian, Arizona, Central, East-Indiana, Eastern, Hawaii, Indiana-Starke, Michigan, Mountain, Pacific, Samoa