Polycom::Contact::Directory version 0.05
================================

This module can be used to parse, modify, or create local contact directory files like those used by
Polycom's SoundPoint IP, SoundStation IP, and VVX 1500 VoIP phones.

Upon bootup, each phone looks for a file named <Ethernet address>-directory.xml on their boot server,
and if found, downloads and parses the file to build up its local contact directory. In addition to
basic contact information such first/last name and phone number, each contact in the local contact
directory can also include information about speed-dialing, distinctive ring tones, presence, and
instant messaging.

Each <Ethernet address>-directory.xml contains fairly straightforward XML:

  <?xml version=”1.0” encoding=”UTF-8” standalone=”yes” ?>
  <directory>
   <item_list>
    <item>
     <ln>Doe</ln>
     <fn>John</fn>
     <ct>1001</ct>
     <sd>1</sd>
     <rt>1</rt>
     <dc/>
     <ad>0</ad>
     <ar>0</ar>
     <bw>0</bw>
     <bb>0</bb>
    </item>
      ...
   </item_list>
  </directory>

For more information about administering the Local Contact Directory on Polycom SoundPoint IP phones,
see the "SoundPoint IP, SoundStation IP and Polycom VVX Administrator's Guide" at
http://www.polycom.com/support/voice/soundpoint_ip/soundpoint_ip670.html .


INSTALLATION

To install this module, type the following:

   perl Makefile.PL
   make
   make test
   make install

DEPENDENCIES

Class::Accessor
Encode
IO::File
List::MoreUtils
Test::More
perl 5.8

COPYRIGHT AND LICENCE

Copyright (C) 2010 by Polycom Canada 

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.