Home >	Contents >	Index >

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

render:callelement

Calls an element from the ElementCatalog table.

Syntax

<render:callelement
      elementname="nameOfElement">
      [<render:argument name="variable1" value="value1"/>]
</render:callelement>

Parameters

elementname (required)

Input. Name of the element to invoke.

render:argument (optional)

Input. Name/value pairs to pass to the called element. For example, CS-Direct 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 use an argument. For example:

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

Description

This tag is the CS-Direct equivalent of the Content Server XML CALLELEMENT tag with the following differences:

• Its scope is always local.

• rendermode is passed to the element if rendermode is set to export or preview.

Use this tag to process the content of an element that you wrote for CS-Direct and you want the scope of that element to be local. The element must exist in the ElementCatalog.

As with the XML CALLELEMENT tag, variables that exist prior to render:callelement are available to tags within the called element. Variables passed to an element are subject to the following order of precedence:

1. Variables set in arguments.

2. Variables set in scripts.

3. Variables set in the resdetails1 and resdetails2 columns in the ElementCatalog.

However, because the scope of an element called with this tag is local, variables set within the called element are not available within the parent (calling) element.

errno

The possible values of errno include:

Value	Description
-10	The element does not exist.
-12	The element cannot be evaluated.

Example

The following code sample calls an element named TopPageBreadcrumb. It displays the path you took to get to the currently displayed page. For example, if you visited the News page directly from a link on the Home page, the TopPageBreadcrumb element displays "Home > News".

<render:callelement 
      elementname="BurlingtonFinancial/Site/TopPageBreadcrumb">
      <render:argument name="c" value="Article"/>
</render:callelement>

See Also

render:contentserver

		Home >	Contents >	Index >
	FatWire JSP Tag Reference Copyright 2005 by FatWire Software All rights reserved.