User manual

10-6 FileMaker Pro User’s Guide
About ScriptMaker steps
A step is a FileMaker Pro command that you use in a script. Steps are
similar to the commands you access through FileMaker Pro menus.
For example, you can create a record by choosing New Record from
the Records menu, or you can perform a script that contains the New
Record/Request step.
Keep these points in mind:
1 Many steps have options that you specify when you define a script.
For example, you can specify a field name in the Go to Field step.
FileMaker Pro Help contains detailed information about steps and
options.
1 Some steps, like Paste and Insert Text, can only be performed in
certain modes or when a specified field is on the current layout.
1 Some steps can display a dialog box when you perform a script.
For example, a script with the Sort step can display the Sort dialog
box so you can enter a sort order.
1 To specify a related field in a step, choose a relationship from the
relationship list at the top of the Specify Field dialog box. Then select
a related field.
1 You can use status functions in steps to monitor the state of your
database. For example, a script can check whether a file is sorted. Or
it can display a customized message that tells users what to do when
a found set is empty.
For a list of status functions and some examples of their usage, see
chapter 11 and FileMaker Pro Help.
1 For information about using script steps with OLE objects, see
FileMaker Pro Help. Choose Help menu > Contents and Index, click
the Index tab, and type OLE objects,scripting.
Control script steps
Navigation script steps
Use this step To
Perform Script Perform another script
Pause/Resume Script Pause a script, or resume a paused script
Exit Script Exit the current script
Halt Script Stop performing all scripts
If Perform steps if a calculation is True (not zero)
Else Perform another set of steps if a calculation is False
(zero)
End If Mark the end of an If statement
Loop Repeatedly perform a set of steps
Exit Loop If Exit a loop if a calculation is True (not zero)
End Loop Mark the end of a loop
Allow User Abort Allow or prevent users from stopping a script
Set Error Capture Allow or prevent error messages from displaying.
Use this step to change the way FileMaker Pro
handles error messages.
Use this step To
Go to Layout View the specified layout
Go to Record/Request/Page Move to a record in the found set in Browse
mode, a find request in Find mode, or a page in
Preview mode
Go to Related Record Move to the current related record in a related file
Go to Portal Row Move to a portal row
Go to Field Move to a field on the current layout
Go to Next Field Move to the next field on the current layout