Home >	Contents >	Index >
Template Tag 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"
      [ARGS_var1="value"]/>

Parameters

ELEMENTNAME (required)

Input. Name of the element to invoke.

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, 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 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 the CS-Direct equivalent of the Content Server CALLELEMENT tag with the following differences:

• Its scope is always local.

• You use CS-Direct 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 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 stacked. The element must exist in the ElementCatalog.

As with the Content Server 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"
      ARGS_c="article"/>

Because the scope is local, parent page information is not inherited by the called element or returned to the calling element.

See Also

CALLELEMENT

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