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:
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:
host is the machine on which Oracle Portal is installed.
port is the port number used to access Oracle Portal.
portal is a static element of an Oracle Portal URL.
dad is the Database Access Descriptor (DAD) that is used for your Oracle Portal installation. The DAD contains information on how to connect to the database.
language is the language in which you will display the object. Language is an optional path element. For examples of the
lang parameter in action, see Section C.3.3, "The Language Parameter in Path-Based and Durable URLs".
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)
…/ver-2/… …/ver-STAGE/… …/ver-DRAFT/… …/ver-REJECTED/…
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.
For a discussion of which users can view items in what state, see Section 17.9.3, "Item URL Security".
page_path is the path taken to get to the object.
item_name is the name of the item.
Path-based URLs for pages take the following format:
For example, To access the root page of the page group MyPageGroup:
To access a top-level page (sample_page) of the page group MyPageGroup:
To access a sub-page (page1a) of sample_page:
To access a category page:
To access a perspective page:
To access a navigation page:
To access a Portal Template:
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:
http://<host>:<port>/portal/page/<dad>[/lang-<language>]/ <page_path>/<tab1_name>:<tab1's_sub-tab_name>,<tab2_name>: <tab2's_sub-tab_name>
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.
For example to access tab1 on page1:
To access a nested tab (tab1a) on tab1:
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:
To access an item, use the following format:
If the item is placed on a tab:
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:
To access the third English version of myDocument.htm:
To access a draft or pending version of myDocument.htm: