Developer’s Guide

Custom web publishing using CDML 9-9
New and modified CDML tags
The FileMaker Pro 5 Web Companion now supports the following
new or modified CDML tags. Example syntax for these tags is
described in the CDML Reference database (see “About the CDML
Reference database” on page 9-12 for information).
New CDML tags
Replacement Display specific data from the database in one of 44 types
of replacement tags on the web page. For example,
display the web user’s IP address in the [FMP-ClientIP]
replacement tag.
Variables (Add) Generate information from the client (web user’s)
computer based on one of eight replacement tags
received as parameters to a request in the FileMaker Pro
CGI command: [FMP-ClientAddress], [FMP-ClientIP],
[FMP-ClientType], [FMP-ClientUserName], [FMP-
CurrentDate], [FMP-CurrentTime],[FMP-CurrentDay],
and [FMP-CurrentToken]
Variables (Display) Display information in one of 21 replacement tags that
correspond to a specific request parameter. For example,
display the maximum number of records in the [FMP-
MaxRecords] replacement tag as specified by the –max
request parameter (CDML variable tag).
New CDML
action tags Description
–dbopen
(action)
Open a database that’s located in the Web folder.
Required parameters: -db, and -format variable tags
Optional parameter: -password
(Remote administration privileges must be set in the Web
Companion Configuration dialog box.)
See “Opening password-protected databases remotely”
on page 6-15 for more information.
Use tags in
this category
For this type of interaction
with FileMaker Pro
–dbclose
(action)
Close a database that’s open in the Web folder or in a site
folder within the Web folder.
Required parameters: -db, and -format variable tags
(Remote administration privileges must be set in the Web
Companion Configuration dialog box.)
See “Opening password-protected databases remotely”
on page 6-15 for more information.
New CDML
variable tags Description
–errnum
(variable)
Specify a range or single error number to be handled by
the -error variable tag. You can specify discontinuous
ranges, such as -errnum=500-510& -errnum=900-978.
If no error numbers are specified, all errors are handled
by the –error tag.
See appendix C “FileMaker Pro values for error codes”
for a list of error numbers.
–fmtfield
(variable)
Used in conjunction with the –recid variable tag or with
global fields to pull format file information from a field
in the database instead of an HTML file in the Web
folder. The information will be pulled from the global
field or from the record specified by the record ID.
When specifying the –fmtfield variable with the -view
action, the information must be pulled from a global
field.
Required parameter: –recid (for non-global fields)
The –fmtfield parameter is supported in the [FMP-
LinkRecID] tag and included in the link URLs in the
[FMP-LinkNext] and [FMP-LinkPrevious] tags.
–mailfmtfield
(variable)
Used in conjunction with the –recid variable tag or with
global fields to pull email format file information from a
field in the database instead of an HTML file in the Web
folder.
Required parameter: –recid (for non-global fields)
New CDML
action tags Description