Basic addressing

Portal users can address resources that have been registered with the tagging and rating engine.

Users can address resources, tags, tag spaces, ratings, and rating spaces. They can either address all entities part of these five models or start with an empty set of these models and add single entities by adding additional query parameters. For details refer to the topic about Adding query parameters.

The URL that is to be used for addressing resources is as follows:
http://host:port/wps/mycontenthandler?uri=uri
Valid URIs are given in the following sections.

Addressing resources

To address resources, use the following URIs:
rm:all
This returns a feed that contains all resources that are registered with the tagging and rating engine. A resource is registered with the tagging and rating engine when a user tags or rates it at least once. Note that using this operation can be rather expensive, depending on the amount of registered resources. Sample feed:
<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:thr="http://purl.org/syndication/thread/1.0" 
   xmlns:xhtml="http://www.w3.org/1999/xhtml" 
   xmlns:atom="http://www.w3.org/2005/Atom" 
   xmlns:model="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model-elements" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model" 
   xmlns:cp="http://www.ibm.com/xmlns/prod/websphere/portal/v7.0/portal-contextual-portal" 
   xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
   xmlns:base="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0/ibm-portal-composite-base">
      <atom:author>
         <atom:name>HCL Digital Experience Portal/78.0</atom:name>
      </atom:author>
      <atom:id>rm:all</atom:id>
      <atom:link href="/wps/mypoc/!ut/p/digest!YlBr3X0WY5DZfagM7Jz3_A/rm/all?mode=download" 
         rel="self" type="application/atom+xml"/>
      <atom:title>WebSphere Portal Server Resource Feed</atom:title>
      <atom:updated>2009-12-21T23:20:05.503Z</atom:updated>
      <atom:entry>
         <atom:title xml:lang="en">A sample page</atom:title>
         <atom:id cp:oid="7_2QC68B1A086070IK5UQSRK20O4">
            rm:pm:oid:7_2QC68B1A086070IK5UQSRK20O4</atom:id>
         <atom:published>2009-12-21T22:51:16.469Z</atom:published>
         <atom:updated>2009-12-21T22:51:16.548Z</atom:updated>
         <atom:link portal:uri="pm:oid:7_2QC68B1A086070IK5UQSRK20O4" 
             href="/wps/mypoc/!ut/p/digest!YlBr3X0WY5DZfagM7Jz3_A/pm/oid:
             7_2QC68B1A086070IK5UQSRK20O4?mode=view" 
             type="application/atom+xml"/>
</atom:entry>
rm:empty
This returns a feed that represents the empty set of resources. You can add individual resources to this feed by adding additional query parameters.
rm:type_schema:ssp
This returns a feed that represents a single unique resource. Samples:
  • For a portal resource: rm:nm:oid:oid_of_a_page . This URI addresses a portal content node.
  • For a custom resource: rm:dvd:rambo . This addresses a custom resource of some kind.

Addressing tags

To address tags, use the following URIs:
tm:all
This returns a feed that contains all available tags. Note that using this operation can be rather expensive depending on the amount of registered tags. Sample feed:
<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:thr="http://purl.org/syndication/thread/1.0" 
   xmlns:xhtml="http://www.w3.org/1999/xhtml" 
   xmlns:atom="http://www.w3.org/2005/Atom" 
   xmlns:model="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model-elements" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model" 
   xmlns:cp="http://www.ibm.com/xmlns/prod/websphere/portal/v7.0/portal-contextual-portal" 
   xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
   xmlns:base="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0/ibm-portal-composite-base">
      <atom:author>
         <atom:name>HCL Digital Experience Portal/78.0</atom:name>
      </atom:author>
      <atom:id>tm:all</atom:id>
      <atom:link href="/wps/mypoc/!ut/p/digest!YlBr3X0WY5DZfagM7Jz3_A/tm/all?mode=download" 
         rel="self" type="application/atom+xml"/>
      <atom:title>WebSphere Portal Server Tag Feed</atom:title>
      <atom:updated>2009-12-21T23:36:52.805Z</atom:updated>
      <atom:entry>
         <atom:title xml:lang="en">sampleTag</atom:title>
         <atom:author>
            <atom:name>wpsadmin</atom:name>
            <atom:uri>um:oid:9eAeK9O86O07M1E6JMG6GHC2JMG61JOIJM4CM1C0JM8CL9E8JO07NHCAJQ86K1</atom:uri>
         </atom:author>
         <atom:id cp:scope="COLLABORATIVE">tm:oid:CI_2QC68B1A086070IK5UQSRK2040</atom:id>
         <atom:published>2009-12-21T22:50:36.509Z</atom:published>
         <atom:updated>2009-12-21T22:50:36.509Z</atom:updated>
         <atom:link portal:uri="tm:oid:CI_2QC68B1A086070IK5UQSRK20O7"  
            portal:rel="rm" href="/wps/mypoc/!ut/p/digest!YlBr3X0WY5DZfagM7Jz3_A/rm/oid:
            7_2QC68B1A086070IK5UQSRK2084?mode=download" rel="replies" type="application/atom+xml"/>
         <atom:link portal:uri="tm:oid:CI_2QC68B1A086070IK5UQSRK2040" 
            href="/wps/mypoc/!ut/p/digest!YlBr3X0WY5DZfagM7Jz3_A/tm/oid:
            CI_2QC68B1A086070IK5UQSRK2040?mode=download" type="application/atom+xml"/>
</atom:entry>
tm:empty
This returns a feed that represents the empty set of tags. You can add individual tags to this feed by adding additional query parameters.
tm:name:tag_name
This returns a feed that contains all tags that match the name tagname.
tm:oid:oid_of_a_tag
This returns a feed that represents a single unique tag with the ID oid_of_a_tag.

Addressing tag spaces

Unlike the tag model, the tag space model does not contain information about which user has assigned a certain tag or to which concrete resource a tag has been assigned. A tag space represents only the association between a tag name and its count. Therefore tag spaces are useful to aggregate tag clouds. Use the following URIs:
tm:ts:all
This returns a feed that contains all available tag spaces, that is all available tags and their names and counts. Sample feed:
<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:thr="http://purl.org/syndication/thread/1.0" 
  xmlns:xhtml="http://www.w3.org/1999/xhtml" 
  xmlns:atom="http://www.w3.org/2005/Atom" 
  xmlns:model="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model-elements" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model" 
  xmlns:cp="http://www.ibm.com/xmlns/prod/websphere/portal/v7.0/portal-contextual-portal" 
  xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
  xmlns:base="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0/ibm-portal-composite-base">
    <atom:author>
      <atom:name>HCL Digital Experience Portal/78.0</atom:name>
    </atom:author>
    <atom:id>tm:ts:all</atom:id>
    <atom:link href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/tm/ts:all?mode=download" 
      rel="self" type="application/atom+xml"/>
    <atom:title>WebSphere Portal Server TagSpace Feed</atom:title>
    <atom:updated>2009-12-22T00:00:12.868Z</atom:updated>
    <atom:entry>
      <atom:title>sampleTag</atom:title>
      <atom:id>tm:name:bread</atom:id>
      <atom:published>2009-12-21T22:50:51.698Z</atom:published>
      <atom:updated>2009-12-21T22:50:51.698Z</atom:updated>
      <atom:content type="application/xml">
        <cp:tagspace>
          <cp:supportedLocale>en</cp:supportedLocale>
        </cp:tagspace>
      </atom:content>
      <atom:link thr:count="1" thr:isMine="true" portal:uri="rm:empty" 
        portal:rel="rm" 
        href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rm/empty?mode=download&tmparam=tm%3aname%3abread" 
        rel="replies" type="application/atom+xml"/>
      <atom:link thr:count="1" thr:isMine="true" portal:uri="rm:empty" 
        portal:rel="rm" 
        href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rm/empty?mode=view&tmparam=tm%3aname%3abread" 
        rel="replies" type="text/html"/>
      <atom:link portal:uri="tm:name:bread" 
        href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/tm/name:bread?mode=download" 
        type="application/atom+xml"/>
</atom:entry>
tm:ts:empty
This returns a feed that represents the empty set of tag spaces. You can add individual tag spaces to this feed by adding additional query parameters.

Addressing ratings

To address ratings, use the following URIs:
rtm:all
This returns a feed that contains all available ratings. Note that using this operation can be rather expensive depending on the amount of registered ratings. Sample feed:
<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:thr="http://purl.org/syndication/thread/1.0" 
  xmlns:xhtml="http://www.w3.org/1999/xhtml" 
  xmlns:atom="http://www.w3.org/2005/Atom" 
  xmlns:model="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model-elements" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model" 
  xmlns:cp="http://www.ibm.com/xmlns/prod/websphere/portal/v7.0/portal-contextual-portal" 
  xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
  xmlns:base="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0/ibm-portal-composite-base">
    <atom:author>
      <atom:name>HCL Digital Experience Portal/78.0</atom:name>
    </atom:author>
    <atom:id>rtm:all</atom:id>
    <atom:link href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rtm/all?mode=download" 
      rel="self" type="application/atom+xml"/>
    <atom:title>WebSphere Portal Server Rating Feed</atom:title>
    <atom:updated>2009-12-21T23:53:53.912Z</atom:updated>
    <atom:entry>
      <atom:title>4</atom:title>
      <atom:author>
        <atom:name>wpsadmin</atom:name>
        <atom:uri>um:oid:9eAeK9O86O07M1E6JMG6GHC2JMG61JOIJM4CM1C0JM8CL9E8JO07NHCAJQ86K1</atom:uri>
      </atom:author>
      <atom:id cp:scope="COLLABORATIVE">rtm:oid:CJ_2QC68B1A086070IK5UQSRK20C4</atom:id>
      <atom:published>2009-12-21T23:53:18.830Z</atom:published>
      <atom:updated>2009-12-21T23:53:18.830Z</atom:updated>
      <atom:link portal:uri="rtm:oid:CJ_2QC68B1A086070IK5UQSRK20C4" 
        ortal:rel="rm" href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rm/oid:
        6_CGAH47L0003H80IKPQVPKO0GS3?mode=download" rel="replies" type="application/atom+xml"/>
      <atom:link portal:uri="rtm:oid:CJ_2QC68B1A086070IK5UQSRK20C4" 
        href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rtm/oid:
        CJ_2QC68B1A086070IK5UQSRK20C4?mode=download" type="application/atom+xml"/>
</atom:entry>
rtm:empty
This returns a feed that represents the empty set of ratings. You can add individual ratings to this feed by adding additional query parameters.
rtm:oid:oid_of_a_rating
This returns a feed that represents a single unique rating with the ID oid_of_a_rating.

Addressing rating spaces

Unlike the rating model, the rating space model does not contain information about which user has assigned a certain rating or to which concrete resource a rating has been assigned. A rating space represents only the association between a rating value and its count. Use the following URIs:
rtm:rs:all
This returns a feed that contains all available rating spaces, that is all available ratings and their values and counts. Sample feed:
<?xml version="1.0" encoding="UTF-8"?>
<atom:feed xmlns:thr="http://purl.org/syndication/thread/1.0" 
   xmlns:xhtml="http://www.w3.org/1999/xhtml" 
   xmlns:atom="http://www.w3.org/2005/Atom" 
   xmlns:model="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model-elements" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:portal="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0.1/portal-model" 
   xmlns:cp="http://www.ibm.com/xmlns/prod/websphere/portal/v7.0/portal-contextual-portal" 
   xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" 
   xmlns:base="http://www.ibm.com/xmlns/prod/websphere/portal/v6.0/ibm-portal-composite-base">
      <atom:author>
         <atom:name>HCL Digital Experience Portal/78.0</atom:name>
      </atom:author>
      <atom:id>rtm:rs:all</atom:id>
      <atom:link href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rtm/rs:all?mode=download" 
         rel="self" type="application/atom+xml"/>
      <atom:title>WebSphere Portal Server RatingSpace Feed</atom:title>
      <atom:updated>2009-12-22T00:13:40.386Z</atom:updated>
      <atom:entry>
         <atom:title>4</atom:title>
         <atom:id>rtm:value:4</atom:id>
         <atom:published>2009-12-21T23:53:18.830Z</atom:published>
         <atom:updated>2009-12-21T23:53:18.830Z</atom:updated>
         <atom:link thr:count="1" thr:isMine="true" portal:uri="rm:empty" 
            portal:rel="rm" 
            href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rm/empty?mode=
                download&rtmparam=rtm%3avalue%3a4" 
            rel="replies" type="application/atom+xml"/>
         <atom:link 
            portal:uri="rtm:value:4" 
            href="/wps/mypoc/!ut/p/digest!vLQAhj2WCgHcg0_gV7N7XQ/rtm/value:4?mode=download" 
            type="application/atom+xml"/>
</atom:entry>
rtm:rs:empty
This returns a feed that represents the empty set of rating spaces. You can add individual rating spaces to this feed by adding additional query parameters.