Model schemas for addressing resources

Model schemas for addressing resources

Addressing a resource includes specifying the model to which the resource is associated. To do this, we specify a schema.
There is a schema defined for each modes that the remote model SPI supports:

For addressing a resource in the content model: cm

For addressing a resource in the navigation model: nm

For addressing a resource in the layout model: lm

For addressing a resource in the portlet model: pm

Furthermore, specify the resource of the model itself, as described in the following resource addressing specification:
model-uri = "cm:" page-oid | 
            "nm:" navigationnode-oid | 
            "lm:" [layoutnode-oid "@"] page-oid | 
            "pm:" portlet-oid ["@" page-oid
The meanings of the syntax elements are as follows:

page-oid

This is the portal object ID of a content page. When we address portlet model resources, this is required for portlet windows, but it must not occur for any other portlet model resource identification.

navigationnode-oid

This is the object ID of a navigation model node.

layoutnode-oid

This is the object ID of a layout model node.

portlet-oid

This is the object ID of a layout control, portlet window, portlet entity, or portlet definition.

oid

This is the serialized string that represents a portal object ID. This is URI-escaped with UTF-8 encoding. The character @ is also escaped using %40. We can also use unique names instead of object IDs. Unique names also have to be URI-escaped, and the @ character must be escaped. Note that every object ID has the defined scheme 'oid:'.

Note that the model schemes are mandatary for ambiguity reasons.
For example content and navigation nodes currently have got the same object IDs.
Example 1: To obtain a feed of the root node of content models that is the content node with the unique name wps.content.root, send an HTTP GET request to the following URL:
/wps/mycontenthandler?uri=cm:oid:wps.content.root
Example 2: To obtain a feed of the layout node with the object id '_7_0830M4HTFF0SHFCQ_2BV' on the content page with the object id '_6_0830M4HTFF0SHFCQ_4D', send an HTTP GET request to the following URL:
/wps/mycontenthandler?uri=lm:oid:_7_0830M4HTFF0SHFCQ_2BV@oid:_6_0830M4HTFF0SHFCQ_4D
Parent: Syntax for addressing portal resources
Related:
Additional query parameters