%META:TOPICPARENT{name="OdsCalendar"}%

---+Using SyncML with ODS-Calendar

ODS-Calendar now supports synchronization to DAV [[http://virtuoso.openlinksw.com/wiki/main/Main/SyncML][SyncML]] folder and back.

---++Prerequisites

Make sure the following packages are installed:

   1. [[https://virtuoso.openlinksw.com/download/][ods_framework_dav.vad]]
   1. [[https://virtuoso.openlinksw.com/download/][ods_calendar_dav.vad]]  
   1. [[https://virtuoso.openlinksw.com/download/][syncml_dav.vad]]

---++Sample Scenario

   1. Go to <code><nowiki>http://&lt;host&gt;:&lt;port&gt;/ods</nowiki></code>
   1. Log in.
   1. Click the <b>Briefcase</b> link in the left navigation bar. 
   1. Your DAV/home/&lt;ods-user&gt; folder will be displayed:
%BR%%BR%<img src="%ATTACHURLPATH%/scy1.png" />%BR%%BR%
   1. Click <b>New Folder</b>.
%BR%%BR%<img src="%ATTACHURLPATH%/scy2.png" />%BR%%BR%
   1. Create a regular folder; for this example, named <b><code>mysync</code></b>:
%BR%%BR%<img src="%ATTACHURLPATH%/scy3.png" />%BR%%BR%
   1. Go to the new <b>mysync</b> folder:
%BR%%BR%<img src="%ATTACHURLPATH%/scy4.png" />%BR%%BR%
   1. Click again <b>New Folder</b>.
   1. Name this folder <b><code>calendar</code></b>, and specify the Folder type as [[http://virtuoso.openlinksw.com/wiki/main/Main/SyncML][SyncML]] folder:
%BR%%BR%<img src="%ATTACHURLPATH%/scy5.png" />%BR%%BR%
   1 Go to the new displayed "SyncML" tab:
%BR%%BR%<img src="%ATTACHURLPATH%/scy6.png" />%BR%%BR%
   1 Specify the SyncML version and type, for ex.:<b><code>1.1</code></b> and <b><code>vcalendar 11</code></b>, respectively. 
%BR%%BR%<img src="%ATTACHURLPATH%/scy7.png" />%BR%%BR%
   1 Click "Create".
   1 The created folder should be displayed in the list of available resources for the <b>mysync</b> folder:
%BR%%BR%<img src="%ATTACHURLPATH%/scy8.png" />%BR%%BR%
   1. Click <b>Calendar</b> in the left navigation bar.
   1. Your ODS-Calendar instance will be loaded, and automatically created if you don't have one yet:
%BR%%BR%<img src="%ATTACHURLPATH%/scy9.png" />%BR%%BR%
      * In case of new created ODS-Calendar instance, create several events and/or tasks.
   1. Go to <b>Import/Export</b>:
%BR%%BR%<img src="%ATTACHURLPATH%/scy10.png" />%BR%%BR%
   1 Select <b>Manage SyncML</b>:
%BR%%BR%<img src="%ATTACHURLPATH%/scy11.png" />%BR%%BR%
   1. Click <b>New SyncML</b>:
%BR%%BR%<img src="%ATTACHURLPATH%/scy12.png" />%BR%%BR%
   1. In the presented form:
      * Name the SyncML job; e.g., <b><code>test</code></b>;
      * Enter the WebDAV SyncML Path to the folder you created above; e.g., <b><code>/DAV/home/&lt;ods-user&gt;/mysync/calendar</code></b>;
      * Enter your ODS username and password;
      * Select whether to sync events, tasks, or both;
%BR%%BR%<img src="%ATTACHURLPATH%/scy13.png" />%BR%%BR%
   1. Click <b>Create</b>.
%BR%%BR%<img src="%ATTACHURLPATH%/scy14.png" />%BR%%BR%
   10. Click <b>Sync</b>.
   11. Specify the direction of synchronization, and click the <b>Sync</b> button.
%BR%%BR%<img src="%ATTACHURLPATH%/scy15.png" />%BR%%BR%
   12. A message will show how many events and tasks were synced to the Calendar instance (In), and how many were synced to the DAV location (Out):
%BR%%BR%<img src="%ATTACHURLPATH%/scy16.png" />%BR%%BR%
      
---++ Synchronization in Background

Suppose you have synced your tasks and events from the Calendar instance to the DAV location as described above. When there is a change on some of the fields for a current event or task in your Calendar, the <b>Save</b> action will trigger a re-sync to the DAV location.

---++ Related

   * [[http://docs.openlinksw.com/virtuoso/syncml.html][Virtuoso SyncML documentation]]
   * [[VirtSyncMLAndroidToVirtuoso][How to sync my Android contacts to Virtuoso using SyncML]]
   * [[OdsAddressbookSyncML][Using SyncML with ODS-AddressBook]]

CategoryODS CategoryOpenSource CategoryCalendar