TSC - For all your computer needs
You Provide the Problem, We Provide the Solution
Website Hosting Company Reviews Cheap Domain Names
Tips, Tricks and Coupons
Home
Services
Resources
Store


FileMaker CDML Reference

Page 1 Page 2 Page 3 Page 4 Page 5
Tag Name Description
-MailSub What it does
Specifies the subject of the email.

Value is
Subject text.

Syntax example(s)
Send mail using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="contacts.fp5">
<input type="hidden" name="-Format" value="displaypage.html">
<input type="text" name="-MailTo" value="[email protected]">
<input type="text" name="-MailCC" value="[email protected]">
<input type="text" name="-MailBCC" value="[email protected]">
<input type="text" name="-MailFrom" value="[email protected]">
<input type="text" name="-MailSub" value="The Subject">
<input type="hidden" name="-MailHost" value="SMTP.Company.COM">
<input type="hidden" name="-MailFormat" value="mail.txt">
<input type="submit" name="-View" value="Send Message">
</form>

Other tags that are required
-DB, -MailTo, -MailFrom, -MailHost, -MailFormat, any action tag

See also
-MailCC, -MailBCC

Back to Top
Submit What it does
An HTML input type. Used by a browser to create a button that will perform an action. FileMaker Pro action tags can be used with a submit button.

This is not a FileMaker Pro tag, This is standard HTML.

Do not include calculation or summary field types on add or update format files, as data can't be entered into these field types.

Syntax
<input type="submit" name="Action Tag" value="Button Text">

Action Tag - Action to perform when the button is pressed.
Button Text - Button label text.

Syntax example(s)
Create a new record using an HTML file
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="db.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="radio" name="Country" value="F1">France
<input type="radio" name="Country" value="G7" checked>Germany
<input type="radio" name="Country" value="I4" checked>Iceland
<input type="radio" name="Country" value="U2">USA
<input type="submit" name="-New" value="New Record">
</form>

Back to Top
Text What it does
An HTML input type. Used by a browser to display a single line of text.

This is not a FileMaker Pro tag, This is standard HTML.

Do not include calculation or summary field types on add or update format files as data can't be entered into these field types.

Syntax
<input type="text" name="Field" value="Data">

Field - The name of the field that you want the data to go into.
Data - The information that should be placed into the field.

Syntax example(s)
Display a text field using an HTML file
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="db.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="text" name="Field Name" value="v1">
<input type="submit" name="-New" value="New Record">
</form>

Back to Top
TextArea What it does
An HTML input type. Used by a browser to display multiple lines of text.

This is not a FileMaker Pro tag, This is standard HTML.

Do not include calculation or summary field types in an add or update format files as data can't be entered into these field types.

Syntax
<textarea name="Field" rows=Rows cols=Columns > Data </textarea>

Field - The name of the field that you want the data to go into.
Rows - Number of rows of text to display.
Columns - Number of characters to display per row.
Data - The information that should be placed into the field.

Syntax example(s)
Display a text area using an HTML file
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="db.fp5">
<input type="hidden" name="-Format" value="results.htm">
<textarea name="Description" rows=4 cols=40>
Lots of text goes here.
</textarea>
<input type="submit" name="-New" value="New Record">
</form>

Back to Top
-MailTo What it does
Specifies the email address of the person who the message is going to.

Value is
An email address.

Syntax example(s)
Send mail using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="contacts.fp5">
<input type="hidden" name="-Format" value="displaypage.html">
<input type="text" name="-MailTo" value="[email protected]">
<input type="text" name="-MailCC" value="[email protected]">
<input type="text" name="-MailBCC" value="[email protected]">
<input type="text" name="-MailFrom" value="[email protected]">
<input type="text" name="-MailSub" value="The Subject">
<input type="hidden" name="-MailHost" value="SMTP.Company.COM">
<input type="hidden" name="-MailFormat" value="mail.txt">
<input type="submit" name="-View" value="Send Message">
</form>

Other tags that are required
-DB, -MailFrom, -MailSub, -MailHost, -MailFormat, any action tag

See also
-MailCC, -MailBCC

Back to Top
-Token What it does
Passes any value to a format file. Whatever value you set -Token equal to can be retrieved in the format file by using the [FMP-CurrentToken] tag, or it can be used in an [FMP-If] tag.

Value is
User defined.

Syntax example(s)


Pass a record ID as a token using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="contacts.fp5">
<input type="hidden" name="-Format" value="format.html">
<input type="hidden" name="-Token" value="[FMP-CurrentRecID]">
<input type="submit" name="-FindAll" value="Set a token">
</form>

Continue to pass as token
<input type="hidden" name="-Token" value="[FMP-CurrentToken]">

Specify a token using a link
<a href="-DB=Contacts&-Format=format.html&-Token=The+Token&-View">Set a token</a>

Up to nine tokens can be used by using a slightly different syntax for the
token tags. The variable tag -Token can have an optional token specifier of the form -Token.X
where X can be the characters 0 through 9. If no period follows the -Token keyword then token
one is implied. To retrieve the value of a token the FMP_CurrentToken will accept another
parameter that is a number, of value 0 through 9. If there is no number parameter, but there
is a period, then token zero would be returned. CurrentToken constant for the FMP-If tag
would then have an optional specifier that would look like CurrentToken:3 if you want to
compare the contents of token three to something else.


Example format file snippet:
<!-- Pass the value of token three onto the next request -->
<INPUT TYPE="HIDDEN" NAME ="-Token.3" VALUE ="[FMP-CurrentToken: 3, HTML]">

Tokens can be used on the right side of an FMP-If using the intratag replacement syntax:

[FMP-If: CurrentToken:5.eq.{CurrentToken:6}]
<B>Token 5 equals token 6.</B>
[/FMP-If]

Other tags that are required
-DB, -Format, any action tag

See also
[FMP-CurrentToken]

Back to Top
[FMP-ValueList] What it does
Repeats the HTML between [FMP-ValueList] and [/FMP-Valuelist] for all the values in the specified value list.

Syntax
[FMP-ValueList: Field Name , List=Value List Name ]

Parameter(s)
First parameter: Name of a field that the value list is associated with.

Second parameter (optional): Name of a value list to use. The default is to use the value list associated with the field on the specified layout.

Syntax example(s)
Display value List using an HTML file
[FMP-ValueList: Groups, List=GroupList]
<input type="radio" name="Groups"
value="[FMP-ValueListItem]" [FMP-ValueListChecked]>[FMP-ValueListItem]
[/FMP-ValueList]

<!-- After processing, the HTML sent to the browser could look like:
<input type="radio" name="Groups"
value="Production" >Production
<input type="radio" name="Groups"
value="Sales" checked>Sales
<input type="radio" name="Groups"
value="Support" >Support
-->

Other tags that are required
[/FMP-ValueList]

See also
[FMP-Option], [FMP-ValueListChecked], [FMP-ValueListItem]

Back to Top
[FMP-ValueListChecked] What it does
[FMP-ValueListChecked] is replaced with the word "checked" for every value list item that has been selected in the specified field.

Syntax example(s)
Display a value list as radio buttons using an HTML file
[FMP-ValueList: Groups]
<input type="radio" name="Groups"
value="[FMP-ValueListItem]" [FMP-ValueListChecked]>[FMP-ValueListItem]
[/FMP-ValueList]

<!-- After processing, the HTML sent to the browser could look like:
<input type="radio" name="Groups"
value="Production">Production
<input type="radio" name="Groups"
value="Sales" checked>Sales
<input type="radio" name="Groups"
value="Support">Support
-->

Other tags that are required
[FMP-ValueList], [/FMP-ValueList]

See also
[FMP-ValueListItem], [FMP-Option]

Back to Top
[FMP-ValueListItem] What it does
[FMP-ValueListItem] is replaced with the next element of a value list.

[FMP-ValueListItem] must be placed between the [FMP-ValueList] and [/FMP-ValueList] tags.

Syntax
[FMP-ValueListItem: Checked, Encoding ]

Parameter(s)
First parameter (optional): Checked. Use one of the following reserved words:
Checked - Replace with the value list item if it is selected in the database. Replace with nothing if the value list item is not selected in the database.
Always - (default) Always replace with the value list item.

Second parameter (optional): Encoding. Use one of the following reserved words:
Raw - Don't perform any encoding
URL - Perform URL encoding
HTML - (default) Perform HTML encoding

Syntax example(s)
Display value list as radio buttons using an HTML file
[FMP-ValueList: Groups]
<input type="radio" name="Groups"
value="[FMP-ValueListItem]" [FMP-ValueListChecked]>[FMP-ValueListItem]
[/FMP-ValueList]

<!-- After processing, the HTML sent to the browser could look like:
<input type="radio" name="Groups"
value="Production" checked>Production
<input type="radio" name="Groups"
value="Sales">Sales
<input type="radio" name="Groups"
value="Support" checked>Support
-->

Display only value list items that are selected using an HTML file
[FMP-ValueList: Groups]
[FMP-ValueListItem: checked]
[/FMP-ValueList]

<!-- After processing, the HTML sent to the browser could look like:
Production Support
-->

Other tags that are required
-DB, [FMP-ValueList], [/FMP-ValueList]

See also
[FMP-ValueListChecked], [FMP-Option]

Back to Top
[FMP-ValueNameItem] What it does
[FMP-ValueNameItem] is replaced by the name of a value list.

[FMP-ValueNameItem] must be placed between the [FMP-ValueNames] and [/FMP-ValueNames] tags.

Syntax
[FMP-ValueNameItem: Encoding ]

Parameter(s)
First parameter (optional): Encoding. Use one of the following reserved words:
Raw - Don't perform any encoding
URL - Perform URL encoding
HTML - (default) Perform HTML encoding

Syntax example(s)
Create a pop-up menu for use with the -SortOrder tag in an HTML file
<select name="-SortOrder">
<option>Ascending
<option>Descending
[FMP-ValueNames]
<option value="Custom=[FMP-ValueNameItem]">[FMP-ValueNameItem]
[/FMP-ValueNames]
</select>

<!-- After processing, the HTML sent to the browser could look like:
<select name="-SortOrder">
<option>Ascending
<option>Descending
<option value="Custom=Colors">Colors
<option value="Custom=Sizes">Sizes
</select>
-->

Other tags that are required
[FMP-ValueNames], [/FMP-ValueNames]

Back to Top
[FMP-ValueNames] What it does
Repeats the HTML between [FMP-ValueNames] and [/FMP-ValueNames] for all the value lists that are in the database.

Syntax example(s)
Create a pop-up menu for use with the -SortOrder tag in an HTML file
<select name="-SortOrder">
<option>Ascending
<option>Descending
[FMP-ValueNames]
<option value="Custom=[FMP-ValueNameItem]">[FMP-ValueNameItem]
[/FMP-ValueNames]
</select>

<!-- After processing, the HTML sent to the browser could look like:
<select name="-SortOrder">
<option>Ascending
<option>Descending
<option value="Custom=Colors">Colors
<option value="Custom=Sizes">Sizes
</select>
-->

Other tags that are required
[/FMP-ValueNames]

See also
[FMP-ValueNameItem]

Back to Top
-View What it does
Displays search or add form. Used to process any format files that do not require record data.

Syntax example(s)
View a format file using a link
<a href="FMPro?-DB=db.fp5&-Format=query.htm&-View">"Take me to a search page"</a>

View a format file using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="query.htm">
<input type="submit" name="-View" value="Show Search Page">
</form>

Other tags that are required
-DB, -Format

Back to Top
Page 1 Page 2 Page 3 Page 4 Page 5


Home Contact TSC About TSC Polyphonic Ringtones Site Map
 

Copyright 2004-2006 TSC
No copying or reproduction of any portion of this site without written consent from TSC