Features/Mass Deployment/Setting Files/XML/Directory

From Snom User Wiki

Introduction

The directory settings XML tag (<tbook> or <phone-book) contains a list of contact entries to be provisioned into the internal phone directory. This XML tag can be used either

• inside the <settings> tag or
• as an individual XML file whose URL is listed inside <setting-files> tag

Syntax

The following tags are equivalent:

• <tbook>
• <phone-book>

<?xml version="1.0" encoding="utf-8"?>
 <tbook>
  <item context="<outgoing_SIP_identity>" type="<contact_category>" index="<contact_index(1)>">
   <name><contact_name</name>
   <number><contact_name></number>
  </item>
  ...
  <item context="<outgoing_SIP_identity>" type="<contact_category>" index="<contact_index(n)>">
   <name><contact_name</name>
   <number><contact_name></number>
  </item>
 </tbook>

• each item tag defines one directory contact entry and requires the following parameters:
  • context string defines the SIP identity (line/account) this contact should be called with, valid values are described in the formerly used configuration parameter "to"
  • type string defines the contact's category, valid values are described in the formerly used configuration parameter "tc"
  • index string represents the contact's position within the list of entries. This value must be unique for each item and within the following range:
    • snom300, snom320, snom360: index=["0".."99"] --> maximal 100 directory entries
    • snom370: index=["0".."249"] --> maximal 250 directory entries
  • name string defines the contact's name, valid values are described in the formerly used configuration parameter "tn"
  • number string defines the contact's number, valid values are described in the formerly used configuration parameter "tu"

Example

<?xml version="1.0" encoding="utf-8"?>
 <tbook>
  <item context="line1" type="none" index="0">
   <name>Adrian</name>
   <number>42965</number>
  </item>
  <item context="active" type="colleagues" index="1">
   <name>Roland</name>
   <number>16424</number>
  </item>
  ...
  <item context="line12" type="friends" index="99">
   <name>Suzy</name>
   <number>78371</number>
  </item>
 </tbook>