Developer’s Guide

8-8 Developer’s Guide
For examples of more complex format files, see the CDML examples
included with FileMaker Developer 5.5. These examples are
described in “Planning your web site” on page 8-14.
Categories of CDML tags
There are three types of FileMaker CDML tags:
1 Action tags — these tags are used to make a specific request to the
database, such as to add a record. Action tags always begin with a
hyphen, such as the -new tag. (See “Generating FileMaker Pro CGI
requests using CDML” on page 8-3 for information.)
1 Variable tags — these tags are used to specify the parameters of a
request, such as the names of the database and the layout. They also
begin with a hyphen, such as the -db and -lay tags.
1 Replacement tags — these tags are used to display data from the
database on a web page. They act as placeholders until a request has
been submitted and the requested data is returned to the page.
Replacement tags always begin and end with a square bracket, for
example, [FMP-Field: First Name].
The CDML Tool organizes the CDML tags and HTML form tags
into 15 categories:
New_reply.htm [FMP-LinkRecID: Layout=Layout Name, Format=path-
to-file/Detail.htm]
Results.htm [FMP-RangeStart], [FMP-RangeEnd],
[FMP-CurrentFoundCount], [FMP-RangeSize],
[FMP-LinkPrevious], [/FMP-LinkPrevious]
[FMP-Record]
[FMP-Field: Field Name1], [FMP-Field: Field Name2]
[FMP-LinkRecID: Layout=layout_name, Format=path-
to-file/detail.htm]
[/FMP-Record]
[FMP-LinkNext], [/FMP-LinkNext]
Search.htm -db, -lay, -format, -op -find
This template Contains these CDML tags
Use tags in
this category
For this type of interaction
with FileMaker Pro
Action Delete, duplicate, edit, find, or add a record, find all
records, find a random record, reset a form, or view a
format file containing replacement tags or value lists
Email Display an email form (containing BCC, CC, Format,
From, Host, Subject, To, or All Mail Tags)
Fields (Add)
Dynamic
Display dynamic field name and value list information in
HTML form elements (text field, text area, check box,
radio button, repeating fields, scrolling list) and CDML
replacement tags such as [FMP-ValueList] so web users
can view and modify current FileMaker Pro data on the
web page. When changes are made in the database, the
current information is displayed on the web page.
Fields (Add) Static Display static field name and value list information from
the database in HTML form elements (text field, text
area, check box, radio button, repeating fields, scrolling
list). This information does not change on the web page
regardless of changes made in the database.
Fields (Display) Display dynamic field name and value list information in
HTML form elements (text field, text area, check box,
radio button, repeating fields, scrolling list) and display
field data in [FMP-Field], [FMP-ValueListItem], and
[FMP-RepeatingItem] replacement tags. Web users
cannot edit this data.
Fields (Update) Display dynamic field name and value list information in
HTML form elements (text field, text area, check box,
radio button, repeating fields, scrolling list) and display
field data in [FMP-Field], [FMP-ValueListItem], [FMP-
RepeatingItem], and [FMP-Option] replacement tags
within INPUT and SELECT elements so web users can
edit this data
Find Operators Use an operator (AND/OR, OR, hidden, number/dates, or
text) when performing a –find request