Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

RENDER.CONTENTSERVER

Calls and renders a page or a pagelet from the SiteCatalog table.

Syntax

<RENDER.CONTENTSERVER 
      PAGENAME="nameOfPageEntry"
      [d="Device Group Suffix"]
      [ARGS_var1="value"]/>

Parameters

PAGENAME (required)

Input. The name of the page entry from the SiteCatalog to render.

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.

ARGS_ (optional)

Input. Name/value pairs to pass to the called element, with the string ARGS_ as the prefix for the variable name. For example, Sites sets several variables through the resargs2 column in a page entry. To pass a value for one of these variables to a RENDER.CALLELEMENT tag, you affix ARGS_ to the beginning of the variable: ARGS_cid="Variables.id", ARGS_c="article", and so on.

Note that you can pass in packed arguments using this same syntax. For example: ARGS_PACKEDARGS="mypackedargs"

Description

This tag is equivalent of the <CONTENTSERVER/> tag with the following differences:

• Its scope is as follows: 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.

• You use Sites syntax for passing it variables. That is, rather than passing arguments with an argument statement (<ARGUMENT NAME= "variableName" VALUE="variableValue"/>) you pass them with the ARGS_ parameter (ARGS_variableName="variableValue").

• rendermode is passed to the page entry automatically.

Use this tag to call the ContentServer servlet to serve a Sites page or pagelet. The page or pagelet must have a page entry in the SiteCatalog. 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.

Variables passed to the Sites Module 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

If an element is coded with a RENDER.SATTLELITEPAGE tag but Sites-Satellite is not present, RENDER.SATELLITEPAGE passes the call to RENDER.CONTENTSERVER which then serves the page or pagelet.

Error Numbers

There are no possible errno for this tag.

Example

This code calls for the page entry of a template named PlainList, passing the ID of the asset that it should display and the ID of the asset's parent page:

<RENDER.CONTENTSERVER PAGENAME="BurlingtonFinancial/Collection/PlainList" ARGS_cid="SectionHighlights.oid ARGS_p="Variables.asset:id"/>

See Also

RENDER.SATELLITEPAGE

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