%VOSWARNING%


---++Bookmarks Publication Ubiquity Tutorial

This tutorial demonstrates how to make publication from OpenLink [[http://demo.openlinksw.com/ods][Demo server]] Bookmark instance for user demo and import the data to [[http://myopenlink.net:8890/ods][MyOpenlink server]] Bookmark 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 Bookmark instance for user demo at the [[http://demo.openlinksw.com/ods][Demo server]] and there should be ODS Bookmark 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 Bookmarks from the left ODS Vertical Main Navigation. This will cause automatically to be created ODS Bookmark instance.

---+++Basic Tutorial Steps

   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 [[VirtuosoOdsUbiquityTutorialsBookmarkOAuthD][here]].
   1. Execute the command:
<verbatim>
ods-get-instance-id mybookmarks
</verbatim>
      * <img src="%ATTACHURLPATH%/u4.png" style="wikiautogen"/>
   1. As result will be shown the instance id. For the "mybokmarks" instance this should be 7.
   1. Execute the command:
<verbatim>
ods-create-bookmarks-publication 7 name MyBookmarks destinationType Url destination http://myopenlink.net:8890/DAV/home/demo/mybookmarks.xml userName demo userPassword demo
</verbatim>
      * <img src="%ATTACHURLPATH%/u5.png" style="wikiautogen"/>
      * Note that you can also set destination Type to WebDAV and destination to /DAV/home/demo/bk.xml for ex. In this case, several steps below when the user tries to import the data from the bk.xml file, need to set as sourceType URL and the source value should be then http://demo.openlinksw.com/DAV/home/demo/bk.xml
   1. As result the publication will be created and will be shown its id (for ex. 12). 
   1. To synchronize you can use ubiquity command or the Bookmarks UI:
      1. Using the ubiquity sync command:
         1. Execute the command:
<verbatim>
ods-sync-bookmarks-publication 12
</verbatim>
         1. As result should be shown message for Success.
      1. Using the Bookmarks UI:
         1. Go to http://demo.openlinksw.com/ods
         1. Log in as demo password demo
         1. Go to Bookmarks
         1. Go to Preferences->Publications
         1. Click the button "Sync" for "<nowiki>MyBookmarks</nowiki>" publication.
         1. As result a synchronization will be performed.
            * <img src="%ATTACHURLPATH%/u6.png" style="wikiautogen"/>
   1. Now let's get the bookmarks to <nowiki>MyOpenlink</nowiki> ODS Bookmarks instance.
   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 [[VirtuosoOdsUbiquityTutorialsBookmarkOAuthM][here]].
   1. Execute the command:
<verbatim>
ods-get-instance-id demo's Bookmarks
</verbatim>
      * <img src="%ATTACHURLPATH%/u8.png" style="wikiautogen"/>
   1. As result will be shown the instance id. For the "demo's Bookmarks" instance this should be 519.
   1. Execute the command:
<verbatim>
ods-import-bookmarks 519 source /DAV/home/demo/mybookmarks.xml sourceType WebDAV
</verbatim>
      * <img src="%ATTACHURLPATH%/u9.png" style="wikiautogen"/>
   1. As result should be shown message for Success. Let's check the Bookmarks instance for user demo at the [[http://myopenlink.net:8890/ods][MyOpenlink server]] .
   1. Go to http://myopenlink.net:8890/ods
   1. Log in as demo with password demo
   1. Go to Bookmarks
   1. As result in the 1st pane under Tree->Bookmarks will be shown the imported Bookmarks from the demo server Bookmarks instance for user demo.
      * <img src="%ATTACHURLPATH%/u10.png" style="wikiautogen"/>

CategoryODS CategoryOpenSource CategoryWebSite CategoryOdsBookmark CategoryBookmark