VOS.VirtuosoOdsUbiquityTutorialsSubscrAddressbook

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:

  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.

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:

        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 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
  5. As result the publication will be created and will be shown its id (for ex. 4).
  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 4

      2. 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. Go to Briefcase
  8. 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

  1. 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.
  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 517.
  4. 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

  5. As result should be shown message for Success and subscription id for ex.8.
  6. 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:
    1. Using the ubiquity sync command:
      1. Execute the command:

        ods-sync-addressbook-subscription 8

      2. As result should be shown message for Success.
    2. Using the Addressbook UI:
      1. Go to http://myopenlink.net:8890/ods
      2. Log in as demo with password demo
      3. Go to Addressbook
      4. Go to Preferences->Subscriptions
      5. Click the "Sync" button for the "MyNewContacts" subscription
      6. As result he synchronization will be performed and for the subscription will be shown status "Ok":
  7. Go to My Contacts.
  8. As result in the 1st pane uwill be shown the imported from the subscription contacts.