Developer’s Guide

9-12 Developer’s Guide
For examples of error pages, see the gb_error.htm file in the Guest
Book example, the errors.htm file in the Employee Database
example, and the reqfielderror.htm file in the Shopping Cart
example. (See
“Looking at the three CDML examples” on page 9-13
for more information.)
Developer Extras\FileMaker, Inc\External FileMaker APIs\CDML\CDML
Examples
Using an encoding parameter with a CDML
replacement tag
You can use a special encoding parameter with certain CDML
replacement tags to specify how the data will be encoded by the web
browser when it is sent to the web page.
[FMP-Field: Information, Break]
This encoding
parameter Tells the browser to do this
Raw Don’t perform any encoding
HTML Use standard HTML encoding
Format
(new parameter)
Use standard HTML encoding and replace text, numbers,
dates, times, and container size formatting with
FileMaker Pro formats (for example, to add <BOLD> and
<ITALIC> elements)
This new parameter can be used with the [FMP-Field] and
[FMP-RepeatingItem] replacement tags. (See “Using an
intratag parameter” on page 9-9.)
Break Use standard HTML encoding and replace soft carriage
returns with the <BR> HTML element
This encoding
parameter Tells the browser to do this
Display Translate text to the language specified in the Web
Companion Configuration dialog box. Use this parameter
with the [FMP-CurrentAction], [FMP-FindOpItem], and
[FMP-SortOrderItem] replacement tags.
For information, see the CDML Reference database
(described in “About the CDML Reference database” on
page 9-9) and “Setting Web Companion configuration
options” on page 8-3.
URL Use URL encoding, which includes converting spaces to
%20.
The encoding parameters are displayed in the Parameters pop-up
menu in the CDML Tool when the appropriate CDML replacement
is selected. (See
“Using the Tags tab” on page 9-6.)
Planning your web site
You’ll need to create a format file for every type of interaction with
FileMaker Pro that you want your web site to provide. As you create
each format file, you’ll need to know
• what web users will do on the page
• what type of requests will be made to the database
• which format file will be displayed as a result of each request
You’ll also need to create pages to display error messages and other
types of feedback.
As you add CDML tags to a format file, you’ll need to know in
advance what the names are of the database, the layout you want to
use, and the next format file in the sequence. A flowchart can be
useful to map out the page links and interactions with each database.