Custom Web Publishing Guide

48 FileMaker Server Advanced Custom Web Publishing Guide
5. For Destination Folder, click Select to specify the folder where you want to store the converted XSLT
stylesheets and other files from the CDML web site.
The CDML Converter creates a folder hierarchy and a set of files in the destination folder that correspond
to the source files. The CDML Converter copies files from the source folder that do not require CDML
conversion, such as the GIF files in an images subfolder, without changing them. The converted files
have the same filename, but the filename extension is changed to
.xsl.
6. Locate and select the folder where you want to save the XSLT stylesheets on your hard disk, then click
Select.
7. Click Start.
The CDML Converter converts the CDML format files and saves a conversion log with the converted
XSLT stylesheets in the destination folder you specified. The conversion log is also shown in the CDML
Converter window.
8. Click Done.
Checking and fixing the CDML Converter’s generated stylesheets
After using the CDML Converter, you can obtain error information about the conversion process by
reviewing the conversion log that is shown in the CDML Converter window, or by opening the conversion
log file in the destination folder. The conversion log file is named
cdml2xsl_<datetime>.log, where <datetime>
is the date and time at the start of the conversion.
If a warning or error occurs during the conversion, the CDML Converter adds a message to the conversion
log and inserts an XSLT comment tag into the converted XSLT stylesheet with a description of the problem.
The errors and warnings will be indicated by one of the following in XSLT comment tags in the converted
XSLT stylesheet:
<!-- CDML Converter ERROR: <description of error> -->
<!-- CDML Converter WARNING: <description of warning> -->
The CDML Converter uses a specified set of CDML to XSLT mapping rules to convert the CDML format
files. All conversion errors result from situations where the CDML Converter could not automatically
determine the correct CDML to XSLT conversion. For all conversion errors, you must either manually fix
the cause of the error in the CDML file and then convert the file again, or use a text editor or XSLT stylesheet
editor to manually fix the problems in the converted XSLT stylesheets.
Here are some common types of conversion errors:
1 A CDML tag is not supported in Custom Web Publishing with XSLT. For example, the –dbclose CDML
action tag is not supported. To fix this type of error, you must either change the CDML tag to use a
supported tag, remove the functionality from the CDML format file, or fix the logic in the XSLT
stylesheet.
1 A CDML tag is not recognized. For example, a CDML tag might be misspelled. To fix this type of error,
you must either change the CDML tag to use a valid syntax, remove the tag, or fix the logic in the XSLT
stylesheet.
1 A CDML parameter is not recognized. For example, the CDML List parameter in the [FMP-ValueList: Field
Name, List=Value List Name]
CDML tag is not supported in XSLT stylesheets. To fix this type of error, you
must either change the CDML parameter to use a valid syntax, remove the parameter, or fix the logic in
the XSLT stylesheet.