Script Steps Reference
Table Of Contents
- Contents
- About script steps
- Script steps reference (alphabetical list)
- Control script steps
- Perform Script
- Pause/Resume Script
- Exit Script
- Halt Script
- If
- Else If
- Else
- End If
- Loop
- Exit Loop If
- End Loop
- Allow User Abort
- Set Error Capture
- Set Variable
- Install OnTimer Script
- Navigation script steps
- Go to Layout
- Go to Record/Request/Page
- Go to Related Record
- Go to Portal Row
- Go to Object
- Go to Field
- Go to Next Field
- Go to Previous Field
- Enter Browse Mode
- Enter Find Mode
- Enter Preview Mode
- 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
- New Record/Request
- Duplicate Record/Request
- Delete Record/Request
- Delete Portal Row
- Delete All Records
- Open Record/Request
- Revert Record/Request
- Commit Records/Requests
- Copy Record/Request
- Copy All Records/Requests
- Import Records
- Export Records
- Save Records As Excel
- Save Records As PDF
- Save Records As Snapshot Link
- Found Sets script steps
- Windows script steps
- Files script steps
- Accounts script steps
- Spelling script steps
- Open Menu Item script steps
- Miscellaneous script steps
FILEMAKER SCRIPT STEPS REFERENCE 47
Fields script steps
Fields script steps operate on specific fields. With these script steps, you can:
• paste data into fields
• import information into fields and export data from fields
• evaluate a calculation and assign the result to a field
Set Field
Purpose
Replaces the entire contents of the specified field in the current record with the result of a
calculation.
Format
Set Field [<table::field>; <value or formula>]
Options
• Select Specify target field or click Specify to specify 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.
• For Calculated result, click Specify to define the calculation. In the Specify Calculation
dialog box, type the calculation you want evaluated, or use the field list (on the left) and the
functions list (on the right) with the mathematical and text operators to build the calculation.
Compatibility
This script step is also supported in web publishing and in a FileMaker Server scheduled script.
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.