This tag produces a complete URL (from the servlet name onward) from the arguments, previously packed arguments, and the servlet name (usually ContentServer or BlobServer) provided.
- Input. Name of the servlet to use when rendering the URL, which is either ContentServer or BlobServer. Or you can include all the information for the URL to the left of the page name (which is supplied dynamically). For example:
- Input. Name of the variable that stores the URL generated by this tag.
- Input. Whether or not to include session IDs in the URL when a browser is set to reject cookies.
truemeans to encode session IDs in the URL.
falsemeans not to. If this parameter is not specified, it is set to
- Input. Name/value pairs to pass to 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
PACKEDARGSparameter. If the same argument is passed in with both, the
PACKEDARGSversion is overridden by the
- Input. Previously created URL-encoded packed arguments, in standard form; that is, the output of a previous
This tag creates a URL based on the arguments and packed arguments that are passed to it. All characters in the URL are URL-encoded.
Typically, you call the standard Sites GetPageURL element to obtain URLs for hyperlinks on a page. That element is coded to preserve and resolve the various Sites variables that are necessary for rendering pages in the Sites environment. However, in special cases, you might need to use this tag to obtain a URL instead.
For example, if your site is static but you want to present a dynamic URL inside a static HTML file, use this tag. A URL created with this tag remains dynamic, even when passed through the Export to Disk publishing method. That is, Export to Disk does not translate a dynamic URL created by this tag into a static HTML file.
On a dynamic site, you can use this tag if your page or pagelet exists completely outside of the Sites environment and you do not need to preserve any of the Sites variables (
p) other than
rendermodewhen creating a URL for it.
This tag completes the appropriate URL encoding required for all the arguments passed to it--with the exception of arguments passed in as
PACKEDARGS,which are assumed to be already URL-encoded. (The
RENDER.PACKARGStag URL-encodes arguments passed to it, which are the arguments you pass in to
This tag also includes session IDs in the URL, according to the conventions of the local application server, if a browser is set to reject cookies.
The possible values of errno include:
Value Description -1004 An argument is missing.
This code uses
RENDER.PACKARGSto URL-encode the name of the site as a string and then uses
RENDER.ENCODEto create a URL that includes the previously encoded string:<RENDER.PACKARGS OUTSTR="myPackedArgs" ARGS_assetID="Variables.oid"/> <RENDER.ENCODE STR="ContentServer" PACKEDARGS="Variables.myPackedArgs" OUTSTR= "myURL"/>
Home > Contents > Index >
Oracle XML Tag Reference
Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.