Developer’s Guide

9-8 Developer’s Guide
Categories of CDML tags
There are three types of FileMaker CDML tags:
• 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 9-3 for information.)
• 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.
• 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:
Use tags in For this type of interaction
this category 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) Display dynamic field name and value list information in
Dynamic 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.
Use tags in
this category with FileMaker Pro
For this type of interaction
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
Hidden Do not display this INPUT tag (–db, –lay,
–db & –lay, –error, –format, or –token)
Links Display a format file based on CDML replacement or
action tags within HREF, MAILTO, and SRC (image)
links
Logical Conditionally display data within the [FMP-If] and
[FMP-Else] replacement tags
Looping Display multiple lines of data within one of these looping
types of replacement tags (Current Find, Current Sort,
Layout Fields, Portal, Record, Repeating Fields, Value
List, or Value Names)
Names Only
names from any open database
Display a list of database, field, layout, script, or value list