Installation guide

322 Planning and Installation Guide ShoreTel 14.2
ShoreTel Integration with External Applications XML File Properties
17
XML File Properties
XML files contain a structured set of elements. The file components and XML elements recognized by
ShoreTel Communicator are described below.
XML File Name
The file name must have the extension .xml.
XML File Elements
The following elements are recognized by ShoreTel Communicator Contact XML files:
 Level 1 Elements
 Level 2 Elements
 Level 3 Elements
Level 1 Elements
Each file contains one Contacts element. The Contacts element specifies the source name and
version number and contains one Contact element for each contact in the file.
Valid attributes: source, version.
Example:
<contacts source = “File 1” version = “2.0”> </contacts>
Level 2 Elements
The Contacts element contains one Contact element for each user defined by the XML file. Each
contact element contains Level 3 elements that define the field contents for the user. Each Contact
element must contain one ContactID element and one other Level 3 element
Level 3 Elements
Level 3 elements are contained with the Contact element and specify field contents for contacts
imported to ShoreTel Communicator: contactID, name, company, department, categories, phone,
email, and IM.
Table 71: Level 3 Elements
Element Definition
contactID This field uniquely identifies the contact record within the file. The Contact ID
is a string with a maximum of 126 characters. ShoreTel Communicator does
not display this field. All contact records require a Contact ID. If multiple
contact records contain identical Contact IDs, the last such contact in the list
is imported into ShoreTel Communicator and all other contacts with the same
ID are ignored. Example: <contactID>1234</contactID>