Custom Web Publishing Guide

Table Of Contents

44 Custom Web Publishing Guide

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:

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.

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.