Custom Web Publishing Guide

52 FileMaker Server Advanced Custom Web Publishing Guide
To construct a request, the Web Publishing Engine begins by using any query command and query
parameters that are statically defined in the optional
<?xslt-cwp-query?> processing instruction. The statically
defined query command and parameters become the base request. The
<?xslt-cwp-query?> processing
instruction is not required in a stylesheet, but its base request takes precedence over any matching query
command or parameters that are specified in the URL query string. The Web Publishing Engine then adds
to the base request any query command or additional parameters in the URL query string that are
not defined
in the
<?xslt-cwp-query?> processing instruction. The Web Publishing Engine uses this request to obtain the
FileMaker XML data and return it to your web browser or program in the output method you specified, or
as HTML.
About the FileMaker XSLT Extension Function Reference
The FileMaker Server Web Publishing CD includes a FileMaker database called XSLT Reference.fp7 that
contains brief descriptions and examples of each of the FileMaker XSLT extension functions. You can open
the FileMaker XSLT Extension Function Reference in the
Custom Web Publishing Reference folder on the
FileMaker Server Web Publishing CD.
About the URL syntax for FileMaker XSLT stylesheets
The URL syntax for using FileMaker XSLT stylesheets with the Web Publishing Engine is:
<scheme>://<host>[:<port>]/fmi/xsl/[<path>/]<stylesheet.xsl>[?<query string>]
where:
1 <scheme> can be the HTTP or HTTPS protocol.
1 <host> is the IP address or domain name of the host where the web server is installed.
1 <port> is optional and specifies the port that the web server is using. If no port is specified, then the default
port for the protocol is used (port 80 for HTTP, or port 443 for HTTPS).
1 <path> is optional and specifies the folder(s) inside the xslt-template-files folder where the XSLT
stylesheet is located.
1 <stylesheet.xsl> is the XSLT stylesheet filename.
1 <query string> can be a combination of one query command and one or more query parameters for Custom
Web Publishing with XSLT. See
“Using query strings in FileMaker XSLT stylesheets” on page 54, and
appendix A, “Valid names used in query strings.” If the specified stylesheet includes a <?xslt-cwp-
query?> processing instruction, the statically defined query command and parameters take precedence
over any matching query command or parameters in the URL query string. See
“Using statically defined
query commands and query parameters” on page 55.
Note The URL syntax, including the names of the query command and parameters, is case sensitive except
for portions of the query string. The majority of the URL is in lowercase, with the exception of the uppercase
grammar names
FMPXMLRESULT and FMPXMLLAYOUT. For information on the rules for case sensitivity of
the query string, see
“Guidelines for using query commands and parameters” on page 86.
Here is an example of a URL for using a FileMaker XSLT stylesheet with the Web Publishing Engine:
http://192.168.123.101/fmi/xsl/my_template/my_stylesheet.xsl?–grammar=fmresultset&–db=mydatabase
&–lay=mylayout&–findall