%VOSWARNING%


---++Calendar Subscription Ubiquity Tutorial

This tutorial demonstrates how to subscribe to [[http://myopenlink.net:8890/ods][MyOpenlink server]] Calendar for user demo from OpenLink [[http://demo.openlinksw.com/ods][Demo server]] Calendar instance for user demo.

---+++Ubiquity Commands Subscription

If not already subscribed, perform the following steps:

   1. Go to http://demo.openlinksw.com/ods/ods_ubiquity.html
   2. Click the button "Subscribe"
   3. Click the button "I know what I'm doing. Subscribe to it".
   4. As result should be shown message for "Subscription Successful" and we are ready to perform the steps from the tutorial.

---+++Initial conditions 

In order to be executed correctly the steps below, there should be ODS Calendar instance for user demo at the [[http://demo.openlinksw.com/ods][Demo server]] and there should be ODS Calendar instance for user demo at the [[http://myopenlink.net:8890/ods][MyOpenlink server]]. If not existing, it is enough after log in to go to Calendar from the left ODS Vertical Main Navigation. This will cause automatically to be created ODS Calendar instance.

---++++Prepare the file to which the subscription will refer

Note: If there is already such file, you can skip the steps in this section and continue with the Basic Tutorial Steps section

   1. Authenticate using ODS command mode:
      1. *sid*:
         1. Execute the command:
<verbatim>
ods-host http://demo.openlinksw.com/ods
</verbatim>
            * <img src="%ATTACHURLPATH%/u1.png" style="wikiautogen"/>
         1. Execute the command:
<verbatim>
ods-set-mode sid
</verbatim>
            * <img src="%ATTACHURLPATH%/u2.png" style="wikiautogen"/>
         1. Execute the command:
<verbatim>
ods-authenticate-user demo with demo
</verbatim>
            * <img src="%ATTACHURLPATH%/u3.png" style="wikiautogen"/>
      1. *oauth*: detailed description you can find [[VirtuosoOdsUbiquityTutorialsCalendarOAuthD][here]].
   1. Execute the command:
<verbatim>
ods-get-instance-id mycalendar
</verbatim>
      * <img src="%ATTACHURLPATH%/c1.png" style="wikiautogen"/>
   1. As result will be shown the instance id. For the "mybokmarks" instance this should be 59.
   1. Execute the command:
<verbatim>
ods-create-calendar-publication 59 name MyCalendar destinationType WebDAV destination /DAV/home/demo/mc.ics userName demo userPassword demo
</verbatim>
      * <img src="%ATTACHURLPATH%/c7.png" style="wikiautogen"/>
      * Note that you can also set destination Type to URL and destination to http://myopenlink.net:8890/DAV/home/demo/mc.ics for ex. In this case, several steps below when the user tries to subscribe for Calendar in mc.ics file, need to set as sourceType WebDAV and the source value should be then /DAV/home/demo/mc.ics
   1. As result the publication will be created and will be shown its id (for ex. 2). 
   1. To synchronize you can use ubiquity command or the Calendar UI:
      1. Using the ubiquity sync command:
         1. Execute the command:
<verbatim>
ods-sync-calendar-publication 2
</verbatim>
         1. As result should be shown message for Success.
      1. Using the Calendar UI:
         1. Go to http://demo.openlinksw.com/ods
         1. Log in as demo password demo
         1. Go to Calendar
         1. Go to Import/Export-> Manage Publications
         1. Click the button "Sync" for "<nowiki>MyCalendar</nowiki>" publication.
         1. As result a synchronization will be performed.
            * <img src="%ATTACHURLPATH%/c8.png" style="wikiautogen"/>
   1. Go to Briefcase
   1. As result in the list will be shown the mc.ics file which contains user demo's Calendar from its [[http://demo.openlinksw.com/ods][Demo server]] Calendar instance.         
      * <img src="%ATTACHURLPATH%/c9.png" style="wikiautogen"/>

---+++Basic Tutorial Steps

   1. Authenticate using ODS command mode:
      1. *sid*:
         1. Execute the command:
<verbatim>
ods-host http://myopenlink.net:8890/ods
</verbatim>
            * <img src="%ATTACHURLPATH%/u7.png" style="wikiautogen"/>
         1. Execute the command:
<verbatim>
ods-set-mode sid
</verbatim>
            * <img src="%ATTACHURLPATH%/u2.png" style="wikiautogen"/>
         1. Execute the command:
<verbatim>
ods-authenticate-user demo with demo
</verbatim>
            * <img src="%ATTACHURLPATH%/u3.png" style="wikiautogen"/>
      1. *oauth*: detailed description you can find [[VirtuosoOdsUbiquityTutorialsCalendarOAuthM][here]].
   1. Execute the command:
<verbatim>
ods-get-instance-id demo's Calendar 
</verbatim>
      * <img src="%ATTACHURLPATH%/c4.png" style="wikiautogen"/>
   1. As result will be shown the instance id. For the "demo's Calendar" instance this should be 522.
   1. Execute the command:
<verbatim>
ods-import-calendar 522 source /DAV/home/demo/mc.ics sourceType WebDAV

or execute:

ods-create-calendar-subscription 522 name MyNewCalendar sourceType URL source http://demo.openlinksw.com/DAV/home/demo/mc.ics  userName demo userPassword demo
</verbatim>
      * <img src="%ATTACHURLPATH%/c10.png" style="wikiautogen"/>
   1. As result should be shown message for Success and subscription id for ex.14. 
   1. Now let's perform synchronization of this subscription in the Calendar instance for user demo at the [[http://myopenlink.net:8890/ods][MyOpenlink server]]. To synchronize you can use ubiquity command or the Calendar UI:
      1. Using the ubiquity sync command:
         1. Execute the command:
<verbatim>
ods-sync-calendar-subscription 14
</verbatim>
         1. As result should be shown message for Success.
      1. Using the Calendar UI:
         1. Go to http://myopenlink.net:8890/ods
         1. Log in as demo with password demo
         1. Go to Calendar
         1. Go to Import/Export->Manage Subscriptions
         1. Click the "Sync" button for the "<nowiki>MyNewCalendar</nowiki>" subscription
         1. As result he synchronization will be performed and for the subscription will be shown status "Ok":
            * <img src="%ATTACHURLPATH%/c11.png" style="wikiautogen"/>
   1. Go to Calendar Tasks for ex.
   1. As result will be shown the imported from the subscription Calendar tasks.
      * <img src="%ATTACHURLPATH%/c12.png" style="wikiautogen"/>
   

CategoryODS CategoryOpenSource CategoryWebSite CategoryOdsCalendar CategoryCalendar