Custom Web Publishing Guide

26 FileMaker Server Advanced Custom Web Publishing Guide
What’s new in the URL syntax for XML data
In FileMaker Server versions 7 and 8, the Web Publishing Engine uses a URL syntax for accessing XML
data.
1 FileMaker Pro 6 and earlier versions used the following syntax in requests for XML data:
FMPro?<CGI_request>
This syntax has changed. See the next section, “About the URL syntax for XML data.”
1 The –lay query parameter for specifying a database layout is required with all query commands except
–dbnames, –layoutnames, –scriptnames, and –process (XSLT requests only). See appendix A, “Valid
names used in query strings.”
1 The –format parameter is obsolete. The XML grammar for XML requests is specified in the URL syntax
before the query string. See the next section,
“About the URL syntax for XML data.”
Note Unlike XML requests, the grammar for XSLT stylesheets is specified with the –grammar query
parameter. See
“Specifying an XML grammar for a FileMaker XSLT stylesheet” on page 54.
About the URL syntax for XML data
The URL syntax for using the Web Publishing Engine to access XML data from FileMaker databases is:
<scheme>://<host>[:<port>]/fmi/xml/<xml_grammar>.xml[?<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 <xml_grammar> is the name of the FileMaker XML grammar. Possible values are fmresultset.xml,
FMPXMLRESULT.xml, FMPXMLLAYOUT.xml, or FMPDSORESULT.xml. See “Using the fmresultset grammar”
on page 29 and “Using other FileMaker XML grammars” on page 32.
1 <query string> is a combination of one query command and one or more query parameters for FileMaker
XML. (The
–dbnames command doesn’t require any parameters.) See “Using FileMaker query strings to
request XML data” on page 36, and appendix A, “Valid names used in query strings.”
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 three
uppercase grammar names:
FMPXMLRESULT, FMPXMLLAYOUT, and FMPDSORESULT. For information on the
rules for case sensitivity of the query string, see
“Guidelines for using query commands and parameters” on
page 86.
Here are two examples of URLs for accessing XML data via the Web Publishing Engine:
http://server.company.com/fmi/xml/fmresultset.xml?–db=products&–lay=sales&–findall
http://192.168.123.101/fmi/xml/FMPXMLRESULT.xml?–db=products&–lay=sales&–findall