C.1 Path-Based URLs

A path-based URL is formed by identifying the path taken through the portal to get to a particular object. This uses object names in the URL and thus, if the name of an object within the path is changed, the URL will no longer be valid. Path-based URLs can be formed for these types of objects:

Pages

Tabs

Items

Portal Templates

Navigation pages

Category pages

Perspective pages

This section parses the format used for path-based URLs and provides examples of how they are formed when targeting portal objects. It includes the following subsections:

Should users request a language for which there is no translation, an error message displays:

The language specified in the URL is not currently supported by this Portal. (WWC-57383)

version is the version of the item. Version is optional and is used only with items. The value is a number or STAGE, DRAFT, or REJECTED. For example:

­…/ver-2/…
…/ver-STAGE/…
…/ver-DRAFT/…
…/ver-REJECTED/…

Note:

If the URL specifies a version of an item that does not exist, the current version of the item is displayed, except as noted in the following paragraph.

When the STAGE, DRAFT, or REJECTED version is specified in a path-based URL, the item is rendered according to the following rules:

STAGE—First the pending version of the item is rendered; then, if there is no pending version, the current version of the item is rendered.

DRAFT—First the draft version of the item is rendered; then, if there is no draft version (or it is not available), the pending version of the item is rendered; finally, if there is no pending version, the current version of the item is rendered.

REJECTED—First the rejected version of the item is rendered; then, if there is no rejected version, the current version of the item is rendered.

The format of path-based URLs for tabs is very similar to that used for pages. The difference is that the active tab list is added to the end of the host page URL. The active tab list indicates the hierarchy of tabs. Tabs are divided from their sub-tabs by colons; tab sets are divided from additional tab sets by commas:

When the URL targets a tab, the path uses colons to separate a tab from its sub-tab; when the URL traverses a tab to get to an item on a sub-tab, the path uses a slash (/) in lieu of a comma. See "Path-Based URLs for Items" for an example.

To render page1a with the tabs Sales:Divisions and Manufacturing:Schedules foremost, that is, as the active tabs (note that these tabs do not exist on the same tab set, that is they do not have a parent/child relationship to each other), use the URL:

When the URL targets tabs, the path uses a colon (:) to separate a tab from its sub-tab; when the URL traverses a tab to get to an item on a sub-tab, the path uses a slash (/) in lieu of a comma. See "Path-Based URLs for Tabs" for examples.

If a name was not explicitly specified when the item was created, it is defaulted to be the same as the item's file name (for file-based items) or display name.

For example to access the current English version of myDocument.htm on page1a: