---+ODS Ubiquity Commands %TOC% ---++ What is the ODS Ubiquity Commands implementation? ODS provides Ubiquity commands to manipulate user accounts as well as instances and instance specific data using the ODS Controllers API. This command set is available only for the Firefox browser with the Ubiquity extension installed. ---++ How does it work? ---+++ Installation First, the [[https://wiki.mozilla.org/Labs/Ubiquity][Ubiquity]] Firefox extension must be installed. Then, ODS Ubiquity commands can be installed by accessing http://host:port/ods/ods_ubiquity.html page. Ubiquity commands are accessed by the ctrl-space key combination. ---++ Commands ---+++ Utility Commands 1 show current ODS Ubiquity params: Syntax: ods-get-params Example: ods-get-params 1 enable log command execution - steps and parameters. The log can be shown on Firebug console: Syntax: ods-log-enable Example: ods-log-enable 1 disable log command execution: Syntax: ods-log-disable Example: ods-log-disable ---+++ Basic Session Setup Commands ---++++ ODS Instance Identification Assuming you are using the server at: http://myopenlink.net/, in order to change it use the command: Syntax: ods-host Example: ods-host http://demo.openlinksw.com/ods Example usage you can find [[VirtuosoOdsUbiquityTutorialsPublBookmark][here]]. ---++++ ODS OAuth Endpoint Identification Assuming the OAuth endpoint: http://myopenlink.net/OAuth, in order to change it use the command: Syntax: ods-oauth-host Example: ods-oauth-host http://demo.openlinksw.com/OAuth Example usage you can find [[VirtuosoOdsUbiquityTutorialsOAuth][here]]. ---++++ ODS Command Mode There are two command modes available to ubiquity commands when working against an ODS instance: oauth or sid. In OAuth mode, for every ODS application instance, an OAuth key must be obtained and then initialized via the following steps: 1 obtain an ODS based OAuth session-key via the ODS example endpoint: http://host:port/ods/oauth_sid.vsp http://myopenlink.net/ods/oauth_sid.vsp 1 bind session key to command session via the command: *ods-set-oauth <oauth-key>* or use *ods-set-[class name]-oauth <oauth-key>* when oauth-key was generated for particular application instance. * Example usage you can find [[VirtuosoOdsUbiquityTutorialsOAuth][here]]. If you choose the SID mode of interaction with ODS you have to perform the following steps: 1 set mode via command: *ods-set-mode sid* or *ods-set-mode oauth* 1 set sid via command: *ods-set-sid sid* * Example usage you can find [[VirtuosoOdsUbiquityTutorialsPublBookmark][here]]. *Note*: The sid is a session ID applicable to all ODS commands for a given bound instance and user combination. It's obtained from an ODS session. ---+++ODS Application Commands By Functionality Realm ---++++ ODS Object Information 1 get information for ODS object by uri: *ods-get-uri-info*: Syntax: ods-get-uri-info Example: ods-get-uri-info http://myopenlink.net/dataspace/person/kidehen ---++++ User Management 1 create user in ODS: *ods-create-user*: Syntax: ods-create-user password email Example: ods-create-user test password test email test@openlinksw.com 1 authenticate user in ODS: *ods-authenticate-user*: Syntax: ods-authenticate-user with Example: ods-authenticate-user demo with demo * Example usage you can find [[VirtuosoOdsUbiquityTutorialsPublCalendar][here]]. 1 get user info: *ods-get-user test*: Syntax: ods-get-user Example: ods-get-user test 1 enable user: *ods-enable-user*: Syntax: ods-enable-user Example: ods-enable-user test 1 disable user: *ods-disable-user*: Syntax: ods-disable-user Example: ods-disable-user test 1 user removal: *ods-delete-user*: Syntax: ods-delete-user Example: ods-delete-user test ---++++ User Annotations 1 new annotation: Syntax: ods-create-user-annotation has with Example: ods-create-user-annotation http://yahoo.com has see:Also with test 1 remove existing annotation: Syntax: ods-delete-user-annotation has with Example: ods-delete-user-annotation http://yahoo.com has see:Also with test ---++++ User Topic Of Interests 1 new topic of interest: Syntax: ods-create-user-topicOfInterest [label ] Example: ods-create-user-topicOfInterest http://yahoo.com label Yahoo Search Engine 1 remove existing topic of interest: Syntax: ods-delete-user-topicOfInterest Example: ods-delete-user-topicOfInterest http://yahoo.com ---++++ User Thing Of Interests 1 new thing of interest: Syntax: ods-create-user-thingOfInterest [label ] Example: ods-create-user-thingOfInterest http://facefook.com 1 remove existing thing of interest: Syntax: ods-delete-user-thingOfInterest Example: ods-delete-user-thingOfInterest http://facefook.com ---++++ User Biographical Data 1 new annotation: Syntax: ods-create-user-bioevent on in Example: ods-create-user-bioevent bio:Birth on 1970-01-01 in London 1 remove existing annotation: Syntax: ods-delete-user-bioevent on in Example: ods-delete-user-bioevent bio:Birth on 1970-01-01 in London ---++++ User's OfferList 1 new offer: Syntax: ods-create-user-offer [comment ] Example: ods-create-user-offer LCD Monitor 1 new offer property: Syntax: ods-create-user-offer-property property value Example: ods-create-user-offer-property LCD Monitor property gr:price value $199.95 1 remove existing offer property: Syntax: ods-delete-user-offer-property property Example: ods-delete-user-offer-property LCD Monitor property gr:price 1 remove existing offer: Syntax: ods-delete-user-offer Example: ods-delete-user-offer LCD Monitor ---++++ User's WishList 1 new thing of interest: Syntax: ods-create-user-wish type [comment ] Example: ods-create-user-wish Keyboard type wishs 1 remove existing wish: Syntax: ods-delete-user-wish Example: ods-delete-user-wish Keyboard ---++++ Instance Management 1 get instance id: *ods-get-instance-id*: Syntax: ods-get-instance-id Example: ods-get-instance-id demo's Bookmarks * Example usage you can find at [[VirtuosoOdsUbiquityTutorials][Tutorials section]]. 1 freeze instance: *ods-freeze-instance*: Syntax: ods-freeze-instance Example: ods-freeze-instance 10 1 unfreeze instances: *ods-unfreeze-instance*: Syntax: ods-freeze-instance Example: ods-unfreeze-instance 10 ---+++ Briefcase * [[VirtuosoOdsUbiquityBriefcase][Briefcase Ubiquity Commands]] ---+++ Bookmarks * [[VirtuosoOdsUbiquityBookmarks][Bookmarks Ubiquity Commands]] ---+++ Calendar * [[VirtuosoOdsUbiquityCalendar][Calendar Ubiquity Commands]] ---+++Addressbook * [[VirtuosoOdsUbiquityAddressbook][Addressbook Ubiquity Commands]] ---+++ Polls * [[VirtuosoOdsUbiquityPolls][Polls Ubiquity Commands]] ---+++ Weblog * [[VirtuosoOdsUbiquityWeblog][Weblog Ubiquity Commands]] ---+++Feed Manager * [[VirtuosoOdsUbiquityFeeds][Feed Manager Ubiquity Commands]] ---+++Discussion * [[VirtuosoOdsUbiquityDiscussion][Discussion Ubiquity Commands]] ---+++Gallery * [[VirtuosoOdsUbiquityGallery][Gallery Ubiquity Commands]] ---++Learn More * [[VirtuosoOdsUbiquityTutorials][Virtuoso ODS Ubiquity Commands Tutorials]] ---++References * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/OAuth][OpenLink's explanation of OAuth]] * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtuosoOAuthServer][Virtuoso OAuth server]] * [[VirtOAuthControllers][Using OAuth with ODS]] * [[http://virtuoso.openlinksw.com/dataspace/dav/wiki/Main/VirtOAuth][Virtuoso OAuth Implementation]] * [[VirtuosoOdsControllers][ODS Controllers]] * [[VirtODSOAuthQA][Testing Virtuoso OAuth with 3rd Party OAuth Clients]] * [[VirtuosoOdsUbiquityTutorialsOAuth][OAuth Ubiquity Tutorial]] * [[VirtOAuthTestTool][Virtuoso OAuth Test Tool for ODS Controllers]] * [[http://virtuoso.openlinksw.com/wiki/main/Main/VirtOAuthSPARQL][Virtuoso SPARQL OAuth Tutorial]] * [[VirtuosoOdsUbiquityTutorials][ODS Ubiquity Tutorials]] * [[VirtOAuthExamples][OAuth Applications Authentication examples]] * [[http://oauth.net/core/1.0/][OAuth API]] CategoryODS CategoryOpenSource CategoryWebSite