Script Steps Reference

Table Of Contents
Fields script steps
F
ILEMAKER SCRIPT STEPS REFERENCE 74
Set Field
Purpose
Replaces the entire contents of the specified field in the current record with a calculation result.
Format
Set Field [<table::field>; <value or formula>]
Options
Specify target field specifies the field whose contents you want to replace. If no field is
specified and a field is selected in Browse mode or Find mode, that field is used.
<value or formula> is the calculation whose results will be inserted by this script step.
Compatibility
Originated in
FileMaker Pro 6.0 or earlier
Description
The result of the calculation must match the field type. For example, you can't assign a date
calculation to a container field.
The specified field doesn’t have to be on the current layout.
If the result of the calculation doesn’t match the target field type, and the validate option for
the field is set to Always, the field will not be set and an error code is returned (which can
be captured with the Get(LastError) function).
When possible, the Set Field script step makes the record active and leaves it active until
the record is exited or committed. Scripts that use a series of Set Field script steps should
group these steps together if possible, so that subsequent Set Field script steps can act on
the record without having to lock the record, download and upload data, index the field, and
so on, after each individual Set Field script step. These functions and record level validation
are performed after the record has been exited or committed.
If the target field is a repeating field, you can specify a repetition number or generate a
repetition number from a calculated expression.
Where the script step runs Supported
FileMaker Pro Yes
FileMaker Server scheduled script Yes
FileMaker Go Yes
Custom Web Publishing Yes
FileMaker WebDirect Yes
Runtime solution Yes