contentlayout

PRODUCT CENTERS

Legal | Privacy

Printer View

E-mail this page

Bookmark

HTML Content Layout SubstitutionTags

The following table lists and describes the substitution tags available for use in HTML content layout templates. Use these tags to stand in for values present in OracleAS Portal, such as the values entered for an item or portlet's associated attributes or the item or portlet itself. The Type column indicates whether the tag can be used with portlets and items (common), only items, or only portlets.

Substitution tag Type Renders

#ITEM.ITEMID# Common
The ID of an item that is rendered via the HTML content layout template

When items have multiple versions, this tag refers to a specific item version. Compare it with #item.masterid#, which is the ID of the item without regard to version. The #item.id# is different for each version. The #item.masterid# is the same for all versions of the item.

#ITEM.MASTERID# Common
The master ID of an item that is rendered via the HTML content layout template

This tag can be used with the #item.pagegroupid# tag in a query against the public view of a page. In the following example, assume that the privilege to view WWSBR_ALL_ITEMS is granted to the user or to PUBLIC:

<oracle>
begin
 htp.p('Item MasterID=#item.masterid#'); htp.br;
 htp.p('PageGroup=#item.pagegroupid#'); htp.br;
 for c1 in (
 select id, display_name, language
 from #owner#.WWSBR_ALL_ITEMS
 where masterid = #item.masterid#
 and caid = #item.pagegroupid#
 )
 loop
 htp.p('Item ID = '||c1.id||
 ' title = ' ||c1.display_name||
 ' language = '||c1.language);
 htp.br;
 end loop;
end;
</oracle>

#ITEM.PAGEGROUPID# Common
The ID of the page group that contains the item being rendered via the HTML content layout template

Note: See the example in #item.masterid#.

#ITEM.TYPE# Common
The type of the object, such as file

Built-in types include:

file

text

url

folderlink

plsql

imagemap

none

portlet

zip_file

baseportletinstance

basefile

baseurl

basetext

baseplsql

basepagelink

baseimage

baseportallink

baseloginlogout

basesearch

baseelementlist

basesmarttext

basemaplink

tab_item_type

basepagepath

baseimagemap

basesubpagedisplay

basepagefunction

portlet_instance

baseuser

extfile

exturl

exttext

extplsql

extpagelink

extimage

extimagemap

base_placeholder

wirelessurl

baseitemlink

item_link

Oracle_Reports

Consider using this tag is inside <oracle></oracle> tags to create a conditional entry. For example:

<oracle>
if instr('#item.type#', 'image') > 0 then
htp.p('<img src="#item.content.value#" alt="#item.title.value#">');
elsif instr('#item.type#', 'baseportletinstance') > 0 then
 htp.p('#item.title.value# #item.portletcontent.value#');
elsif '#item.displayoption#' = 'direct' then
 htp.p('#item.title.value# #item.content.value#');
else
 htp.p('<a href="#item.url#">#item.title.value#</a>');
end if;
</oracle>

Note: Valid values can be queried from the NAME column in the Portal database table WWSBR_ITEM_TYPES.

#ITEM.STATUS# Common
The status of the object

Values include:

Active

Expired

Deleted

Hidden

Draft

Pending

Rejected

A single tag can return multiple values (separated by a space), for example:

Hidden Expired Deleted
Hidden Expired

Note: Consider using this tag inside <oracle></oracle> tags, for example, in if statements. See the Notes section at the end of this topic for a usage sample of the <oracle></oracle> tags.

#ITEM.STATUSINHTML# Common
The status of the object, rendered in the language specified for the client browser

The value is returned formatted as highlighted bold. It is rendered only when the page is in Edit mode.

#ITEM.STATUSLINK# Common
A fully formed hyperlink leading to the proper action for pending or draft items

Note: This link displays only when the object's status is Pending or Draft:

Clicking a Draft link takes users to an action page where they can either delete the object or submit it for approval.

Clicking a Pending link takes users to the Approval Notification Details page. This page contains a link to the item, a summary of attribute values (both displayed and not displayed), a text box for the approver's comments, and the object's approval history.

#ITEM.DISPLAYOPTION# Common
The object's display option:

direct--directly on the page

link--as a link on the page, link opens in current browser window

linktonewwindow--as a link on the page, link opens in new browser window

Using <oracle></oracle> tags, you can set up a condition that displays the object as specified in the object's attributes--in the current browser window or a new browser window--should this vary from object to object.

For example:

<oracle>
begin
if '#item.displayoption#' = 'link' then
 htp.p('<a href="#item.url#">View item in current
 window</a>');
elsif '#item.displayoption#' = 'linktonewwindow' then
 htp.p('<a href="#item.url#" target="_blank">View item in
 new window</a>');
else
 htp.p('Display item directly in page');
 htp.br;
 htp.p('#item.content#');
end if;
end;
</oracle>

#ITEM.URL# Common
The object's path-based URL

Note: Use this tag in an HTML href tag. For example:

<a href="#item.url#">#item.title.value#</a>

Or

<a href="#item.url#"><img src="#item.image.value#" alt="#item.title.value#"></a>

#ITEM.DURABLEURL# Common
The object's durable (or graphical user interface ID-based) URL

Note: Use this tag in an HTML href tag. For example:

<a href="#item.durableurl#">#item.content.label#</a>

#ITEM.EDITURL# Common
The URL to an edit view of the object

Note: This tag renders only for users with the appropriate privilege. Use it in an HTML href tag. For example:

<a href="#item.editurl#">Edit</a>

#ITEM.EDITLINK# Common
The fully-formed hyperlink to an edit view of the object

Only users with the item privilege Edit see this link. Users who click this link are taken to the object's properties page.

This tag renders the HTML to form the link as well as the link label, Edit. No additional encoding, such as an href tag, is required.

#ITEM.DELETEURL# Common
The URL to a delete view of the object

Note: This tag renders only for users with the appropriate privilege. Use it in an HTML href tag. For example:

<a href="#item.deleteurl#">Delete</a>

#ITEM.DELETELINK# Common
The fully-formed hyperlink to a delete view of the object

Only users with the item privilege Manage can see this link. Users who click this link are taken to a decision page where they choose either Yes or No to continue with deleting the relevant object.

This tag renders the HTML to form the link as well as the link label, Delete. No additional encoding, such as an href tag, is required.

#ITEM.PAGENAME# Common The name of the object's host page

#ITEM.PAGEURL# Common
The path-based URL of the object's host page

Note: Use this tag in an HTML href tag. For example:

<a href="#item.pageurl#">#item.pagename#</a>

#ITEM.PAGEDURABLEURL# Common
The durable (or graphical user interface ID-based) URL of the object's host page

Note: Use this tag in an HTML href tag. For example:

<a href="#item.pagedurableurl#">
#item.pagename#</a>

#ITEM.TITLE# Common
The object's title or Display Name wrapped in its associated style

This tag is equivalent to:


#item.title.value#


#ITEM.TITLE.LABEL#
Common
Display Name

#ITEM.TITLE.VALUE# Common The Display Name of the object

#ITEM.TITLE.STYLE#
Common
The style applied to the Display Name of the object

Note: Use this tag inside a tag. For example:

#item.title.label#:
#item.title.value#

#ITEM.DESCRIPTION# Common
The Description of the object wrapped in its associated style

This tag is equivalent to:


#item.description.value#


#ITEM.DESCRIPTION.LABEL#
Common Description

#ITEM.DESCRIPTION.VALUE#
Common The Description of the object

#ITEM.DESCRIPTION.STYLE#
Common
The style applied to the Description

Note: Use this tag inside a tag. For example:


#item.description.label#:
#item.description.value#

#ITEM.AUTHOR# Common
The object's Author wrapped in its associated style

This tag is equivalent to:


#item.author.value#


#ITEM.AUTHOR.LABEL#
Common Author

#ITEM.AUTHOR.VALUE#
Common The object's Author

#ITEM.AUTHOR.STYLE#
Common
The style applied to the name of the object's Author

Note: Use this tag inside a tag. For example:


#item.author.label#: #item.author.value#

#ITEM.IMAGE# Common
The object's representative image with ALT text, aligned as specified in the portal

Note: This is the image selected by a user to represent the object, rather than an item of the Image type.

This tag is equivalent to, for example:

<img src="#item.image.value#" border="0" alt="#item.title.value#" align="value defined on the item">

#ITEM.IMAGE.LABEL#
Common Image

#ITEM.IMAGE.VALUE# Common
The URL leading to the uploaded image (a location within the portal)

Note: This is the image selected by a user to represent the object, rather than an item of the Image type. Use this tag in an HTML img src tag. For example:

<a href="#item.url#"><img src="#item.image.value#" alt="#item.title.value#"></a>

When used within an img src tag, the image is rendered in place. Otherwise, this tag renders a URL.

#ITEM.KEYWORDS# Common
The object's assigned keywords and the Keywords label wrapped in their associated style

This tag is equivalent to:


#item.keywords.label#: #item.keywords.value#


#ITEM.KEYWORDS.LABEL#
Common Keywords

#ITEM.KEYWORDS.VALUE#
Common The object's assigned keywords

#ITEM.KEYWORDS.STYLE#
Common
The style applied to the object's keywords

Note: Use this tag inside a tag. For example:


#item.keywords.label#: #item.keywords.value#


#ITEM.CREATOR# Common
The user name of the object's creator, labeled and wrapped in its associated style

This tag is equivalent to:


#item.creator.label#: #item.creator.value#


#ITEM.CREATOR.LABEL#
Common Creator

#ITEM.CREATOR.VALUE#
Common The user name of the object creator

#ITEM.CREATOR.STYLE#
Common
The style applied to the object creator's user name

Note: Use this tag inside a tag. For example:


#item.creator.label#: #item.creator.value#


#ITEM.CREATEDATE# Common
The object's create date, labeled and wrapped in its associated style

This tag is equivalent to:


#item.createdate.label#: #item.createdate.value#


#ITEM.CREATEDATE.LABEL#
Common Create Date

#ITEM.CREATEDATE.VALUE#
Common
The string value equal to the date the object was created (that is, the date it was uploaded to the portal)

Note: This tag uses the format:

DD-MON-YYYY, that is, 06-MAY-2004

#ITEM.CREATEDATE.STYLE#
Common
The style applied to the object's create date

Note: Use this tag inside a tag. For example:


#item.createdate.label#: #item.createdate.value#


#ITEM.TRANSLATIONS# Common
The fully-formed hyperlink to a translation

Note: If no translation is present, the link does not display.

#ITEM.TRANSLATIONS.LABEL#
Common
Translations

Note: Use this tag in conjunction with the VALUE tag to render a fully-formed link to a list of translations of the current item. For example:

<a href="#item.translations.value#>
#item.translations.label#</a>

#ITEM.TRANSLATIONS.VALUE#
Common
The URL leading to the object's translation (a location within the portal) if such a translation exists

Note: Use this tag in an HTML href tag. For example:

<a href="#item.translations.value#">
#item.translations.label#</a>

Consider placing the VALUE tag in a PL/SQL conditional statement to control when to render it. Otherwise, the link might render even when no translation is present; in which case, users would receive an HTML error message when they click the link.

#ITEM.TRANSLATIONS.IMAGE# Common
The translations icon,

Note: You can use this tag in conjunction with the #item.translations.value# and #item.translations.label# tags to link the translations icon to a URL that dynamically assembles a page that lists links to all translations of this object in the portal.

For example:

<a href="#item.translations.value#">
<img src="#item.translations.image#" alt="#item.translations.label#">
</a>

This tag must be placed in an <img src> tag to render properly:

<img src="#item.translations.image#">

#ITEM.NEWFLAG# Common
The fully-formed hyperlink to a page listing all new objects

Note: If the object does not fall within the time limit specified for new objects, the link does not display. For example, if the page group is configured to flag objects as new for three days after they are uploaded, and the current object was uploaded seven days ago, the object is no longer considered new, and the link does not display.

#ITEM.NEWFLAG.LABEL#
Common
New Items

#ITEM.NEWFLAG.VALUE#
Common
The URL that renders a page that lists hyperlinks to all objects labeled New Items

Note: What qualifies as new is configured at the page group level on the page group properties Items tab.

Use this tag in an HTML href tag. For example:

<a href="#item.newflag.value#">
#item.newflag.label#</a>

Consider placing the VALUE tag in a PL/SQL conditional statement to control when to render it. Otherwise, the link might render even if no objects fall within the New Flag time limit; in which case, users would receive an HTML error message when they click the link.

#ITEM.NEWFLAG.IMAGE# Common
The New Items icon,

Note: You can use this tag in conjunction with the #item.newflag.value# and #item.newflag.label# tags to link the new objects icon to a URL. The URL target is a dynamically assembled page that lists links to all new objects in the portal to which the user has access privileges.

For example:

<a href="#item.newflag.value#">
<img src="#item.newflag.image#" alt="#item.newflag.label#">
</a>

This tag must be placed in an <img src> tag to render properly:

<img src="#item.newflag.image#">

#ITEM.PERSPECTIVES# Common
All perspectives applied to the object, listed as HTML links, which, when clicked, return a search result of all objects sharing the same perspective

This tag renders the same information as the tag #ITEM.PERSPECTIVES.VALUE#.

#ITEM.PERSPECTIVES.LABEL# Common
Perspectives

#ITEM.PERSPECTIVES.VALUE# Common All perspectives applied to the object, listed as HTML links, which, when clicked, return a search result of all objects sharing the same perspective

#ITEM.PERSPECTIVES[n]# Common
The fully-formed hyperlink to a page that lists links to all objects that are classified under the specified perspective

Note: If the relevant perspective has not been applied to the object, the link does not display.

#ITEM.PERSPECTIVES[n].LABEL# Common
The display name of the nth perspective

Note: Use this tag in conjunction with the #ITEM.PERSPECTIVES[n].VALUE# tag to render the targeted perspective. For example:

<a href="#item.perspectives2.value#">
#item.perspectives2.label#</a>

This construction lists the second perspective in the list of perspectives associated with the object. The perspective displays as a link, which, when clicked, returns a search result of all objects sharing the same perspective.

#ITEM.PERSPECTIVES[n].VALUE# Common
The URL that renders the value of the nth perspective in the list of perspectives applied to the object

Note: Use this tag in an HTML href tag. For example:

<a href="#item.perspectives2.value#">
#item.perspectives2.label#</a>

Consider placing the VALUE tag in a PL/SQL conditional statement to control when it is rendered. Otherwise, the link might render even if no nth perspective is present. In such a case, users receive an HTML error message when they click the link.

#ITEM.PERSPECTIVES[n].STYLE# Common
The style applied to the object's perspective attribute

Note: Use this tag inside a tag. For example:

<a href="#item.perspectives[n].value#">

#item.perspectives[n].label#
</a>

#ITEM.PERSPECTIVES[n].IMAGE#
Common
This tag renders the icon image that is associated with a perspective. The value [n], refers to the perspective's position on the list of perspectives that are selected for the object. If the object has only one perspective, the value is 1.

Note: This tag must be placed in an <img src> tag to render properly:

<img src="#item.perspectives3.image#">

You can use this tag in conjunction with the #item.perspectives[n].value# and #item.perspectives[n].label# tags to set up a linked image. Users click the image to go to a page that lists links to all objects classified by the specified perspective.

For example:

<a href="#item.perspectives4.value#">
<img src="#item.perspectives4.image#" alt="#item.persepctives4.label#">
</a>

If every perspective in a page group does not have a related perspective icon, you can set up a conditional statement using <oracle></oracle> tags and PL/SQL that renders the icon when it is present and prevents attempts at rendering when it is not present.

For example:

<oracle>
if length('#item.perspectives1.image#') > 0 then
 htp.p('<a href="#item.perspectives1.value#"><img
src="#item.perspectives1.image#"></a>');
else
 htp.p('<a href="#item.perspectives1.value#">
#item.perspectives1.label#</a>');
end if;
</oracle>

#ITEM.PROPERTYSHEET# Common
The fully-formed hyperlink to the object's property sheet

#ITEM.PROPERTYSHEET.LABEL# Common Property Sheet

#ITEM.PROPERTYSHEET.VALUE# Common
The URL that renders the object's property sheet

Note: Use this tag in an HTML href tag. For example:

<a href="#item.propertysheet.value#">
#item.propertysheet.label#</a>

#ITEM.PROPERTYSHEET.IMAGE# Common
The property sheet icon,

Note: The icon that this tag renders depends on the type of object the property sheet describes.

This tag must be placed in an <img src> tag to render properly:

<img src="#item.propertysheet.image#">

You can use this tag in conjunction with the #item.propertysheet.value# and #item.propertysheet.label# tags to link to the object's property sheet.

For example:

<a href="#item.propertysheet.value#">
<img src="#item.propertysheet.image#" alt="#item.propertysheet.label#">
</a>

#ITEM.UPDATEDFLAG# Common
The fully-formed hyperlink to a page that lists links to all recently updated objects

Note: If no objects have been updated recently, the link does not display.

#ITEM.UPDATEDFLAG.LABEL# Common Recently Updated Items

#ITEM.UPDATEDFLAG.VALUE# Common
The URL that renders a page that contains a linked list of all newly updated objects

Note: What qualifies as a newly updated object is configured at the page group level on the page group properties Items tab.

Use this tag in an HTML href tag. For example:

<a href="#item.updatedflag.value#">
#item.updatedflag.label#</a>

Consider placing the VALUE tag in a PL/SQL conditional statement to control when to render it. Otherwise, the link might render even if no object has been updated within the specified period; in which case, users would receive an HTML error message when they click the link.

#ITEM.UPDATEDFLAG.IMAGE# Common
The Recently Updated Items icon,

Note: You can use this tag in conjunction with the #item.updatedflag.value# and #item.updatedflag.label# tags to link the updated icon to a URL. The URL target is a dynamically assembled page that lists links to all updated objects in the portal to which the user has access privileges.

For example:

<a href="#item.updatedflag.value#">
<img src="#item.updatedflag.image#" alt="#item.updatedflag.label#">
</a>

Used alone, this tag must be placed in an <img src> tag to render properly:

<img src="#item.updatedflag.image#">

#ITEM.FUNCTION# Common
A URL that renders a page listing hyperlinks to all functions associated with the object

This tag renders the same information as the tag #ITEM.ITEMFUNCTION.VALUE#.

#ITEM.ITEMFUNCTION.LABEL# Common Associated Functions

#ITEM.ITEMFUNCTION.VALUE# Common
A URL that renders a page listing hyperlinks to all functions associated with the object

#ITEM.ITEMFUNCTION[n]# Common
A fully-formed link to the nth function associated with the object

Note: If the object does not have an nth associated function, the link does not display.

#ITEM.ITEMFUNCTION[n].LABEL# Common The display name of the nth function

#ITEM.ITEMFUNCTION[n].VALUE# Common
In the presence of multiple associated functions, the URL to the function in the nth position on the list of functions associated with the object

Note: Use this tag in an HTML href tag. For example:

<a href="#item.itemfunction3.value#">
#item.itemfunction3.label#</a>

This results in a linked label of the third function associated with the object. Users click the label to perform the related function.

Consider placing the VALUE tag in a PL/SQL conditional statement to control when to render it. Otherwise, the link might render even if an nth function has not been associated with the object; in which case, users would receive an HTML error message when they click the link.

#ITEM.ITEMFUNCTION[n].STYLE# Common
The style associated with the object function

Note: Use this tag inside a tag. For example:

<a href="#item.function[n].value#">

#item.function[n].label#
</a>

#ITEM.PUBLISHDATE# Common
The string value of the object's publish date, labeled and wrapped in its associated style

This tag is equivalent to:


#item.publishdate.label#: #item.publishdate.value#


Note: This tag uses the format:

Publish Date: DD-MON-YYYY HH12:MI PM, that is,
Publish Date: 06-MAY-2004 01:45 PM

#ITEM.PUBLISHDATE.LABEL#
Common Publish Date

#ITEM.PUBLISHDATE.VALUE#
Common
The string value of the object's publish date

Note: This tag uses the format:

DD-MON-YYYY HH12:MI PM, that is,
06-MAY-2004 01:45 PM

#ITEM.PUBLISHDATE.STYLE#
Common
The style applied to the object's publish date

Note: Use this tag inside a tag. For example:


#item.publishdate.label#: #item.publishdate.value#


#ITEM.CATEGORY# Common
The fully-formed hyperlink to a search results page that links to all objects classified under the relevant category

Note: If a category has not been applied to the object, the link does not display.

#ITEM.CATEGORY.LABEL# Common
The display name of the category assigned to the object

#ITEM.CATEGORY.VALUE# Common
The URL that renders search results for a search run against the category's display name

Note: Use this tag in an HTML href tag. For example:

<a href="#item.category.value#">
#item.category.label#</a>

Consider placing the VALUE tag in a PL/SQL conditional statement to control when to render it. Otherwise, the link might render even if no category has been applied to the object; in which case, users would receive an HTML error message when they click the link.

#ITEM.CATEGORY.STYLE# Common
The style applied to the object's category

Note: Use this tag inside a tag. For example:

<a href="#item.category.value#">

#item.category.label#
</a>

#ITEM.CATEGORY.IMAGE#
Common
The image associated with a category

Note: This tag must be placed in an <img src> tag to render properly:

<img src="#item.category.image#">

You can use this tag in conjunction with the #item.category.value# and #item.category.label# tags to set up a linked image. Users click the image to go to a page that lists links to all objects classified by the specified category.

For example:

<a href="#item.category.value#">
<img src="#item.category.image#" alt="#item.category.label#">
</a>

If every category in a page group does not have a related category icon, you can set up a conditional statement using <oracle></oracle> tags and PL/SQL to render the icon when it's present and to prevent attempts at rendering when the icon is not present.

For example:

<oracle>
if length('#item.category.image#') > 0 then
 htp.p('<a href="#item.category.value#"><img
src="#item.category.image#"></a>');
else
 htp.p('<a href="#item.category.value#">
#item.category.label#</a>');
end if;
</oracle>

#ITEM.UPDATEDATE# Common
The string value of the date of the object's latest update, labeled and wrapped in its associated style

This tag is equivalent to:


#item.updatedate.label#: #item.updatedate.value#


Note: This tag uses the format:

Date Updated: DD-MON-YYYY, that is, Date Updated: 06-MAY-2004

#ITEM.UPDATEDATE.LABEL#
Common Date Updated

#ITEM.UPDATEDATE.VALUE#
Common
The string value of the date of the object's latest update

Note: This tag uses the format:

DD-MON-YYYY, that is, 06-MAY-2004

#ITEM.UPDATEDATE.STYLE#
Common
The style applied to the object's update value

Note: Use this tag inside a tag. For example:


#item.updatedate.label#: #item.updatedate.value#


#ITEM.UPDATOR# Common
The username of the object updator, labeled and wrapped in its associated style

This tag is equivalent to:


#item.updator.label#: #item.updator.value#


#ITEM.UPDATOR.LABEL#
Common Last Updated By

#ITEM.UPDATOR.VALUE#
Common The username of the object updator

#ITEM.UPDATOR.STYLE#
Common
The style applied to the object updator

Note: Use this tag inside a tag. For example:


#item.updator.label#: #item.updator.value#


#ITEM.EXPIREDATE.LABEL#
Item Expire Date

#ITEM.EXPIREDATE.VALUE#
Item
The string value of the date the item expires

Note: This tag uses the format:

DD-MON-YYYY HH12:MI PM, that is,
06-MAY-2004 01:45 PM

#ITEM.EXPIREDATE.STYLE#
Item
The style applied to the item's expire date

Note: Use this tag inside a tag. For example:


#item.expiredate.label#:
#item.expiredate.value#</