The <_call> tag is used to call instances of interface modules. The body of the tag contains the arguments
to the command, if any.
Body of the <_call> tag:
The body of the <_call> tag consists of a series of argument=value pairs
seperated by carriage returns or "\n". The body is optional; some commands may not require any arguments. The value
portion of each argument=value pair may consist of a simple string, a variable, or a call to another command
to get it's return value.
Attributes of the <_call> tag:
name=<name of the module instance to call from> (Required)
The name attribute is the name of the module instance to call. This is the name that you assigned in the<_load> tag.
cmd=<command name> (Required)
The cmd attribute is the name of the method within the interface module to call. (The actual methods in
the Java objects representing interface modules are called CMD_commandname, see Writing Interface Modules.)
quiet=<yes/no> (default=no) (Optional)
If the quiet attribute is set to 'yes' then no output will be produced by this command to the http output
stream.
assign=<variable name> (Optional)
If the assign attribute is present then the variable named in this attribute receives the return value
of this command (if there is one). The variable here is named without the preceding dollar sign (e.g. assign="variablename"
not assign="$variablename").
assignoutput=<variable name> (Optional)
The assignoutput attribute works like the assign attribute except that the http output stream output
from the command is assigned to the variable. Use quiet="yes" if you don't want the output to also be printed.
printreturnvalue=<yes/no> (default=no) (Optional)
If printreturnvalue is set to 'yes' then the return value will be printed to the http output stream.
Examples of the <_call> tag:
<_call name="modulename" cmd="modulecommand">
arg1=This is the first argument
arg2=$var1:default value if var1 does not exist
arg3=$var2
arg4=!util:getsession:var=somesessionvar
</_call>
<_call name="itembrowser" cmd="templateitemlist">
itemcount=8
template=$itemlisttemplate
saletmpl=$saletemplate
pricelevel=0
blankimage=art/blank.gif
</_call>
