DS_USERS.csv
The DS_USERS.csv file contains information necessary to create and maintain Users in xMatters:
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, Juba, 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, Argentina/La_Rioja, Argentina/Rio_Gallegos, Argentina/Salta, Argentina/San_Juan, Argentina/San_Luis, Argentina/Tucuman, Argentina/Ushuaia, Aruba, Asuncion, Atikokan, Bahia, Bahia_Banderas, Barbados, Belem, Belize, Blanc-Sablon, Boa_Vista, Bogota, Boise, Buenos_Aires, Cambridge_Bay, Campo_Grande, Cancun, Caracas, Catamarca, Cayenne, Cayman, Chicago, Chihuahua, Cordoba, Costa_Rica, Creston, 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/Petersburg, Indiana/Tell_City, Indiana/Vevay, Indiana/Vincennes, Indiana/Winamac, Inuvik, Iqaluit, Jamaica, Jujuy, Juneau, Kentucky/Louisville, Kentucky/Monticello, Kralendijk, La_Paz, Lima, Los_Angeles, Lower_Princes, Maceio, Managua, Manaus, Marigot, Martinique, Matamoros, Mazatlan, Mendoza, Menominee, Merida, Metlakatla, Mexico_City, Miquelon, Moncton, Monterrey, Montevideo, Montreal, Montserrat, Nassau, New_York, Nipigon, Nome, Noronha, North_Dakota/Beulah, North_Dakota/Center, North_Dakota/New_Salem, Ojinaga, Panama, Pangnirtung, Paramaribo, Phoenix, Port-au-Prince, Port_of_Spain, Porto_Velho, Puerto_Rico, Rainy_River, Rankin_Inlet, Recife, Regina, Rio_Branco, Santarem, Santiago, Santo_Domingo, Sao_Paulo, Scoresbysund, Shiprock, Sitka, St_Barthelemy, 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, Macquarie, Mawson, McMurdo, Palmer, Rothera, South_Pole, Syowa, Troll, Vostok |
Arctic | Longyearbyen |
Asia | Aden, Almaty, Amman, Anadyr, Aqtau, Aqtobe, Ashgabat, Atyrau, Baghdad, Bahrain, Baku, Bangkok, Barnaul, Beirut, Bishkek, Brunei, Calcutta, Choibalsan, Chongqing, Colombo, Damascus, Dhaka, Dili, Dubai, Dushanbe, Famagusta, Gaza, Harbin, Hebron, Ho_Chi_Minh, Hong_Kong, Hovd, Irkutsk, Istanbul, Jakarta, Jayapura, Jerusalem, Kabul, Kamchatka, Karachi, Kashgar, Katmandu, Khandyga, Kolkata, Krasnoyarsk, Kuala_Lumpur, Kuching, Kuwait, Macau, Magadan, Makassar, Manila, Muscat, Nicosia, Novokuznetsk, Novosibirsk, Omsk, Oral, Phnom_Penh, Pontianak, Pyongyang, Qatar, Qyzylorda, Rangoon, Riyadh, Saigon, Sakhalin, Samarkand, Seoul, Shanghai, Singapore, Srednekolymsk, Taipei, Tashkent, Tbilisi, Tehran, Thimphu, Tokyo, Tomsk, Ulaanbaatar, Urumqi, Ust-Nera, Vientiane, Vladivostok, Yangon, Yakutsk, Yekaterinburg, Yerevan |
Atlantic | Azores, Bermuda, Canary, Cape_Verde, Faeroe, Jan_Mayen, Madeira, Reykjavik, South_Georgia, Stanley, St_Helena |
Australia | Adelaide, Brisbane, Broken_Hill, Currie, Darwin, Eucla, Hobart, Lindeman, Lord_Howe, Melbourne, Perth, Queensland, Sydney |
Canada | Atlantic, Central, East-Saskatchewan, Eastern, Mountain, Newfoundland, Pacific, Saskatchewan, Yukon |
Europe | Amsterdam, Andorra, Astrakhan, Athens, Belgrade, Berlin, Bratislava, Brussels, Bucharest, Budapest, Busingen, Chisinau, Copenhagen, Dublin, Gibraltar, Guernsey, Helsinki, Isle_of_Man, Istanbul, Jersey, Kaliningrad, Kiev, Kirov, Lisbon, Ljubljana, London, Luxembourg, Madrid, Malta, Mariehamn, Minsk, Monaco, Moscow, Nicosia, Oslo, Paris, Podgorica, Prague, Riga, Rome, Samara, San_Marino, Sarajevo, Saratov, Simferopol, Skopje, Sofia, Stockholm, Tallinn, Tirane, Ulyanovsk, Uzhgorod, Vaduz, Vatican, Vienna, Vilnius, Volgograd, Warsaw, Zagreb, Zaporozhye, Zurich |
GMT | |
Greenwich | |
Indian | Antananarivo, Chagos, Christmas, Cocos, Comoro, Kerguelen, Mahe, Maldives, Mauritius, Mayotte, Reunion |
Pacific | Apia, Auckland, Bougainville, Chatham, Chuuk, 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, Pohnpei, 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 |