Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

render:contentserver

Renders a pagelet from the SiteCatalog table.

Syntax

<render:contentserver
      pagename="nameOfPageEntry"
      [d="Device Group Suffix"]
      [args="variable1,variable2,..."]
      [<render:argument name="variable3" value="value3"]/>
</render:contentserver>

Parameters

pagename (required)

d (optional)

Device Group Suffix(a string that is common suffix of all the templates written for current device group). For example, if d ='Touch' and parameter tname = 'HomeLayout', the tag will try to find a template with name tname_d i.e. HomeLayout_Touch. If it exists, the tag will call this template, otherwise will simply call the template 'HomeLayout' i.e. actual tname provided.

Input. Name of the pagelet entry in SiteCatalog to render.

args (optional)

A comma-separated list of Sites variables to be passed as arguments

render:argument (optional)

Input. Name/value pairs to pass to the called element. For example:

<render:argument name="c" value="Article"/>
<render:argument name="cid" value='<%=ics.GetVar("cid")%>'/>

Description

Use this tag to render a Sites pagelet. The pagelet name must exist in the SiteCatalog table. If the specified pagelet is already cached, this tag loads it. If the specified pagelet is not already cached, this tag caches it (if caching is enabled for it) and loads it. Note that this tag only uses the Sites cache, i.e. it is not using Satellite caching capabilities (similar to using the embedded caching style with render:calltemplate). In order to use Satellite caching capabilities, use render:satellitepage instead.

Variables passed to the ContentServer servlet are subject to the following order of precedence:

1. Variables set in arguments.

2. Variables set in scripts.

3. Variables set in the resargs1 and resargs2 columns of the SiteCatalog.

4. Variables set in the resdetails1 and resdetails2 columns of the ElementCatalog.

Notes

• The variable scope is local, i.e. variables in the calling element are not available in the called element (unless explicitly passed in); changes made to variable values in the called element are not reflected in the calling element; and new variables set in the called element are not available to the calling element.

• similarly to render:callelement, the rendermode system variable is implicitly passed as an argument to the SiteCatalog entry. This variable is managed transparently, it is required for the proper rendering of web pages generated by Sites.

Error Numbers

There are no possible errno for this tag.

Example

This code calls for a pagelet called "My/Pagelet", passing arguments foo and bar:

    <render:contentserver pagename="My/Pagelet" args="foo">
        <render:argument name="bar" value="myValue"/>
    </render:contentserver>

It is equivalent to:

    <render:contentserver pagename="My/Pagelet">
        <render:argument name="foo" value='<%=ics.GetVar("foo")%>'/>
        <render:argument name="bar" value="myValue"/>
    </render:contentserver>

See Also

render:satellitepage

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.