Custom Web Publishing Guide

Chapter 4
|
Introduction to Custom Web Publishing with XSLT 49
For more information about the CDML to XSLT mapping rules and other situations where you will have to
manually fix XSLT statements because the CDML tag conversion could not be done, see
appendix C,
“Converting CDML solutions to FileMaker XSLT.”
Notes
1 If there are any query parameters that reference CDML format files from database fields, you will need
to manually update the references in the database. If any such references are found in any of the
converted XSLT stylesheets, a note is inserted in the XSLT stylesheet reminding you to make the
changes in the database.
1 If the converted XSLT stylesheets include a FileMaker date or time extension function, such as
fmxslt:get_date(), then the function uses the “fm” formats for strings. The “fm” formats are MM/dd/yyyy
for date,
HH:mm:ss for time, and MM/dd/yyyy HH:mm:ss for timestamp. See “Using the date, time, and day
extension functions” on page 72. After conversion, you must manually change and localize date and time
formatting strings that are passed to these functions, such as changing Month/Day/Year to Day/Month/
Year.
Using the CDML Converter’s generated stylesheets
After fixing the errors in the converted XSLT stylesheets, you can use them with the Web Publishing Engine.
See the following section,
“Using FileMaker XSLT stylesheets in a web site or program.”
Testing the CDML Converter’s generated stylesheets
You should thoroughly test the converted XSLT stylesheets before using them in a production environment.
See
chapter 6, “Testing and monitoring a site.”
Using FileMaker XSLT stylesheets in a web site or program
Whether you have used the Site Assistant or the CDML Converter to generate XSLT stylesheets, or you have
created your own stylesheets from scratch, the steps for using them in a web site or program with the Web
Publishing Engine are the same.
To use FileMaker XSLT stylesheets in a web site or program:
1. Copy or place the XSLT stylesheets in the xslt-template-files folder, which is located inside the Web
Publishing
folder inside the FileMaker Server folder on the host where the Web Publishing Engine is
installed.
You can also place the stylesheets in an optional folder or folder hierarchy inside the xslt-template-files
folder.
2. If your XSLT stylesheets reference static files, such as static images or HTML files, place the static files
in their original folder hierarchy within the root folder on the web server. Make sure the relative path is
preserved.
For example, suppose an XSLT stylesheet references an image file called logo.jpg by using the HTML
tag
<img src="logo.jpg">. The logo.jpg file must be located in the following location on the web server:
<root folder>/fmi/xsl/logo.jpg