Home > Contents > 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
andresargs2
columns of the SiteCatalog.
4. Variables set in the
resdetails1
andresdetails2
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
, therendermode
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
andbar
:<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
Home > Contents > Index > ![]()
Oracle JSP Tag Reference
Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.