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 Pro CDML Reference

Page 1 Page 2 Page 3 Page 4 Page 5
Memory from Crucial.com - Great Prices Dell Computer Promotions - Great computers and service

 

Tag Name Description
-New What it does
Creates a new record and populates that record with the contents of any field name/value pairs.

A Web user must have Create permission in order to execute this action.

Syntax example(s)
Create a new record using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&Country=Australia&-New">
Create a record for Australia</a>

Create a new record using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="text" size=12 name="Country" value="Australia">
<input type="submit" name="-New" value="New Record">
</form>

Other tags that are required
-DB, field name

Back to Top
-Op What it does
Specifies the comparison operator to apply to the field name/value pair that follows it in a -Find action.

Value is
The operator to use. There are short and long versions of each operator. The default operator is "begins with". The list of valid operators is:

Short Long FileMaker Pro Equivalent Operator
eq equals =word
cn contains "word"
bw begins with word*
ew ends with *word
gt greater than > word
gte greater than or equals >= word
lt less than < word
lte less than or equals <= word
neq not equals omit, word

You can use any FileMaker Pro Find operator by specifying the begins with (bw) parameter. E.g., To specify the "Find Content Match" (==) operator, you would specify the begins with parameter (bw) and then you would place the characters "==" before the actual search criteria. The required lines would look like this:

<input type="hidden" name="-Op" value="bw">
<input type="text" name="First" value="==Keith">

Syntax example(s)
Specify an operator using a link
<a href="-DB=Contacts&-Format=format.html&-Op=eq&First=Bob&-Find">Find Bob but not Bobbie</a>

Specify an operator 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="-Op" value="eq">
<input type="text" name="First" value="Bob">
<input type="submit" name="-Find" value="Find Bob">
</form>

Other tags that are required
-DB, -Format, field name, -Find

See also
-LOP

Back to Top
[FMP-Option] What it does
[FMP-Option] is replaced with all the values in the value list of the field in that layout.

Syntax
[FMP-Option: 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 a pop-up menu with value list using an HTML file
<select name="Groups">
[FMP-option: Groups, list=GroupList]
</select>

<!-- After processing, the HTML sent to the browser could look like:
<select name="Groups">
<option> Production
<option selected> Sales
<option> Support
</select>
-->

Other tags that are required
-Lay (required if you haven't specified a list), <select>, </select>

See also
[FMP-ValueList]

Back to Top
-Script What it does
Specifies the FileMaker Pro script that should be performed after the finding and sorting of records (if any) during processing of the action.

Value is
Name of the script to perform.

Syntax example(s)
Perform a script using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&-Script=Omit+Script&-FindAll">"Run script"</a>

Perform a script using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="hidden" name="-Script" value="Omit Script">
<input type="submit" name="-FindAll" value="Run Script">
</form>

Other tags that are required
-DB, any action tag

See also
-Script.PreFind, -Script.PreSort

Back to Top
-Script.PreFind What it does
Specifies the FileMaker Pro script that should be performed before the finding and sorting of records (if any) during processing of the action.

Value is
Name of the script to perform.

Syntax example(s)
Perform a script using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&-Script.PreFind=My+Script&-FindAll">Run script</a>

Perform a script using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="hidden" name="-Script.PreFind" value="DelSome">
<input type="submit" name="-FindAll" value="Run Script">
</form>

Other tags that are required
-DB, any action tag

See also
-Script, -Script.PreSort

Back to Top
-Script.PreSort What it does
Specifies the FileMaker Pro script that should be performed after the finding and before the sorting of records (if any) during processing of the action.

Value is
Name of the script to perform.

Syntax example(s)
Perform a script using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&-Script.PreSort=OmitOne&-FindAll">Run script</a>

Perform a script using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="hidden" name="-Script.PreSort" value="OmitOne">
<input type="submit" name="-FindAll" value="Run Script">
</form>

Other tags that are required
-DB, any action tag

See also
-Script, -Script.PreFind

Back to Top
Select What it does
An HTML input type. Used by a browser to display a pop-up menu.

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
<select name="Field">
<option value="Data" Selected>Visible Value
</select>

Field - The name of the field that you want the data to go into.
Data - The information that should be placed into the field.
Selected (optional) - Specifies that the menu item is selected. If the word "selected" is not present, the menu item is not selected.
Visible Value - The value that the user sees in the browser.

Syntax example(s)
Display a pop-up menu 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">
<select name="Country">
<option value="F1" selected>France
<option value="G7">Germany
<option value="I4">Iceland
<option value="U2">USA
</select>
<input type="submit" name="-New" value="New Record">
</form>

Back to Top
[FMP-Portal] What it does
Repeats the HTML between [FMP-Portal] and [/FMP-Portal] for each record in a specified portal.

The layout specified by the -Lay tag that was part of the request that created this page must contain fields specified by the relationship in this tag. This tag cannot be used if the -Lay tag was not specified.

Syntax
[FMP-Portal: Relationship name ]

Parameter(s)
First parameter: Name of the relationship to repeat over.

Syntax example(s)
Display a portal using an HTML file
[FMP-Portal: InvoiceID]
[FMP-Field: InvoiceID::Product Name] - [FMP-Field: InvoiceID::Product Count]<br>
[/FMP-Portal]

<!-- After processing it could look like:
Blue Cubes - 4
Red Triangles - 6
Green Spheres - 2
-->

Other tags that are required
[/FMP-Portal]

Back to Top
Radio What it does
An HTML input type. Used by a browser to display a radio buttons.

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="radio" name="Field" value="Data" Checked>Radio Button Label

Field - The name of the field that you want the data to go into.
Data - The information that should be placed into the field.
Checked (optional) - Specifies that the radio button is selected. If the word "checked" is not present, the radio button is not selected.
Radio Button Label - The label that the user sees in the browser.


Syntax example(s)
Display radio buttons 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
[FMP-RangeEnd] What it does
[FMP-RangeEnd] is replaced with the record number of the last record being displayed.

Syntax example(s)
Display the record number of the last record in the range using an HTML file
Records [FMP-RangeStart] through [FMP-RangeEnd] of [FMP-CurrentFoundCount]

<!-- After processing it could look like:
Records 6 through 10 of 34
-->

See also
[FMP-RangeStart]

Back to Top
[FMP-RangeSize] What it does
[FMP-RangeSize] is replaced with the number of records actually displayed on this page.

Usually this is equal to [FMP-CurrentMax] except in the case when you are at the end of the record list and -Max records are not available.

Syntax example(s)
Display the current number of records being viewed using an HTML file
You are viewing [FMP-RangeSize] records.

<!-- After processing it could look like:
You are viewing 8 records.
-->

See also
-Max

Back to Top
[FMP-RangeStart] What it does
[FMP-RangeStart] is replaced with the record number of the first record being displayed.

Syntax example(s)
Display the record number of the first record being displayed using an HTML file
Records [FMP-RangeStart] through [FMP-RangeEnd] of [FMP-CurrentFoundCount]

<!-- After processing it could look like:
Records 6 through 10 of 34
-->

See also
[FMP-RangeEnd]

Back to Top
[FMP-Record] What it does
Repeats the HTML between [FMP-Record] and [/FMP-Record] for every record up to -Max, starting after skipping -Skip records.

Syntax example(s)
Display several records using an HTML file
[FMP-Record]
[FMP-Field: Country] - [FMP-Field: Capital]<br>
[/FMP-Record]

<!-- After processing it could look like:
Great Britain - London
France - Paris
USA - Washington D.C.
-->

Other tags that are required
[/FMP-Record]

See also
-Max, -Skip

Back to Top
-RecID What it does
Defines which record should be operated on. Used mainly by the -Edit, -Dup (duplicate), and -Delete actions.

Value is
A record ID, which is a unique specifier to a record in a FileMaker Pro database. The [FMP-CurrentRecID] replacement tag is used to get the ID of a record.

Syntax example(s)
Delete a record using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&-RecID=4&-Delete">Delete record with ID 4</a>

Delete a record using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="name.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="hidden" name="-RecID" value="[FMP-CurrentRecID]">
<input type="submit" name="-Delete" value="Delete This Record">
</form>

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

See also
[FMP-CurrentRecID]

Back to Top
[FMP-Repeating] What it does
Repeats the HTML between [FMP-Repeating] and [/FMP-Repeating] for all the repetitions of the specified field. The tag [FMP-RepeatingItem] is replaced with the contents of a specific repetition.

Repeating fields within portals are not supported. The number of repetitions displayed in a repeating field is controlled by the layout specified in the -Lay tag.

Syntax
[FMP-Repeating: Field Name ]

Parameter(s)
First parameter: Name of the repeating field.

Syntax example(s)
Display a repeating field using an HTML file
[FMP-Repeating: Extensions]
Alternate phone extensions: [FMP-RepeatingItem]<br>
[/FMP-Repeating]

<!-- After processing it could look like:
Alternate phone extensions: x2353
Alternate phone extensions: x3442
-->

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

See also
[FMP-RepeatingItem]

Back to Top
[FMP-RepeatingItem] What it does
[FMP-RepeatingItem] is replaced with the contents of the next repetition.

Syntax
[FMP-RepeatingItem: 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
Break - Perform HTML encoding and replace soft returns with <br>

Syntax example(s)
Display a repeating field using an HTML file
[FMP-Repeating: Extensions]
Alternate phone extensions: [FMP-RepeatingItem]<br>
[/FMP-Repeating]

<!-- After processing it could look like:
Alternate phone extensions: x2353
Alternate phone extensions: x3442
-->

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

Back to Top
Reset What it does
An HTML input type used to reset all other HTML input types on the page back to their default values.

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

Syntax
<input type="reset" value="Button Text">

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">
<input type="reset" value="Reset">
</form>

Back to Top
Select What it does
An HTML input type. Used by a browser to display a scrolling list.

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
<select size=Rows name="Field">
<option value="Data" Selected>Visible Value
</select>

Rows - Number of rows to display in the scrolling list.
Field - The name of the field that you want the data to go into.
Data - The information that should be placed into the field.
Selected (optional) - Specifies that the scrolling list item is selected. If the word "selected" is not present, the scrolling list item is not selected.
Visible Value - The value that the user sees in the browser.

Syntax example(s)
Display a scrolling list 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">
<select size=4 name="Country">
<option value="F1" selected>France
<option value="G7">Germany
<option value="I4">Iceland
<option value="U2">USA
</select>
<input type="submit" name="-New" value="New Record">
</form>

Back to Top
[FMP-SetCookie] What it does
The [FMP-SetCookie] tag is replaced with nothing in the HTML and is used to store a variable in the user's browser. It is used to store information that will be needed in future visits.

A cookie is saved by the browser. Therefore your user's browser must support this feature, and the user must have the feature enabled.

Consult the Preliminary Specification for Persistent Client State HTTP Cookies from Netscape for more information about Cookies. <http:/search.netscape.com/newsref/std/cookie_spec.html>. You may also check the Cookies and Privacy FAQ from netscape at <http:/search.netscape.com/assist/security/faqs/cookies.html>

Syntax
[FMP-SetCookie: CookieName =CookieValue, Expires=Minutes , Path=Pathname , Domain=DomainName ]

Parameter(s)
First parameter: The name and value for the cookie
CookieName - The name of the cookie. Must be fewer than 1024 characters. Can either be the contents of a field specified by "field: fieldname" or a text constant.
CookieValue - The data value of the cookie. Must be fewer than 1024 characters. Can either be the contents of field specified by "field: fieldname" , the reserved word CurrentRecID, or a text constant.

Other parameters (optional): These may appear in any order.
Expires - The number of minutes in the future that the cookie will expire. If not set, the cookie will expire at the end of the user's session. A value of 0 or a negative number may be used to have cookies expire immediately.
Path - Sets the path attribute for the cookie. 'Pathname' must be fewer than 256 characters. If not specified, the path defaults to the path to FileMaker Pro.
Domain - Sets the domain attribute for the cookie. 'Domain' must be fewer than 256 characters. If not set, the domain defaults to the domain of the server.

The total number of characters between the opening and closing square brackets of the [FMP-SetCookie] tag must be less than 2048.

Syntax example(s)
Set a cookie using an HTML file
You have selected your favorite color to be [FMP-Field: ColorChoice]. A "cookie"
has been set on your local machine so that the next time you visit our site
within the next month we will display the latest products that come in the
color [FMP-Field: ColorChoice].
[FMP-SetCookie: ColorChoice=Field: ColorChoice, Expires=43200]

<!-- After processing it could look like:
You have selected your favorite color to be green. A "cookie"
has been set on your local machine so that the next time you visit our site
within the next month we will display the latest products that come in the
color green.
-->

See also
[FMP-Cookie]

Back to Top
-Skip What it does
Tells FileMaker Pro how many records to skip before displaying the set of records. Used with the -Max tag to display a series of pages with a subset of the current found set on each one.

Value is
A number from 0 through 2147483647, or the word "All". If the value is greater then the number of records in the found set or the value is "All" then the last record is displayed. The default value is 0.

Syntax example(s)
Display some records using a link
<a href="FMPro?-DB=db.fp5&-Format=rslt.htm&-Skip=10&-Max=5&-FindAll">
Display records 11 thru 15 in the database</a>

Display some records using a form action
<form action="FMPro" method="post">
<input type="hidden" name="-DB" value="names.fp5">
<input type="hidden" name="-Format" value="results.htm">
<input type="hidden" name="-Skip" value="9">
<input type="hidden" name="-Max" value="1">
<input type="submit" name="-FindAll" value="Display record 10">
</form>

Other tags that are required
-DB, -Format, -Find or -FindAll

See also
-Max

Back to Top
-SortField What it does
Specifies the field that will be used for sorting.

This tag can been used multiple times to perform multiple field sorts. The order in which the tag appears in the URL or format file will determine the order of the fields.

Value is
Name of a FileMaker Pro field.

Syntax example(s)
Specify sort field using a link
<a href="-DB=Contacts&-Format=format.html&-SortField=First+Name&-FindAll">Sort by First Name</a>

Specify sort field 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="-SortField" value="Last Name">
<input type="hidden" name="-SortField" value="First Name">
<input type="submit" name="-FindAll" value="Sort by First Name">
</form>

Other tags that are required
-DB, -Format, -Find or -FindAll

See also
-SortOrder

Back to Top
[FMP-SortFieldItem] What it does
[FMP-SortFieldItem] is replaced with the field name that was part of the request that created this page.

[FMP-SortFieldItem] should be placed inside the [FMP-CurrentSort] and [/FMP-CurrentSort] tags.

Syntax
[FMP-SortFieldItem: Encoding ]

Parameter(s)
First parameter: 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)
Return information about the current sort using an HTML file
Current sort order is:<br>
[FMP-CurrentSort]
Field: [FMP-SortFieldItem], Order: [FMP-SortOrderItem]<br>
[/FMP-CurrentSort]

<!-- After processing it could look like:
Current sort order is:
Field: First Name, Order: descend
Field: Last Name, Order: descend
-->

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

See also
[FMP-SortOrderItem]

Back to Top
-SortOrder What it does
Indicates the direction of a sort. If used, -SortOrder must directly follow the -SortField it applies to.

Value is
The sort order. The list of valid sort orders is:

Keyword (short) Keyword (long) FileMaker Pro Equivalent Operator
Ascend Ascending Sort a to z, -10 to 10
Descend Descending Sort z to a, 10 to -10
Custom Sort using the value list associated
with the field on the layout
Custom=Value List Name Sort using the value list named

Syntax example(s)
Specify sort field using a link
<a href="-DB=db.fp5&-Format=sort.htm&-SortField=First+Name&-SortOrder=descend&-FindAll"> Sort by First Name, descending</a>

Specify sort field 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="-SortField" value="Colors">
<input type="hidden" name="-SortOrder" value="custom=Color List">
<input type="submit" name="-FindAll" value="Sort by Color">
</form>

Other tags that are required
-DB, -Format, -Lay (if using a custom sort order), -Find, or -FindAll

See also
-SortField

Back to Top
[FMP-SortOrderItem] What it does
[FMP-SortOrderItem] is replaced with the sort order that was part of the request that created this page.

[FMP-SortOrderItem] should be placed between the [FMP-CurrentSort] and [/FMP-CurrentSort] tags.

Syntax
[FMP-SortOrderItem: Encoding ]

Parameter(s)
First parameter: Encoding. Use one of the following reserved words:
Raw - Don't perform any encoding
URL - Perform URL encoding
HTML - (default) Perform HTML encoding
Display - Returns the sort order in the language specified by the Web Companion Configuration

Syntax example(s)
Return information about the current sort using an HTML file
Current sort order is:<br>
[FMP-CurrentSort]
Field: [FMP-SortFieldItem], Order: [FMP-SortOrderItem]<br>
[/FMP-CurrentSort]

<!-- After processing it could look like:
Current sort order is:
Field: First Name, Order: descend
Field: Last Name, Order: descend
-->

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

See also
[FMP-SortFieldItem]

Back to Top
-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