Home > Contents > Index >
Invokes an element as defined in the ElementCatalog table.
<RENDER.CALLELEMENT ELEMENTNAME="nameOfElement" [SCOPED="scope value"] [<RENDER.ARGUMENT NAME="variable1" VALUE="value1"/>] </RENDER.CALLELEMENT>
local
, stacked
, global
. The default value is local
. The following describes the behaviour of the various values:
Value | Description |
---|---|
global |
In global scoping, both the calling element and the called element share the same variable pool. As such, all variables present in the caller will be available in the called element, and any changes made to variables in the called element will be visible in the caller afterwards. Argument tags will create new variables in the called element, and they will be available in the caller afterwards. Global scope is ideal for calling a utility element to set variables for the caller. |
local |
In local scoping, the calling element and the called element have independent variable pools. No variables from the caller will be visible to the called element. Argument tags will create new variables in the called element, and they will not be available in the caller afterwards. Local scope is ideal for calling an element to generate markup. |
stacked |
In stacked scoping, the calling element and the called element have independent variable pools, but some variables will be copied to the caller after execution of the called element. No variables of the caller will be visible to the called element. Argument tags will create new variables in the called element, and the final values of these variables after execution of the called element will be copied to the caller, overwriting any pre-existing values that may have existed. Stacked scoping is a hyrid between |
This tag is the CS-Direct equivalent of the Content Server XML CALLELEMENT tag with the following differences:
rendermode
is passed to the element if it is seteid
is cleared prior to execution of the called element
This tag should be used whenever an element needs to be invoked on a CS-Direct-enabled site. The element must exist in the ElementCatalog. This tag is preferred over the standard CALLELEMENT tag because it is aware of special variables (rendermode
and eid
) that CS Direct elements require. It also offers advanced variable scope handling using the scoped
attribute.
The possible values of errno
include:
Value |
Description |
---|---|
-10 |
The element does not exist. |
-12 |
The element cannot be evaluated. |
The following code sample calls an element named TopPageBreadcrumb
. The called element displays the navigated path taken to reach the currently displayed page. (ex. "Home > News").
<RENDER.CALLELEMENT ELEMENTNAME="BurlingtonFinancial/Site/TopPageBreadcrumb"> <RENDER.ARGUMENT NAME="c" VALUE="Article"/> </RENDER.CALLELEMENT>