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

RENDER.PACKARGS

Encodes in the URL the name/value argument pairs passed in and writes them to an output string, in standard form, with ampersand characters (&) separating each name/value pair.

Syntax

<RENDER.PACKARGS
      OUTSTR="myPackedArguments"
      [ARGS_arg1="horse"]
      [PACKEDARGS="cat=shadow&dog=darby"]/>

Parameters

OUTSTR (required)

Input. The name of a variable to create that stores the encoded output string.

ARGS_ (optional)

Input. Name/value pairs to be packed by the tag, with the string ARGS_ as the prefix for the variable name. The names and values of these arguments are URL- encoded and incorporated into the final URL.

An argument passed in with this parameter takes precedence over an argument passed in with the PACKEDARGS parameter. If the same argument is passed in with both, the PACKEDARGS version is overridden by the ARGS_ version.

PACKEDARGS (optional)

Input. Previously created URL-encoded packed arguments, in standard form; that is, the output of a previous RENDER.PACKARGS tag.

Description

The GetPageURL element encodes ("packs") the four standard CS-Direct arguments (c, cid, ct, p) before creating a dynamic URL with them. If you need to include additional arguments in a URL, use this tag to URL-encode them ("pack" them) before passing them to the GetPageURL element.

You use this tag to pack up the arguments and store them as a string. Then, you pass that string to the GetPageURL element through the PACKEDARGS parameter of a CALLELEMENT tag.

errno

The possible values of errno include:

Value	Description
-10004	An argument is missing.

Example

This code packs a name/value pair with restricted characters into a URL-encoded string, calls the GetPageURL element, and passes in several arguments, including the URL-encoded (packed) one:

<RENDER.PACKARGS OUTSTR="myPackedArgs" ARGS_location="Brazil/Portugal"/>
<CALLELEMENT NAME="OpenMarket/Xcelerate/Actions/Publish/GetPageURL"/>
   <ARGUMENT NAME="PACKEDARGS" VALUE="myPackedArgs"/>
   <ARGUMENT NAME="ctype" VALUE="Article"/>
   <ARGUMENT NAME="cid" VALUE="Variables.cid"/>
</CALLELEMENT>

See Also

RENDER.ENCODE

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