Script Steps Reference
Table Of Contents
- Contents
- About script steps
- Script steps reference (alphabetical list)
- Control script steps
- Navigation script steps
- Editing script steps
- Fields script steps
- Set Field
- Set Field By Name
- Set Next Serial Value
- Insert Text
- Insert Calculated Result
- Insert From Index
- Insert From Last Visited
- Insert Current Date
- Insert Current Time
- Insert Current User Name
- Insert Picture
- Insert QuickTime
- Insert Object (Windows)
- Insert File
- Update Link (Windows)
- Replace Field Contents
- Relookup Field Contents
- Export Field Contents
- Records script steps
- Found Sets script steps
- Windows script steps
- Files script steps
- Accounts script steps
- Spelling script steps
- Open Menu Item script steps
- Miscellaneous script steps
Fields script steps
F
ILEMAKER SCRIPT STEPS REFERENCE 44
Examples
The following example calculates 7 percent of the Salary field and assigns the result to the field SDI.
Note that Set Field works whether or not the field is on the active layout.
Set Field [Table1::SDI; Salary * .07]
Set Field By Name
Purpose
Replaces the entire contents of a calculated target field in the current record with the result of the
calculated value.
Format
Set Field By Name[<calculated target field>; <calculated value>]
Options
• Select Specify target field or click Specify to create a calculation to specify the field whose
contents you want to replace. In the Specify Calculation dialog box, use the field list (on the
left) and the functions list (on the right) with the mathematical and text operators to build the
calculation.
• For Calculated result, click Specify to define the calculated value.
Compatibility
This script step is also supported in web publishing and in a FileMaker Server scheduled script.
Description
The Set Field By Name script step lets you create a calculation to specify a field name, then change
the value of the field either literally or based on a second calculation.
The calculated target field must return a text result.
If quotation marks are not included around the fully qualified field name, the target field name is
obtained from the named field.
If no field is specified and a field is selected in Browse mode or Find mode, that field is used.
Notes
• The specified field doesn’t have to be on the current layout.
• Set Field By Name ignores validation checking.
• When possible, the Set Field By Name 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 By
Name script steps should group these steps together if possible, so that subsequent Set
Field By Name 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 By
Name script step. These functions and record-level validation are performed after the
record has been exited or committed.