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"]/>

Attributes

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 attribute takes precedence over an argument passed in with the PACKEDARGS attribute. 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 Sites 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 ARGUMENT parameter of a CALLELEMENT tag.

If you want to pass the packed string as-is, it should be passed as a user defined ARGUMENT parameter. You'll need to unpack the arguments before using them.

Note that the output string of this tag should not be used as a cache criteria.

Error Numbers

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 ELEMENTNAME="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 >
	Oracle XML Tag Reference Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved.