Skip Headers
Oracle® Application Server Portal User's Guide
10g Release 2 (10.1.4)
B13809-04
  Go To Documentation Library
Home		 Go To Product List
Solution Area		 Go To Table Of Contents
Contents		 Go To Index
Index
Previous
Previous 		Next
Next 		 

E Substitution Tags for HTML and Unstructured UI Templates

When you create HTML and Unstructured User Interface templates for your portal, you can use substitution tags to stand in for OracleAS Portal user interface elements, such as an Edit button, and for variable types of information, such as content attributes, categories, and perspectives. When the template is rendered, actual values replace the tag.

For example, an HTML content layout might contain an #ITEM.PAGENAME# tag. This tag stands in for the display name of a page that contains a region that is using the HTML content layout template. When the template is rendered on the region, the host page's display name is returned.

Three sets of substitution tags are available for use within OracleAS Portal: HTML page skin, HTML content layout, and Unstructured User Interface template tags. This appendix lists and describes these tag sets and provides examples of their use. It contains the following main sections:

For more information about how to create and use HTML templates, see Chapter 13, "Providing a Standard Look and Feel".

E.1 Substitution Tags for HTML Page Skins

You can introduce portal elements into your HTML page skin through HTML page skin substitution tags. Use these to introduce such OracleAS Portal elements as page Edit or Personalize links, the name of the currently logged-in user, the current page's display name, and so on.

Use HTML page skins with your portal pages. Make your selection on the Template tab of page properties. For more information, see Section 13.3.1.1, "Creating an HTML Page Skin".

Table E-1 lists and describes the substitution tags available for use in HTML page skin templates. These tags take their values from values that were entered in the wizard that was used to build the host page (that is, the page using the template) and from other OracleAS Portal settings.


Note:

Before you use any of the tags described in this section, there are a few things it may be useful to know:

  • Users have access to only those objects for which they have privileges. For example, if a user does not have the Personalize privilege on a page, he or she cannot use the Personalize hyperlink, even though it may be present in the HTML page skin. In such a case, the tag will be null.

  • If you use relative links in your HTML Page Skin template, you must include the #PAGE.BASE# tag in the <HEAD></HEAD> section the template or specifically set the base tag yourself.

  • The tag #PAGE.STYLE.URL#, used in previous versions of OracleAS Portal, is no longer supported. Users with legacy Unstructured User Interface templates must manually update any uses of this tag to #PAGE.STYLE#, described in Table E-1.


Table E-1 HTML Page Skin Substitution Tags

Substitution Tag Value Set By …

#BODY#

The main body area of the page

This contains all the regions and region content that are wrapped in the page skin.

#OWNER#

The Portal schema

#IMAGE_PREFIX#

The OracleAS Portal images directory as specified in the plsql.conf configuration file

#USER#

The user name of the user who is currently logged on

For pages cached at the system level, all user tags are rendered null.

#USER.FULLNAME#

The full name of the user who is currently logged on

Note that:

  • The full name includes the user's first, middle, and last names.

  • For pages cached at the system level, all user tags are rendered null.

#USER.FIRSTNAME#

The first name of the user who is currently logged on

Note that, for pages cached at the system level, all user tags are rendered null.

#USER.MIDDLENAME#

The middle name of the user who is currently logged on

Note that, for pages cached at the system level, all user tags are rendered null.

#USER.LASTNAME#

The last name (surname) of the user who is currently logged on

Note that, for pages cached at the system level, all user tags are rendered null.

#VERSION#

The version of this installation of OracleAS Portal

#HELPSCRIPT#

Renders the JavaScript that pops up a window to display help

Use this tag between the HTML <HEAD></HEAD> tags. For example: 

<HTML dir=#DIRECTION#>
<HEAD>
<TITLE>#TITLE#</TITLE>
#HELPSCRIPT#
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<BODY leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0">

To call a specific help topic: 

<a href="javascript:show_context_help('help_url')">Help</a>

#DIRECTION#

The direction of character layout (left-to-right or right-to-left)

This value is set based on the language selected for the portal. Use it in conjunction with portals using bi-directional languages. For example, using PL/SQL (between <oracle></oracle> tags), you can set up if statements that query the current text direction and, based on the result, set the alignment of template elements using the #ALIGN_LEFT# and #ALIGN_RIGHT# tags.

Place this tag within the <HTML> tag, for example: 

<HTML dir=#DIRECTION#>
<HEAD>
<TITLE>#TITLE#</TITLE>
#HELPSCRIPT#
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<BODY leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0">

#ALIGN_LEFT#

Align content to the left

#ALIGN_RIGHT#

Align content to the right

#PAGE.PAGEID#

The page ID of the page using the HTML page skin

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

<oracle>
begin
    htp.p('Page=#page.pageid#'); htp.br;
    htp.p('PageGroup=#page.pagegroupid#'); htp.br;
    for c1 in (
        select display_name, language
        from #owner#.WWSBR_USER_FOLDERS
        where id = #page.pageid#
        and caid = #page.pagegroupid#
        )
        loop
             htp.p(' Page title = '||c1.display_name||
             ' language = '||c1.language);
             htp.br;
        end loop;
end;
</oracle>

#PAGE.PAGEGROUPID#

The page group ID of the page using the HTML page skin

See the example provided in #page.pageid#.

#TITLE#

The display name assigned to the page through the portal

Use this tag in the page header. For example: 

<HTML dir=#DIRECTION#>
<HEAD>
<TITLE>#TITLE#</TITLE>
#HELPSCRIPT#
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<BODY leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0">

#PAGE.STYLE#

Fetches all relevant style classes and embeds them in the HTML

This tag is allowed only in the document HEAD. For example: 

<HTML dir=#DIRECTION#>
<HEAD>
<TITLE>#TITLE#</TITLE>
#HELPSCRIPT#
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<BODY leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0">

This tag pulls its information from the OracleAS Portal style that is applied to the page that is using the HTML page skin template. You can use this tag, define your own cascading style sheet (CSS) for the page, or embed the OracleAS Portal style element classes between <style></style> tags in the template header.

If you define your own style through a CSS or embed the OracleAS Portal style element classes, consider omitting the #page.style# tag from the HTML page skin template. The style element classes included by the #page.style# tag may conflict with the styles you include in the template or in your CSS.

The style element classes used with OracleAS Portal styles are listed and described in Table E-2.

#PAGE.BASE#

The base URL of the page to which the HTML Page Skin template is applied

This tag is allowed only in the document HEAD. For example: 

<HTML dir=#DIRECTION#>
<HEAD>
<TITLE>#TITLE#</TITLE>
#HELPSCRIPT#
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<BODY leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0">

This tag contains a full reference to the location of the portal page to which the HTML Page Skin template is applied. This includes the base page URL and the relevant associated HTML.

If you use relative links in your HTML Page Skin template, you must include the #PAGE.BASE# tag in the <HEAD></HEAD> section the template.

#PAGE.BASE.URL#

The base URL of the page to which the HTML Page Skin is applied

This is a subset of #PAGE.BASE#. It contains just the URL. Enclose this tag in a base href tag. For example: 

<base href="#PAGE.BASE.URL#">

#PORTAL.HOME#

The HTML image hyperlink to the portal home page

This tag contains everything required to render a hyperlinked icon and label (the label displays as ALT text when users roll over the icon). Use this tag by itself to place a link to your portal's home page in your HTML Page Skin template. Alternatively, you can use the #PORTAL.HOME.URL#, #PORTAL.HOME.IMAGE#, and #PORTAL.HOME.LABEL#, plus the relevant HTML to create the same effect.

#PORTAL.HOME.URL#

The URL of the portal home page

Place this tag inside an href tag. For example: 

<a href="#portal.home.url#">#portal.home.label#</a>

Or 

<a href="#portal.home.url#">
<img src="#portal.home.image#" alt="#portal.home.label#">
</a>

#PORTAL.HOME.IMAGE#

The image used for the portal home page link

Always use this tag inside an img src tag. For example: 

<img src="#portal.home.image#">

See the entry for #portal.home.url# for another usage example.

#PORTAL.HOME.LABEL#

The text used for the portal home page hyperlink, by default: Home

See the entry for #portal.home.url# for examples.

#PORTAL.NAVIGATOR#

The HTML image hyperlink to the Portal Navigator

This tag contains everything required to render a hyperlinked icon and label (the label displays as ALT text when users roll over the icon). Use this tag by itself to place a link to the Portal Navigator in your HTML Page Skin template. Alternatively, you can use the #PORTAL.NAVIGATOR.URL#, #PORTAL.NAVIGATOR.IMAGE#, and #PORTAL.NAVIGATOR.LABEL#, plus the relevant HTML to create the same effect.

#PORTAL.NAVIGATOR.URL#

The URL of the Portal Navigator

Place this tag inside an href tag. For example: 

<a href="#portal.navigator.url#">#portal.navigator.label#</a>

Or 

<a href="#portal.navigator.url#">
<img src="#portal.navigator.image#" alt="#portal.navigator.label#">
</a>

#PORTAL.NAVIGATOR.IMAGE#

The image used for the Portal Navigator link

Always use this tag inside an img src tag. For example: 

<img src="#portal.navigator.image#">

See the entry for #portal.navigator.url# for another usage example.

#PORTAL.NAVIGATOR.LABEL#

The text used for the Portal Navigator hyperlink, by default: Navigator

See the entry for #portal.navigator.url# for examples.

#PORTAL.HELP#

The HTML image hyperlink to the OracleAS Portal online help

This tag contains everything required to render a hyperlinked icon and label (the label displays as ALT text when users roll over the icon). Use this tag by itself to place a link to OracleAS Portal online help in your HTML Page Skin template. Alternatively, you can use the #PORTAL.HELP.URL#, #PORTAL.HELP.IMAGE#, and #PORTAL.HELP.LABEL#, plus the relevant HTML to create the same effect.

#PORTAL.HELP.URL#

The URL of the OracleAS Portal online help

Place this tag inside an href tag. For example: 

<a href="#portal.help.url#">#portal.help.label#</a>

Or 

<a href="#portal.help.url#">
<img src="#portal.help.image#" alt="#portal.help.label#">
</a>

#PORTAL.HELP.IMAGE#

The image used for the OracleAS Portal online help link

Always use this tag inside an img src tag. For example: 

<img src="#portal.help.image#">

See the entry for #portal.help.url# for another usage example.

#PORTAL.HELP.LABEL#

The text used for the OracleAS Portal online help hyperlink, by default: Help

See the entry for #portal.help.url# for examples.

#PORTAL.COMMUNITY#

The HTML image hyperlink to the Portal Community Web site

This tag contains everything required to render a hyperlinked icon and label (the label displays as ALT text when users roll over the icon). Use this tag by itself to place a link to the Portal Community Web site in your HTML Page Skin template. Alternatively, you can use the #PORTAL.COMMUNITY.URL#, #PORTAL.COMMUNITY.IMAGE#, and #PORTAL.COMMUNITY.LABEL#, plus the relevant HTML to create the same effect.

#PORTAL.COMMUNITY.URL#

The URL of the Portal Community Web site

Place this tag inside an href tag. For example: 

<a href="#portal.community.url#">#portal.community.label#</a>

Or 

<a href="#portal.community.url#">
<img src="#portal.community.image#" alt="#portal.community.label#">
</a>

#PORTAL.COMMUNITY.IMAGE#

The image used for the Portal Community Web site link

Always use this tag inside an img src tag. For example: 

<img src="#portal.community.image#">

See the entry for #portal.community.url# for another usage example.

#PORTAL.COMMUNITY.LABEL#

The text of the Portal Community hyperlink, by default: Community

See the entry for #portal.community.url# for examples.

#PAGE.EDITPAGE#

The Edit hyperlink to portal page editing functionality

This tag contains everything required to render a hyperlink. Use this tag by itself to place an Edit page link in your HTML Page Skin template. Alternatively, you can use the #PORTAL.EDITPAGE.URL# and #PORTAL.EDITPAGE.LABEL#, plus the relevant HTML to create the same effect.

When the Edit link is placed on a navigation page, and the navigation page is rendered on a page, the Edit link executes on the page and not on the navigation page.

The value of this tag is returned only if the user has the page privilege Manage on the page.

#PAGE.EDITPAGE.URL#

The HTML text to allow page URL editing

Place this tag inside an href tag. For example: 

<a href="#page.editpage.url#">#page.editpage.label#</a>

When the Edit link is placed on a navigation page, and the navigation page is rendered on a page, the Edit link executes on the page and not on the navigation page.

The value of this tag is returned only if the user has the page privilege Manage on the page.

#PAGE.EDITPAGE.LABEL#

The text for the Edit page hyperlink, by default: Edit

When the Edit link is placed on a navigation page, and the navigation page is rendered on a page, the Edit link executes on the page and not on the navigation page.

The value of this tag is returned only if the user has the page privilege Manage on the relevant page.

See the entry for #page.editpage.url# for examples.

#PAGE.CUSTOMIZEPAGE#

The hyperlink to the personalize page dialog

This tag contains everything required to render a hyperlink. Use this tag by itself to place a Personalize page link in your HTML Page Skin template. Alternatively, you can use the #PAGE.CUSTOMIZEPAGE.URL# and #PAGE.CUSTOMIZEPAGE.LABEL#, plus the relevant HTML to create the same effect.

The value of this tag is returned only if the user has sufficient privileges to personalize the page.

#PAGE.CUSTOMIZEPAGE.URL#

The URL that renders the personalize page view

Use this in conjunction with the #PAGE.CUSTOMIZEPAGE.LABEL# tag to construct your Personalize link. For example: 

<a href="#PAGE.CUSTOMIZEPAGE.URL#">
#PAGE.CUSTOMIZEPAGE.LABEL#</a>

The value of this tag is returned only if the user has sufficient privileges to personalize the page.

#PAGE.CUSTOMIZEPAGE.LABEL#

The text for the personalize page link, by default: Personalize

The value of this tag is returned only if the user has sufficient privileges to personalize the page.

#PAGE.REFRESH#

The page refresh hyperlink

This tag contains everything required to render a hyperlink. Use this tag by itself to place a Refresh page hyperlink in your HTML Page Skin template. Alternatively, you can use the #PAGE.REFRESH.URL# and #PAGE.REFRESH.LABEL#, plus the relevant HTML to create the same effect.

When this tag is placed on a navigation page, and the navigation page is rendered on a page, the Refresh link executes on the page and not on the navigation page.

The Refresh hyperlink displays only when the page's cache mode is set to Cache Page Definition and Content.

#PAGE.REFRESH.URL#

The URL that invokes the page refresh functionality

Use this in conjunction with the #PAGE.REFRESH.LABEL# tag to construct your Refresh hyperlink. For example: 

<a href="#page.refresh.url#">
#page.refresh.label#</a>

When the Refresh link is placed on a navigation page, and the navigation page is rendered on a page, the Refresh link executes on the page and not on the navigation page.

The Refresh hyperlink displays only when the page's cache mode is set to Cache Page Definition and Content.

#PAGE.REFRESH.LABEL#

The text used for the refresh hyperlink, by default: Refresh

When the Refresh link is placed on a navigation page, and the navigation page is rendered on a page, the Refresh link executes on the page and not on the navigation page.

The Refresh hyperlink displays only when the page's cache mode is set to Cache Page Definition and Content.

See the entry for #page.refresh.url# for a usage example.

#PORTAL.LOGOUT#

The OracleAS Portal Logout hyperlink

This tag contains everything required to render a hyperlink. Use this tag by itself to place a Logout hyperlink in your HTML Page Skin template. Alternatively, you can use the #PORTAL.LOGOUT.URL# and #PORTAL.LOGOUT.LABEL#, plus the relevant HTML to create the same effect.

The Logout hyperlink toggles between Logout and Login, depending on its current state.

#PORTAL.LOGOUT.URL#

The OracleAS Portal logout URL

Use this in conjunction with the #PORTAL.LOGOUT.LABEL# tag to construct your Logout hyperlink. For example: 

<a href="#portal.logout.url#">
#portal.logout.label#</a>

The Logout hyperlink toggles between Logout and Login, depending on its current state.

#PORTAL.LOGOUT.LABEL#

The text used for the logout hyperlink, by default: Logout

The Logout hyperlink toggles between Logout and Login, depending on its current state.

See the entry for #portal.logout.url# for a usage example.

#PORTAL.ACCOUNTINFO#

The hyperlink to the account information dialog

This tag contains everything required to render a hyperlink. Use this tag by itself to place an Account Info hyperlink in your HTML Page Skin template. Alternatively, you can use the #PORTAL.ACCOUNTINFO.URL# and #PORTAL.ACCOUNTINFO.LABEL#, plus the relevant HTML to create the same effect.

Users must be logged in to see the Account Info hyperlink.

#PORTAL.ACCOUNTINFO.URL#

The URL to the account information dialog

Use this in conjunction with the #PORTAL.ACCOUNTINFO.LABEL# tag to construct your Account Info hyperlink. For example: 

<a href="#portal.accountinfo.url#">
#portal.accountinfo.label#</a>

Users must be logged in to see the Account Info hyperlink.

#PORTAL.ACCOUNTINFO.LABEL#

The text used for the account information hyperlink, by default: Account Info

Users must be logged in to see the Account Info hyperlink.

See the entry for #portal.accountinfo.url# for a usage example.


E.2 Style Element Classes Used with OracleAS Portal Styles

If you plan to apply your own cascading style sheet (CSS) to your portal pages or to include OracleAS Portal-specific style classes in an HTML template, it will be useful to know the style element classes used by OracleAS Portal styles to define the look and feel of every portal object.

This section provides a series of tables that list and describe the style element classes associated with OracleAS Portal styles. It includes the following subsections:

For information on how to include style element classes or a CSS with OracleAS Portal pages, see Section 12.12, "Using Portal Style Element Classes in HTML Templates and CSSs"

E.2.1 Style Element Classes Associated with Common Elements

Table E-2 lists and describes style element classes associated with the common elements defined in an OracleAS Portal style.

Where variables are indicated, the following applies:

  • idn is an internally generated number that identifies the style in use.

  • siteidnn, is an internally generated number that identifies the page group.

If you plan to use OracleAS Portal style element classes, consider always setting your page style to Main. This way, the values for idnsiteidnn are predictable. That is: id1siteid0.

Table E-2 Style Element Classes Associated with Common Elements

Style Element Description/Example

Bodyidnsiteidnn

The color or image used for the background of the page or region 

.Bodyid1siteid0{Background-Color:#FFFFFF;}

RegionHeaderidnsiteidnn

The color, height, and alignment of text in the banners that display above each region in a page 

.RegionHeaderid1siteid0{Background-Color:#336699;
Height:20;Text-Align:Left;}

RegionHeaderTextidnsiteidnn

The color, font face, font size, font style, and font decoration of regular text in the banners that display above each region in a page 

.RegionHeaderTextid1siteid0{Color:#FFFFFF;
Font-Family:Arial,Helvetica;Font-Size:0.75em;
Font-Weight:Bold;}

RegionNoBorder

Determines what to display when no border is selected (usually set to nothing) 

RegionNoBorder{}

RegionBorder

The color, width, and style of the table border that is used to display a region 

.RegionBorder{border:#336699  1px solid;}

RegionHeaderColor

The color, background color, width, and style of the table and border that is used to display a region header 

.RegionHeaderColor{background-color:;
border:#336699 0px solid;}

PageColor

The background color of a page 

.PageColor{background-color:#FFFFFF}

LeftCurve

The image and image position of the left side of a region header 

.LeftCurve{Background-Attachment:scroll;
Background-Image:url(https://company.us.myco.com:5555/images/FFFFFFl.gif);
Background-Position:left top;
Background-Repeat:no-repeat;}

RightCurve

The image and image position of the right side of a region header 

.RightCurve{Background-Attachment:scroll;
Background-Image:url(https://company.us.myco.com:5555/images/FFFFFFr.gif);
Background-Position:right top;
Background-Repeat:no-repeat;}

E.2.2 Style Element Classes Associated with Tabs

Table E-3 lists and describes style element classes associated with the tab elements defined on an OracleAS Portal style sheet.

Where variables are indicated, the following applies:

  • idn is an internally generated number that identifies the style in use.

  • siteidnn, is an internally generated number that identifies the page group.

If you plan to use a CSS with your OracleAS Portal pages, consider always setting your page style to Main. This way, the values for idnsiteidnn are predictable. That is: id1steid0.

Table E-3 Style Element Classes Associated with Tabs

Style Element Description/Example

LeftSubTabidnsiteidnn

LeftTabForeSlantidnsiteidnn

RightSubTabidnsiteidnn

RightTabForeCurveidnsiteidnn

TabForegroundColoridnsiteidnn

The color and images of an active main or sub-tab

The active tab is the tab that is currently selected. 

.LeftSubTabid1siteid0
{Background-Attachment:scroll;
Background-Color:#336699;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFsl.gif);
Background-Position:left top;
Background-Repeat:no-repeat;}


.LeftTabForeSlantid1siteid0
{Background-Attachment:scroll;
Background-Color:#336699;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFtl.gif);
Background-Position:left top;
Background-Repeat:no-repeat;}


.RightSubTabid1siteid0
{Background-Attachment:scroll;
Background-Color:#336699;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFsr.gif);
Background-Position:right top;
Background-Repeat:no-repeat;}



.RightTabForeCurveid1siteid0
{Background-Attachment:scroll;
Background-Color:#336699;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFtr.gif);
Background-Position:right top;
Background-Repeat:no-repeat;}


.TabForegroundColorid1siteid0
{Background-Color:#336699;}

TabForegroundTextidnsiteidnn

The color, font face, font size, font style, and font decoration of the text on the active tab

The active tab is the tab that is currently selected. 

.TabForegroundTextid1siteid0{Color:#FFFFFF;
Text-Decoration:none;
Font-Family:Arial, Helvetica;
Font-Size:0.92em;Font-Weight:Bold;}

LeftTabBgSlantidnsiteidnn

RightTabBgCurveidnsiteidnn

SubTabBgTextidnsiteidnn

TabBackgroundColoridnsiteidnn

The color and images to use for inactive main or sub-tabs

Inactive tabs are the tabs that are not currently selected. 

.LeftTabBgSlantid1siteid0
{Background-Attachment:scroll;
Background-Color:#CCCC99;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFtl.gif);
Background-Position:left top;
Background-Repeat:no-repeat;}


.RightTabBgCurveid1siteid0
{Background-Attachment:scroll;
Background-Color:#CCCC99;
Background-Image:url(https://mycompany.us.myco.com:5555/images/FFFFFFtr.gif);
Background-Position:right top;
Background-Repeat:no-repeat;}


.SubTabBgTextid1siteid0{Color:#CCCC99;
Text-Decoration:none;
Font-Family:Arial, Helvetica;
Font-Size:0.92em;}


.TabBackgroundColorid1siteid0
{Background-Color:#CCCC99;}

TabBackgroundTextidnsiteidnn

The color, font face, font size, font style, and font decoration of the text on inactive tabs

Inactive tabs are the tabs that are not currently selected. 

.TabBackgroundTextid1siteid0{Color:#003366;
Text-Decoration:none;
Font-Family:Arial, Helvetica;
Font-Size:0.92em;}

E.2.3 Style Element Classes Associated with Items

Table E-4 lists and describes style element classes associated with the item elements defined on an OracleAS Portal style sheet.

Where variables are indicated, the following applies:

  • idn is an internally generated number that identifies the style in use.

  • siteidnn, is an internally generated number that identifies the page group.

If you plan to use a CSS with your OracleAS Portal pages, consider always setting your page style to Main. This way, the values for idnsiteidnn are predictable. That is: id1steid0.

Many of the item-related style element classes provide style definitions for OracleAS Portal attributes. For a list and description of those attributes, see Section A.2, "Base Attributes".

Table E-4 Style Element Classes Associated with Items

Style Element Description/Example

GroupHeaderidnsiteidnn

The color, height, and alignment of text in the banners that appear above each group of items in a page 

.GroupHeaderid1siteid0
{Background-Color:#336699;
Height:20;Text-Align:left;}

GroupHeaderTextidnsiteidnn

The color, font face, font size, font style, and font decoration of regular (non-linked) text in the banners that appear above each group of items in a page 

.GroupHeaderTextid1siteid0{Color:#FFFFFF;
Font-Family:Arial, Helvetica;Font-Size:0.75em;
Font-Weight:Bold;Text-Decoration:none;}

GroupHeaderLinkidnsiteidnn

The color, font face, font size, font style, and font decoration of links in the banners that appear above each group of items in a page 

.GroupHeaderLinkid1siteid0{Color:#FFFFFF;
Font-Family:Arial, Helvetica;Font-Size:0.75em;
Font-Weight:Bold;Text-Decoration:none;}

defaultattributeidnsiteidnn

The color, font face, font size, font style, and font decoration of any attribute that is not explicitly listed as a style element property for items 

.defaultattributeid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

subpagetitleidnsiteidnn

The color, font face, font size, font style, and font decoration of the sub-page Display Name attribute 

.subpagetitleid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

itemfunctionidnsiteidnn

The color, font face, font size, font style, and font decoration of the Associated Functions attribute 

.itemfunctionid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

authoridnsiteidnn

The color, font, font face, font size, font style, and font decoration of the Author attribute 

.authorid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em; Text-Decoration:none;}

wwsbr_itemtype_idnsiteidnn

The color, font face, font size, font style, and font decoration of the Base Item Type attribute 

.wwsbr_itemtype_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_category_idnsiteidnn

The color, font face, font size, font style, and font decoration of the Category attribute 

.wwsbr_category_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_updatedate_idnsiteidnn

The color, font face, font size, font style, and font decoration of the Date Updated attribute 

.wwsbr_updatedate_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_updator_idnsiteidnn

The color, font face, font size, font style, and font decoration of the Last Updated By attribute 

.wwsbr_updator_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_page_idnsiteidnn

The color, font face, font size, font style, and font decoration of the page Display Name attribute 

.wwsbr_page_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_pagegroup_idnsiteidnn

The color, font face, font size, font style, and font decoration of the page group Display Name attribute 

.wwsbr_pagegroup_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

wwsbr_publishdate_idnsiteidnn

The color, font face, font size, font style, and font decoration of the Publish Date attribute 

.wwsbr_publishdate_id1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

createdateidnsiteidnn

The color, font face, font size, font style, and font decoration of the Create Date attribute 

.createdateid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

creatoridnsiteidnn

The color, font face, font size, font style, and font decoration of the Creator attribute 

.creatorid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

descriptionidnsiteidnn

The color, font face, font size, font style, and font decoration of the Description attribute 

.descriptionid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

titleidnsiteidnn

The color, font face, font size, font style, and font decoration of the item Display Name attribute 

.titleid1siteid0{Color:#000000;
Font-Family:Arial,Helvetica;Font-Size:0.67em;
Font-Weight:Bold;Text-Decoration:none;}

titleorimageidnsiteidnn

The color, font face, font size, font style, and font decoration of the Link - Image OR Display Name attribute 

.titleorimageid1siteid0{Color:#336699;
Font-Family:Arial, Helvetica;Font-Size:0.75em;
Font-Weight:Bold;Text-Decoration:none;}

documentsizeidnsiteidnn

The color, font face, font size, font style, and font decoration of the document size attribute 

.documentsizeid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

expiredateidnsiteidnn

The color, font face, font size, font style, and font decoration of the expire date attribute 

expiredateid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

inplacedisplayidnsiteidnn

The color, font face, font size, font style, and font decoration of the item content attribute 

.inplacedisplayid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

keywordsidnsiteidnn

The color, font face, font size, font style, and font decoration of the keywords attribute 

.keywordsid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;}

perspectivesidnsiteidnn

The color, font face, font size, font style, and font decoration of the perspective attribute 

.perspectivesid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Text-Decoration:none;}

scoreidnsiteidnn

The color, font face, font size, font style, and font decoration of the score attribute 

.scoreid1siteid0{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;}

E.2.4 Style Element Classes Associated with Portlets

Table E-5 lists and describes style element classes associated with the portlet elements defined on an OracleAS Portal style sheet.

Table E-5 Style Element Classes Associated with Portlets

Style Element Description

PortletHeaderColor

The color of portlet headers 

.PortletHeaderColor{Background-Color:#336699;}

PortletHeaderText

The color, font face, font size, font style, and font decoration of regular (non-linked) text in portlet headers 

.PortletHeaderText{Color:#FFFFFF;
Font-Family:Arial, Helvetica;Font-Size:0.83em;
Font-Weight:Bold;Text-Decoration:none;}

PortletHeaderLink

The color, font face, font size, font style, and font decoration of links in portlet headers 

.PortletHeaderLink{Color:#FFFFFF;
Font-Family:Arial, Helvetica;Font-Size:0.67em;}

PortletHeaderStyle

Determines whether portlet headers have square or rounded edges 

.PortletHeaderStyle{}

PortletSubHeaderColor

The color of portlet subheaders 

.PortletSubHeaderColor{Background-Color:#EEEEDD;}

PortletSubHeaderText

The color, font face, font size, font style, and font decoration of regular (non-linked) text in portlet sub-headers 

.PortletSubHeaderText{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.75em;}

PortletSubHeaderLink

The color, font face, font size, font style, and font decoration of links in portlet sub-headers 

.PortletSubHeaderLink{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.75em;}

PortletBodyColor

The color of the main body of portlets 

.PortletBodyColor{}

PortletHeading1

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletHeading1 tag 

.PortletHeading1{Color:#336699;
Font-Family:Arial, Helvetica;Font-Size:0.75em;
Font-Weight:Bold;Text-Decoration:none;}

PortletText1

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletText1 tag 

.PortletText1{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;}

PortletHeading2

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletHeading2 tag 

.PortletHeading2{Color:#336699;
Font-Family:Arial, Helvetica;Font-Size:0.67em;
Font-Weight:Bold;}

PortletText2

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletText2 tag 

.PortletText2{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.67em;}

PortletHeading3

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletHeading3 tag 

.PortletHeading3{Color:#336699;
Font-Family:Arial, Helvetica;Font-Size:0.58em;
Font-Weight:Bold;}

PortletText3

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletText3 tag 

.PortletText3{Color:#000000;Font-Family:Arial, Helvetica;Font-Size:0.58em;Text-Decoration:none;}

PortletHeading4

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletHeading4 tag 

.PortletHeading4{Color:#336699;
Font-Family:Arial, Helvetica;Font-Size:0.58em;
Font-Weight:Bold;}

PortletText4

The color, font face, font size, font style, and font decoration of text in portlets marked with the PortletText4 tag 

.PortletText4{Color:#000000;
Font-Family:Arial, Helvetica;Font-Size:0.58em;}

E.3 Substitution Tags for HTML Content Layouts

You can control the layout and appearance of region content by applying an HTML content layout template. Create the template using a simple portal wizard. Enhance it by inserting substitution tags to stand in for values present in OracleAS Portal, such as an item or portlet's associated attributes.

HTML content layouts are selected at the region level. Select a content layout on the Attributes tab of region properties. For more information, see Section 13.3.2, "Using HTML to Define the Layout and Appearance of Region Content".

Possibly, the two most essential tags are:

You will find descriptions and usage examples for both of these tags in Table E-6.

You have the option of using PL/SQL between <oracle></oracle> tags to allow for a more conditional template, such as one that can be used equally on a portlet or item region. For example: 

<oracle>
  if #ITEM.TYPE# in ('baseportletinstance', 'portlet_instance') then
    htp.p('#ITEM.PORTLETCONTENT#');
  else
    htp.p('#ITEM.DESCRIPTION#');
    htp.p('#ITEM.CONTENT#');
  end if;
</oracle>

Within the OracleAS Portal user interface, the list of substitution tags displays dynamically. That is, each time the list is invoked (by clicking the View a list of available tags link on the Create or Edit Template page), it is assembled on the fly from the tags currently available in the OracleAS Portal database. Each substitution tag has its equivalent attribute in OracleAS Portal. All item and portlet attributes are represented. This includes built-in attributes from the Shared Objects page group and custom attributes from the current page group.

For a tag to return a value, its corresponding attribute must contain a value in the portal. For example, for an #ITEM.DESCRIPTION.VALUE# tag to return a description of an item, a user must have added a description for that item when the item was added to or edited in the portal.

For more information about HTML content layouts, see Chapter 13, "Providing a Standard Look and Feel".

Table E-6 lists and describes the substitution tags you can use in HTML content layout templates. The Type column indicates whether the tag can be used with portlets and items (Common), only items (Item), or only portlets (Portlet).

Table E-6 HTML Content Layout Substitution Tags

Substitution Tag Type Value Set By …

#ITEM.ID#

Common

The ID of an item that is rendered through 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 through the HTML content layout template

Compare this with #item.id#, which is the ID of a specific version of an item. See #item.id# for more information.

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 through the HTML content layout template

See the example in #item.masterid#.

#ITEM.TYPE#

Common

The type of the object, such as File

Possible values can be queried from the NAME column in WWSBR_ITEM_TYPES.

For a list of built-in item types, see "Built-In Item Types" following this table.

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

<oracle>
  if #ITEM.TYPE# in ('baseportletinstance',
  'portlet_instance') then
    htp.p('#ITEM.PORTLETCONTENT#');
  else
    htp.p('#ITEM.DESCRIPTION#');
    htp.p('#ITEM.CONTENT#');
  end if;
</oracle>

#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: 

Expired Hidden Deleted
Expired Hidden

Consider using this tag inside <oracle></oracle> tags, for example, in if statements. See the text that follows this table for a usage sample of the <oracle></oracle> tags.

For information on which items are accessible in what states, see Section 18.9.3, "Item URL Security".

#ITEM.STATUSINHTML#

Common

The item status value 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

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

    You can use <oracle></oracle> tags to 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

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

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

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 edit privileges on the item will 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

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 delete privileges on the item 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

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

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: 

<font class="#item.title.style#">
#item.title.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.title.style#">#item.title.label#: 
#item.title.value#</font>

#ITEM.DESCRIPTION#

Common

The Description of the object wrapped in its associated style

This tag is equivalent to: 

<font class="#item.description.style#">
#item.description.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.description.style#">
#item.description.label#:
#item.description.value#</font>

#ITEM.AUTHOR#

Common

The object's Author wrapped in its associated style

This tag is equivalent to: 

<font class="#item.author.style#">
#item.author.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.author.style#">
#item.author.label#: #item.author.value#</font>

#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: 

<font class="#item.keywords.style#">
#item.keywords.label#: #item.keywords.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.keywords.style#">
#item.keywords.label#: #item.keywords.value#
</font>

#ITEM.CREATOR#

Common

The user name of the object's creator, labeled and wrapped in its associated style

This tag is equivalent to: 

<font class="#item.creator.style#">
#item.creator.label#: #item.creator.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.creator.style#">
#item.creator.label#: #item.creator.value#
</font>

#ITEM.CREATEDATE#

Common

The object's create date, labeled and wrapped in its associated style

This tag is equivalent to: 

<font class="#item.createdate.style#">
#item.createdate.label#: #item.createdate.value#
</font>

#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 <font class=" "> tag. For example: 

<font class="#item.createdate.style#">
#item.createdate.label#: #item.createdate.value#
</font>

#ITEM.TRANSLATIONS#

Common

The fully-formed hyperlink to a translation

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

#ITEM.TRANSLATIONS.LABEL#

Common

Translations

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

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

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

In contrast to the #ITEM.TRANSLATIONS# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if no translation is present; in which case, users will receive an HTML error message when they click the link.

#ITEM.TRANSLATIONS.IMAGE#

Common

The translations icon:

The Translations icon

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

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 no longer displays next to the object.

#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

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>

In contrast to the #ITEM.NEWFLAG# this tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if no objects fall within the New Flag time limit; in which case, users will receive an HTML error message when they click the link.

#ITEM.NEWFLAG.IMAGE#

Common

The New Items icon:

New icon

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 that dynamically assembles a 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

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

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 will list the second perspective in the list of perspectives associated with the object. The perspective will display as a link, which, when clicked, will return 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.

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

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

In contrast to the #ITEM.PERSPECTIVES[n]# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will 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

Use this tag inside a <font class=" "> tag. For example: 

<a href="#item.perspectives4.value#">
<font class="#item.perspectives4.style#">
#item.perspectives4.label#
</font></a>

#ITEM.PERSPECTIVES[n].IMAGE#

Common

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.

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

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:

Property Sheet icon

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

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

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>

In contrast to the #ITEM.UPDATEDFLAG# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if no object has been updated within the specified period; in which case, users will receive an HTML error message when they click the link.

#ITEM.UPDATEDFLAG.IMAGE#

Common

The Recently Updated Items icon:

Recently Updated Item icon

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 that dynamically assembles a 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.ITEMFUNCTION#

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

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

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

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

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

In contrast to the #ITEM.ITEMFUNCTION[n]# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if an nth function has not been associated with the object; in which case, users will receive an HTML error message when they click the link.

#ITEM.ITEMFUNCTION[n].STYLE#

Common

The style associated with the object function

Use this tag inside a <font class=" "> tag. For example: 

<a href="#item.function[n].value#">
<font class="#item.function[n].style#">
#item.function[n].label#
</font></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: 

<font class="#item.publishdate.style#">
#item.publishdate.label#: #item.publishdate.value#
</font>

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

This tag uses the format:

DD-MON-YYYY HH12:MI PM

For example:

06-MAY-2004 01:45 PM

#ITEM.PUBLISHDATE.STYLE#

Common

The style applied to the object's publish date

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.publishdate.style#">
#item.publishdate.label#: #item.publishdate.value#
</font>

#ITEM.CATEGORY#

Common

The fully-formed hyperlink to a search results page that links to all objects classified under the relevant category

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

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

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

In contrast to the #ITEM.CATEGORY# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if no category has been applied to the object; in which case, users will receive an HTML error message when they click the link.

#ITEM.CATEGORY.STYLE#

Common

The style applied to the object's category

Use this tag inside a <font class=" "> tag. For example: 

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

#ITEM.CATEGORY.IMAGE#

Common

The image associated with a category

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 is present and prevent attempts at rendering when it 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: 

<font class="#item.updatedate.style#">
#item.updatedate.label#: #item.updatedate.value#
</font>

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

This tag uses the format:

DD-MON-YYYY, for example, 06-MAY-2004

#ITEM.UPDATEDATE.STYLE#

Common

The style applied to the object's update value

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.updatedate.style#">
#item.updatedate.label#: #item.updatedate.value#
</font>

#ITEM.UPDATOR#

Common

The username of the user who last updated the object, labeled and wrapped in the associated style

This tag is equivalent to: 

<font class="#item.updator.style#">
#item.updator.label#: #item.updator.value#
</font>

#ITEM.UPDATOR.LABEL#

Common

Last Updated By

#ITEM.UPDATOR.VALUE#

Common

The user name of the user who updated the object

#ITEM.UPDATOR.STYLE#

Common

The style applied to the object updator attribute

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.updator.style#">
#item.updator.label#: #item.updator.value#
</font>

#ITEM.EXPIREDATE.LABEL#

Item

Expire Date

#ITEM.EXPIREDATE.VALUE#

Item

The string value of the date the item will expire

This tag uses the format:

DD-MON-YYYY HH12:MI PM, for example, 06-MAY-2004 01:45 PM

#ITEM.EXPIREDATE.STYLE#

Item

The style applied to the item's expire date

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.expiredate.style#">
#item.expiredate.label#: #item.expiredate.value#</font>

#ITEM.VERSIONS#

Item

The fully-formed hyperlink to a page listing all available versions of the item

Item versioning must be enabled for the page group for this hyperlink to display.

#ITEM.VERSIONS.LABEL#

Item

Versions

#ITEM.VERSIONS.VALUE#

Item

The URL that renders a page that lists hyperlinks to each of the item's versions (a location within the portal), indicates which is the current (displayed) version, shows when the item was last updated, and lists the user who last updated the item

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

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

In contrast to the #ITEM.VERSIONS# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if versioning is not enabled for the page group; in which case, users will receive an HTML error message when they click the link.

#ITEM.VERSIONS.IMAGE#

Item

The versions icon:

Versions icon

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

For example: 

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

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

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

#ITEM.DOCUMENTSIZE#

Item

The size of the uploaded file or image item, labeled and wrapped in its associated style

This tag is equivalent to: 

<font class="#item.documentsize.style#">
#item.documentsize.lable#: #item.documentsize.value#
</font>

#ITEM.DOCUMENTSIZE.LABEL#

Item

Document Size

#ITEM.DOCUMENTSIZE.VALUE#

Item

The size of the uploaded file or image item

#ITEM.DOCUMENTSIZE.STYLE#

Item

The style applied to the item's document size

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.documentsize.style#">
#item.documentsize.label#: #item.documentsize.value#
</font>

#ITEM.VIEWASHTML#

Item

The fully-formed hyperlink to the item displayed as HTML

This lets you see binary files with textual content as a Web page. Such files include Microsoft Word documents or Excel spreadsheets.

If the item cannot be displayed as HTML, the link does not display.

#ITEM.VIEWASHTML.LABEL#

Item

View as HTML

#ITEM.VIEWASHTML.VALUE#

Item

The URL that renders the file item content as HTML

This tag enables you to see binary files with textual content as a Web page. Such files include Microsoft Word documents or Excel spreadsheets.

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

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

In contrast to the #ITEM.VIEWASHTML# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if the item cannot be viewed as HTML; in which case, users will receive an HTML error message when they click the link.

#ITEM.VIEWASHTML.IMAGE#

Item

The View as HTML icon:

View as HTML icon

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

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

You can use this tag in conjunction with the #item.viewashtml.value# and #item.viewashtml.label# tags to link to an HTML view of the binary file (that is, the Microsoft Word file, the Excel spreadsheet, and the like).

For example: 

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

#ITEM.THEMES#

Item

The fully-formed hyperlink to the linguistic themes of the item's content

If Oracle Text is not enabled, the link does not display.

#ITEM.THEMES.LABEL#

Item

View Themes

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

#ITEM.THEMES.VALUE#

Item

The URL that renders the linguistic themes of the content

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

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

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

In contrast to the #ITEM.THEMES# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if Oracle Text is not turned on; in which case, users will receive an HTML error message when they click the link.

#ITEM.THEMES.IMAGE#

Item

The themes icon:

Themes icon

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

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

You can use this tag in conjunction with the #item.themes.value# and #item.themes.label# tags to link to the item's linguistic themes.

For example: 

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

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

#ITEM.GIST#

Item

The fully-formed hyperlink to a paragraph summarizing the item's content (its gist)

If Oracle Text is not enabled, the link does not display.

#ITEM.GIST.LABEL#

Item

View Gist

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

#ITEM.GIST.VALUE#

Item

The URL that renders a paragraph that summarizes the document

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

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

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

In contrast to the #ITEM.GIST# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if Oracle Text is not turned on; in which case, users will receive an HTML error message when they click the link.

#ITEM.GIST.IMAGE#

Item

The gist icon:

Gist icon

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

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

You can use this tag in conjunction with the #item.gist.value# and #item.gist.label# tags to link to a summary paragraph about the item.

For example: 

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

This attribute is used in conjunction with a portal search. It displays only if Oracle Text is enabled and only for File and Simple File items, or items of a type based on the Simple File item type.

#ITEM.CONTENT#

Item

The item content

  • If the item display option is set to display item content directly on the page, the item content is rendered on the page.

  • If the item display option is set to display as a link, an HTML link, using the item's title or Display Name is rendered on the page.

This tag is equivalent to #ITEM.CONTENT.VALUE#.

#ITEM.CONTENT.LABEL#

Item

Item Content

To render the object's display name, use #item.title.value#.

#ITEM.CONTENT.VALUE#

Item

The item content

This tag renders differently for different item types and for each display option, whether content is displayed on the page or as a link on the page:

  • TEXT—On page: The text is rendered; As link: The item's path-based URL is rendered

  • PL/SQL—On page: The string value from the execution of the PL/SQL code is rendered; As link: The item's path-based URL is rendered

  • FILE—On page: The file content is rendered; As link: The item's path-based URL is rendered

  • URL—On page: The content from the URL is rendered; As link: The item's path-based URL is rendered

  • IMAGE—always displays the image path. You can view the image directly on the page by placing this tag in an <img src=" "> tag. If other types of items will be included in a region that uses an HTML Content Layout template, you can use <oracle></oracle> tags to set up a condition that considers the item type and renders the item appropriately.

The value displayed in the browser window depends not only on the object type being rendered, but also on the display option that was selected for the object in OracleAS Portal. When the link display option is selected, the resulting URL that displays in a region formatted with a Content Layout template is not linked. That is, users cannot click the URL to navigate to the object. To make the URL navigable when an object's display option is set to link, enclose the substitution tag in an HREF tag. This will render a link that users can click to render the object.

When an HTML Content Layout template is applied, problems can arise when different objects in the same region have different display option attribute values. See the example following this table for a way to successfully construct a Content Layout template that displays both linked and directly displayed objects in the same region. The example also demonstrates a template that can be applied to both portlet and item regions.

#ITEM.CONTENT.STYLE#

Item

The style applied to the item's label

Use this tag inside a <font class=" "> tag. For example: 

<a href="#item.content.value#">
<font class="#item.content.style#">
#item.content.label#
</font></a>

#ITEM.ITEMTYPEICON#

Item

The icon denoting the item's type with ALT text, aligned and sized as specified in the portal

This tag is equivalent to, for example: 

<img src="#item.itemtypeicon.value#" alt="#item.itemtypeicon.label#" border="0" align="absbottom" width="16" height="16">

The conditions that determine which image is rendered include:

  • For items that have an associated file of a recognized MIME type, this tag renders an image that identifies the MIME type, for example:

    Adobe Portable Document Format icon

    The recognized MIME types are: doc, exe, gif, html, htm, jpg, peg, pdf, ppt, rtf, txt, wav, xls, zip.

  • For other items, this tag renders the image entered for the item type's Image attribute. If no image was provided, the built-in base-type icon is used.

#ITEM.ITEMTYPEICON.LABEL#

Item

The type of item:

The conditions that determine which text is rendered include:

  • For items that have an associated file of a recognized MIME type, this tag renders the text that identifies the MIME type, for example, Adobe Portable Document Format.

    The recognized MIME types are: doc, exe, gif, html, htm, jpg, peg, pdf, ppt, rtf, txt, wav, xls, zip.

  • For other items, this tag renders the value entered for the item type's Display Name attribute.

When the page group is rendered in a language other than its default language, the text is translated automatically when a translation is available in the language. For example:

  • Translations for recognized MIME types and built-in item types are available.

  • Translation for a custom item type is available when a translation is provided for the item type's Display Name attribute.

#ITEM.ITEMTYPEICON.VALUE#

Item

The URL of the image that represents the item type

The conditions that determine which image is rendered include:

  • For items that have an associated file of a recognized MIME type, this tag renders a URL of an image that identifies the MIME type.

    The recognized MIME types are: doc, exe, gif, html, htm, jpg, peg, pdf, ppt, rtf, txt, wav, xls, zip.

  • For other items, this tag renders the URL of the image entered for the item type's Image attribute. If no image was provided, the built-in base-type icon is used.

You can use two ITEMTYPEICON tags together to render an icon of a standard size and its Alt text. For example: 

<img src="#item.itemtypeicon.value#" alt="#item.itemtypeicon.label#" WIDTH="16" HEIGHT="16">

The WIDTH and HEIGHT values guarantee consistency in the rendered icon's size.

#ITEM.SUBSCRIBE#

Item

A fully-formed subscription link

If approvals and notifications are not enabled, the link does not display. Use this tag only when approvals and notifications are enabled for the page group that owns the page where the item is placed.

#ITEM.SUBSCRIBE.LABEL#

Item

Subscribe or Unsubscribe

You can use this tag in conjunction with the #item.subscribe.value# tag to render a subscription or an unsubscribe link. For example: 

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

You can also wrap the value tag around your own label text. But keep in mind, all items placed in the same region use whatever static label you enter.

Use this tag only when approvals and notifications are enabled for the page group that owns the page where the item is placed.

The value that is rendered by this tag depends on the state of the item. If the item is not yet subscribed to, #item.subscribe.label# returns Subscribe. If the item is already subscribed to, #item.subscribe.label# returns Unsubscribe.

#ITEM.SUBSCRIBE.VALUE#

Item

The URL that enables users to subscribe to an item or the URL that enables users to unsubscribe from an item

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

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

In contrast to the #ITEM.SUBSCRIBE# tag, consider placing the VALUE tag in a PL/SQL conditional statement to control whether it will render. Otherwise, there is a possibility that the link will render even if item subscriptions are not enabled; in which case, users receive an HTML error message when they click the link.

Use this tag only when approvals and notifications are enabled for the page group that owns the page where the item is placed.

The value that is rendered by this tag depends on the state of the item. If the item is not yet subscribed to, #item.subscribe.value# returns the URL that allows users to subscribe to the item. If the item is already subscribed to, #item.subscribe.value# returns the URL that allows users to unsubscribe from the item.

#ITEM.SUBSCRIBE.IMAGE#

Item

The Subscribe icon:

Subscribe icon

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

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

You can use this tag in conjunction with the #item.subscribe.value# and #item.subscribe.label# tags to render the item's subscribe link.

For example: 

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

Once an item is subscribed to, OracleAS Portal automatically switches this image to the Unsubscribe icon:

Unsubscribe icon

Use this tag only when approvals and notifications are enabled for the page group that owns the page where the item is placed.

#ITEM.VERSION_NUMBER#

Item

The numeric value that identifies a particular item version, labeled and wrapped in its associated style

This tag is equivalent to: 

<font class="#item.version_number.style#">
#item.version_number.label#: #item.version_number.value#
</font>

#ITEM.VERSION_NUMBER.LABEL#

Item

Version Number

#ITEM.VERSION_NUMBER.VALUE#

Item

The numeric value that identifies a particular version

#ITEM.VERSION_NUMBER.STYLE#

Item

The style applied to an item's version number.

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.version_number.style#">
#item.version_number.label#: #item.version_number.value#
</font>

#ITEM.[attribute_name].LABEL#

Item

The custom attribute's display name

#ITEM.[attribute_name].VALUE#

Item

The stored value of the custom attribute

#ITEM.[attribute_name].STYLE#

Item

The style applied to the custom attribute

Use this tag inside a <font class=" "> tag. For example: 

<font class="#item.[attribute name].style#">
#item.[attribute name].label#: 
#item.[attribute name].value#
</font>

#ITEM.PORTLETCONTENT#

Portlet

The portlet

This tag renders the same content as the #item.portletcontent.value# tag.

#ITEM.PORTLETCONTENT.LABEL#

Portlet

Portlet Content

Use the tag #item.title.value# to render the object's display name.

#ITEM.PORTLETCONTENT.VALUE#

Portlet

The portlet

For example, If the Favorites portlet is added to a region formatted with an HTML Content Layout containing this tag, this tag will render the Favorites portlet.


Built-In Item Types

Any one of the following values can be returned for the #ITEM.TYPES# substitution tag. These are the item types that are returned from a query on the Name column in the WWSBR_ITEM_TYPES table:

E.4 Database Portlet Substitution Tags

Use the tags listed in Table E-7 when you construct Unstructured User Interface templates for database portlets. For more information about templates for database portlets, see Chapter 13, "Providing a Standard Look and Feel".

Table E-7 Database Portlet Substitution Tags

Substitution Tag Value Set By …

#BODY#

The database portlet

#OWNER#

The Portal schema that owns the database portlet

#IMAGE_PREFIX#

The OracleAS Portal images directory as specified in the plsql.conf configuration file

#USER#

The user name of the user who is currently logged on

#USER.FULLNAME#

The full name of the user who is currently logged on

The full name includes the user's first, middle, and last names.

#USER.FIRSTNAME#

The first name of the user who is currently logged on

#USER.MIDDLENAME#

The middle name of the user who is currently logged on

#USER.LASTNAME#

The last name (surname) of the user who is currently logged on

#VERSION#

The version of this installation of OracleAS Portal

#HELPSCRIPT#

The JavaScript function used to open a window to display the OracleAS Portal online help

If you include #HELPLINK# in your template, you should also include this tag.

#DIRECTION#

The direction of character layout (left-to-right or right-to-left)

This value is set based on the language selected for the portal. Use it in conjunction with portals using bi-directional languages. For example, using PL/SQL (between <oracle></oracle> tags), you can set up if statements that query the current text direction and, based on the result, set the alignment of template elements using the #ALIGN_LEFT# and #ALIGN_RIGHT# tags.

#ALIGN_LEFT#

Align content to the left

#ALIGN_RIGHT#

Align content to the right

#TITLE#

The portlet's display name as assigned through the portal

#HEADING# and #TITLE# render the same content.

One way to use the #title# substitution tag is to pass it as a parameter that tells you the page a user was on when he, for example, clicked your "Contact Us" link. For example: 

<HEAD>
<TITLE>#TITLE#</TITLE>
#PAGE.STYLE#
#PAGE.BASE#
</HEAD>
<Body leftMargin="0" rightMargin="0" topMargin="0" marginheight="0" marginwidth="0" class="PageBG">
#BODY#
<a href=
"http://www.<page_that_takes_URL_Param.com?currPage=#TITLE#">Contact Us</a>
</BODY>
</HTML>

#HEADING#

The portlet's display name as assigned through the portal

#HEADING# and #TITLE# render the same content.

#HELPLINK#

Portlet help URL

#HOMELINK#

Portal home URL

#FRAMELINK#

Portlet frame URL


  Previous
Previous 		Next
Next
  Go To Documentation Library
Home		 Go To Product List
Solution Area		 Go To Table Of Contents
Contents		 Go To Index
Index