Custom Web Publishing Guide

54 Custom Web Publishing Guide
Using tokens to pass information between stylesheets
You can use the –token query parameter in a URL or as a statically defined query command to pass any
user-defined information between stylesheets without using sessions or cookies. The –token query parameter
is optional with all query commands.
The user-defined parameter value can be any character string that is URL encoded. For example:
http://192.168.123.101/fmi/xsl/template/my_stylesheet.xsl?-db=products&-lay=sales&-grammar=fmresultset
&-token.D100=Pending&-findall
See “–token.[string] (Pass values between XSLT stylesheets) query parameter” on page 88.
Important: Do not use the –token query parameter to pass private data.
To retrieve the value of the –token query parameter, use the <xsl:param name="request-query" /> statement. See
“Accessing the query information in a request” on page 55.
Using the FileMaker XSLT extension functions and parameters
The FileMaker XSLT extension functions are defined to be in the fmxslt namespace. Make sure you include
a declaration of the fmxslt namespace in the
<xsl:stylesheet> element at the start of your XSLT stylesheet. See
“About namespaces and prefixes for FileMaker XSLT stylesheets” on page 50.
The FileMaker XSLT extension functions have been designed so that you can use them within an XSLT
stylesheet by specifying them as a function call within an XPath statement. XPath statements are used as the
values of the select attribute and the test attribute in numerous XSLT elements.
For example, suppose you want to check the User-Agent header to determine the browser being used. To do
this, you might want to use a variable that contains the value of the User-Agent header:
<xsl:variable name="user-agent" select="fmxslt:get_header('User-Agent')"/>
For the extension functions that return a value, the value will be returned in the XSLT type specified. Many
functions return strings, but a few functions return a node-set that can be traversed.
Note This section describes the FileMaker XSLT extension functions and parameters, and includes some
examples. For additional examples of each function, see the FileMaker XSLT Extension Function Reference.
See
“About the FileMaker XSLT Extension Function Reference” on page 48.
About the FileMaker-specific XSLT parameters set by the Web Publishing Engine
When processing a request, the Web Publishing Engine dynamically sets the values of the following
FileMaker-specific XSLT parameters. You can use the values of these parameters in your stylesheet by using
the
<xsl:param> element.
FileMaker-specific XSLT parameter For more information, see
<xsl:param name="request-query"/> “Accessing the query information in a request” in the next section.
<xsl:param name="client-ip"/>
<xsl:param name="client-user-name"/>
<xsl:param name="client-password"/>
“Obtaining client information” on page 56.
<xsl:param name="xml-base-uri"/> “Using the Web Publishing Engine base URI parameter” on page 56.
<xsl:param name="authenticated-xml-base-uri"> “Using the authenticated base URI parameter” on page 56.