<docbook><section><title>OdsAddressbookSyncML</title><title>Using SyncML with ODS-AddressBook</title>Using <ulink url="SyncML">SyncML</ulink> with ODS-<ulink url="AddressBook">AddressBook</ulink>
<para>ODS-<ulink url="AddressBook">AddressBook</ulink> now supports synchronization to DAV <ulink url="http://virtuoso.openlinksw.com/wiki/main/Main/SyncML">SyncML</ulink> folder and back.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Prerequisites</bridgehead>
<para>Make sure the following packages are installed:</para>
<orderedlist spacing="compact"><listitem><ulink url="https://virtuoso.openlinksw.com/download/">ods_framework_dav.vad</ulink> </listitem>
<listitem><ulink url="https://virtuoso.openlinksw.com/download/">ods_addressbook_dav.vad</ulink> </listitem>
<listitem><ulink url="https://virtuoso.openlinksw.com/download/">syncml_dav.vad</ulink></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2">Sample Scenario</bridgehead>
<orderedlist spacing="compact"><listitem>Go to http://&lt;host&gt;:&lt;port&gt;/ods </listitem>
<listitem>Enter ODS user credentials.
</listitem>
<listitem>Click the <emphasis>Briefcase</emphasis> link in the left navigation bar.
</listitem>
<listitem>Your DAV/home/&lt;ods-user&gt; folder will be displayed: <figure><graphic fileref="OdsAddressbookSyncML/scy1.png" /></figure> </listitem>
<listitem>Click <emphasis>New Folder</emphasis>.
<figure><graphic fileref="OdsAddressbookSyncML/scy2.png" /></figure> </listitem>
<listitem>Create a regular folder; for this example, named <emphasis>mysync</emphasis> <figure><graphic fileref="OdsAddressbookSyncML/scy3.png" /></figure> </listitem>
<listitem>Go to the new <emphasis>mysync</emphasis> folder: <figure><graphic fileref="OdsAddressbookSyncML/scy4.png" /></figure> </listitem>
<listitem>Click  again <emphasis>New Folder</emphasis>.
</listitem>
<listitem>Name this folder <emphasis>contacts</emphasis>, and specify the Folder type as [[<ulink url="http://virtuoso.openlinksw.com/wiki/main/Main/SyncML">http://virtuoso.openlinksw.com/wiki/main/Main/SyncML</ulink>] <figure><graphic fileref="OdsAddressbookSyncML/sca1.png" /></figure> </listitem>
<listitem>Go to the new displayed &quot;<ulink url="SyncML">SyncML</ulink>&quot; tab: <figure><graphic fileref="OdsAddressbookSyncML/scy6.png" /></figure> </listitem>
<listitem>Specify the <ulink url="SyncML">SyncML</ulink> version and type, for ex.: 1.1 and vcard 1.1, respectively.
<figure><graphic fileref="OdsAddressbookSyncML/sca2.png" /></figure> </listitem>
<listitem>Click &quot;Create&quot;.
</listitem>
<listitem>The created folder should be displayed in the list of available resources for the mysync folder: <figure><graphic fileref="OdsAddressbookSyncML/sca3.png" /></figure> </listitem>
<listitem>Click <emphasis><ulink url="AddressBook">AddressBook</ulink></emphasis> in the left navigation bar.
</listitem>
<listitem>Your ODS-<ulink url="AddressBook">AddressBook</ulink> instance will be loaded, and automatically created if you don&#39;t have one yet: <figure><graphic fileref="OdsAddressbookSyncML/sca4.png" /></figure> <itemizedlist mark="bullet" spacing="compact"><listitem>In case of new created ODS-<ulink url="AddressBook">AddressBook</ulink> instance, create several contacts.
</listitem>
</itemizedlist></listitem>
<listitem>Go to <emphasis>Preferences</emphasis> --&gt; <emphasis><ulink url="SyncML">SyncML</ulink></emphasis> <figure><graphic fileref="OdsAddressbookSyncML/sca5.png" /></figure> </listitem>
<listitem>Click <emphasis>New <ulink url="SyncML">SyncML</ulink></emphasis> <figure><graphic fileref="OdsAddressbookSyncML/sca6.png" /></figure> </listitem>
<listitem>In the form: <itemizedlist mark="bullet" spacing="compact"><listitem>Name the <ulink url="SyncML">SyncML</ulink> job; e.g., <emphasis>test</emphasis> </listitem>
<listitem>Enter the <ulink url="WebDAV">WebDAV</ulink> <ulink url="SyncML">SyncML</ulink> Path; e.g., <emphasis>/DAV/home/[ods-user]/mysync/contacts</emphasis> </listitem>
<listitem>Enter your ODS username and password <figure><graphic fileref="OdsAddressbookSyncML/sca7.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click <emphasis>Create</emphasis>.
<figure><graphic fileref="OdsAddressbookSyncML/sca8.png" /></figure> </listitem>
<listitem>Click <emphasis>Sync</emphasis>.
<figure><graphic fileref="OdsAddressbookSyncML/sca9.png" /></figure> </listitem>
<listitem>Specify the direction of synchronization, and click the <emphasis>Sync</emphasis> button.
</listitem>
<listitem>A message will show how many contacts were synced to the ODS-<ulink url="AddressBook">AddressBook</ulink> instance (In), and how many were synced to the DAV location (Out): <figure><graphic fileref="OdsAddressbookSyncML/sca10.png" /></figure></listitem>
</orderedlist><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Synchronization in Background</bridgehead>
<para>Suppose you have synced your contacts from the ODS-<ulink url="AddressBook">AddressBook</ulink> instance to the DAV location as described above.
 When there is a change on some of the fields for a current contact in your ODS-<ulink url="AddressBook">AddressBook</ulink>, the <emphasis>Save</emphasis> action will trigger a re-sync to the DAV location.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Related</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://docs.openlinksw.com/virtuoso/syncml.html">Virtuoso SyncML documentation</ulink> </listitem>
<listitem><ulink url="VirtSyncMLAndroidToVirtuoso">How to sync my Android contacts to Virtuoso using SyncML</ulink> </listitem>
<listitem><ulink url="OdsCalendarSyncML">Using SyncML with ODS-Calendar</ulink></listitem>
</itemizedlist><para><ulink url="CategoryODS">CategoryODS</ulink> <ulink url="CategoryOpenSource">CategoryOpenSource</ulink> <ulink url="CategoryAddressBook">CategoryAddressBook</ulink> <ulink url="CategoryOdsAddressBook">CategoryOdsAddressBook</ulink> </para>
</section></docbook>