Addressbook Subscription Ubiquity Tutorial This tutorial demonstrates how to subscribe from OpenLink Demo server Addressbook instance for user demo to MyOpenlink server Addressbook for user demo. Ubiquity Commands Subscription If not already subscribed, perform the following steps: Go to http://demo.openlinksw.com/ods/ods_ubiquity.html Click the button "Subscribe" Click the button "I know what I'm doing. Subscribe to it". 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. 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. Authenticate using ODS command mode: sid: Execute the command: ods-host http://demo.openlinksw.com/ods

Execute the command: ods-set-mode sid

Execute the command: ods-authenticate-user demo password demo

oauth: detailed description you can find here. Execute the command: ods-get-instance-id demo's AddressBook

As result will be shown the instance id. For the "demo's AddressBook" instance this should be 36. Execute the command: ods-create-addressbook-publication 36 name MyContacts destinationType WebDAV destination /DAV/home/demo/mc.vcf userName demo userPassword demo

Note that you can also set destination Type to URL and destination to http://myopenlink.net:8890/DAV/home/demo/mc.vcf for ex. In this case, several steps below when the user tries to subscribe for the contacts in mc.vcf file, need to set as sourceType WebDAV and the source value should be then /DAV/home/demo/mc.vcf As result the publication will be created and will be shown its id (for ex. 4). To synchronize you can use ubiquity command or the Addressbook UI: Using the ubiquity sync command: Execute the command: ods-sync-addressbook-publication 4 As result should be shown message for Success. Using the Addressbook UI: Go to http://demo.openlinksw.com/ods Log in as demo password demo Go to Addressbook Go to Preferences->Publications Click the button "Sync" for "MyContacts" publication. As result a synchronization will be performed. *

Go to Briefcase As result in the list will be shown the mc.vcf file which contains user demo's contacts from its Demo server Addressbook instance.

Basic Tutorial Steps Authenticate using ODS command mode: sid: Execute the command: ods-host http://myopenlink.net:8890/ods

Execute the command: ods-set-mode sid

Execute the command: ods-authenticate-user demo password demo

oauth: detailed description you can find here. Execute the command: ods-get-instance-id demo's AddressBook

As result will be shown the instance id. For the "demo's AddressBook" instance this should be 517. Execute the command: ods-import-addressbook 517 source /DAV/home/demo/mc.vcf sourceType WebDAV or execute: ods-create-addressbook-subscription 517 name MyNewContacts sourceType Url source http://demo.openlinksw.com/DAV/home/demo/mc.vcf userName demo userPassword demo

As result should be shown message for Success and subscription id for ex.8. Now let's perform synchronization of this subscription in the Addressbook instance for user demo at the MyOpenlink server. To synchronize you can use ubiquity command or the Addressbook UI: Using the ubiquity sync command: Execute the command: ods-sync-addressbook-subscription 8 As result should be shown message for Success. Using the Addressbook UI: Go to http://myopenlink.net:8890/ods Log in as demo with password demo Go to Addressbook Go to Preferences->Subscriptions Click the "Sync" button for the "MyNewContacts" subscription As result he synchronization will be performed and for the subscription will be shown status "Ok":

Go to My Contacts. As result in the 1st pane uwill be shown the imported from the subscription contacts.