Content
The directory settings XML tag (<tbook> or <phone-book) contains a list of contact entries to be provisioned into the internal phone directory.
inside the <settings> tag:
<tbook complete="true"> <item context="<outgoing_SIP_identity>" type="<contact_category>" index="<contact_index(0)>"> <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>
or as an individual XML file whose URL is listed inside <setting-files> tag
<?xml version="1.0" encoding="utf-8"?> <tbook complete="true"> <item context="<outgoing_SIP_identity>" type="<contact_category>" index="<contact_index(0)>"> <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>
Where...
the following attributes are used:
index
Since version 8.2.20 the index provided is used to change the specific entry at that index. Previously the tbook tried to match the entries provided to the internal entries via the given number string(and still does so when no index is provided), which allowed the provisioner to change everything but this phonenumber. Now with the help of the index even that can be done.
Previously the tbook tried to match the entries provided to the internal entries via the given number string (and still does so when no index is provided), which allowed the provisioner to change everything but this phonenumber. Now with the help of the index even that can be done.
Example file name: http://domain/snomD3xx/directory.xml
<?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>
Example with master and member entries:
You may also use the XCAP capabilities of our phones which allow synchronizing the internal tbook with one from the net using simple http requests, see tbook-xcap-synchronization.
Further Information
Related articles