Addressbook Publication Ubiquity Tutorial

This tutorial demonstrates how to make publication from OpenLink Demo server Addressbook instance for user demo and import the data to MyOpenlink server Addressbook 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 Addressbook instance for user demo at the Demo server and there should be ODS Addressbook instance for user demo at the MyOpenlink server. If not existing, it is enough after log in to go to Addressbook from the left ODS Vertical Main Navigation. This will cause automatically to be created ODS Addressbook instance.

Basic Tutorial Steps

1. Authenticate using ODS command mode:
   1. sid:
      1. Execute the command:
         

         
         ods-host http://demo.openlinksw.com/ods
         

         
         
         • 
      2. Execute the command:
         

         
         ods-set-mode sid
         

         
         
         • 
      3. Execute the command:
         

         
         ods-authenticate-user demo password demo
         

         
         
         • 
   2. oauth: detailed description you can find here.
2. Execute the command:
   

   
   ods-get-instance-id demo's AddressBook
   

   
   
   • 
3. As result will be shown the instance id. For the "demo's AddressBook" instance this should be 36.
4. Execute the command:
   

   
   ods-create-addressbook-publication 36 name MyContacts destinationType URL destination http://myopenlink.net:8890/DAV/home/demo/mycontacts.vcf userName demo userPassword demo
   

   
   
   • 
   • Note that you can also set destination Type to WebDAV and destination to /DAV/home/demo/mycontacts.vcf for ex. In this case, several steps below when the user tries to import the data from the mycontacts.vcf file, need to set as sourceType URL and the source value should be then http://demo.openlinksw.com/DAV/home/demo/mycontacts.vcf
5. As result the publication will be created and will be shown its id (for ex. 6).
6. To synchronize you can use ubiquity command or the Addressbook UI:
   1. Using the ubiquity sync command: 1. Execute the command:
      

      
      ods-sync-addressbook-publication 6
      

      
      1. As result should be shown message for Success.
   2. Using the Addressbook UI:
      1. Go to http://demo.openlinksw.com/ods
      2. Log in as demo password demo
      3. Go to AddressBook
      4. Go to Preferences->Publications
      5. Click the button "Sync" for "MyContacts " publication.
      6. As result a synchronization will be performed.
         • 
7. Now let's get the contacts to MyOpenlink ODS Addressbook instance.
8. Authenticate using ODS command mode:
   1. sid:
      1. Execute the command:
         

         
         ods-host http://myopenlink.net:8890/ods
         

         
         
         • 
      2. Execute the command:
         

         
         ods-set-mode sid
         

         
         
         • 
      3. Execute the command:
         

         
         ods-authenticate-user demo password demo
         

         
         
         • 
   2. oauth: detailed description you can find here.
9. Execute the command:
   

   
   ods-get-instance-id demo's AddressBook
   

   
   
   • 
10. As result will be shown the instance id. For the "demo's Addressbook" instance this should be 517.
11. Execute the command:
    

    
    ods-import-addressbook 517 source /DAV/home/demo/mycontacts.vcf sourceType WebDAV
    

    
    
    • 
12. As result should be shown message for Success. Let's check the Addressbook instance for user demo at the MyOpenlink server .
13. Go to http://myopenlink.net:8890/ods
14. Log in as demo with password demo
15. Go to Addressbook
16. As result in "My Contacts" list will be shown the imported contacts.
    •