| 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="Keith@Company.COM">
<input type="text" name="-MailCC" value="Dirk@Company.COM">
<input type="text" name="-MailBCC" value="Terry@Company.COM">
<input type="text" name="-MailFrom" value="Chris@Company.COM">
<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="Keith@Company.COM">
<input type="text" name="-MailCC" value="Dirk@Company.COM">
<input type="text" name="-MailBCC" value="Terry@Company.COM">
<input type="text" name="-MailFrom" value="Chris@Company.COM">
<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 |
