Script Steps Reference

72 FileMaker Script Steps Reference
• Click Insert Symbol to further refine your search criteria. See FileMaker Pro Help
for a complete description of how to use the symbols in this list.
• Click Add to add your criteria to the find request.
• To change existing criteria, select the line containing the field and criteria from the top
of the dialog box, and make your changes to field and/or criteria. Click Change to
store your changes.
• To delete existing criteria, select the line containing the field and criteria from the top
of the dialog box and click Remove.
Web compatibility
This script step is web-compatible.
Description
The Perform Find script step enters Find mode and finds records that match one or more
find requests that you set up, that are stored with the script step. If you do not create a
find request, Perform Find will perform the last find request that was executed.
You can use a Perform Find script following an Enter Find Mode script step on page 37,
to pause the script and allow the user to enter find criteria before performing a find.
Examples
If FileMaker Pro doesn't find any records that match the find criteria when you perform the
script, you can stop the script, continue the script with zero records in the current found
set, or change the find criteria. By using the Set Error Capture script step on page 27 and
the Get(LastError) function, you can set up a script to handle such situations. For
example:
The following script tries to perform a find. If no records are found, a custom dialog will
appear giving the user the option to modify the find request or go back to Browse mode.
Set Error Capture [On]
Perform Find [Restore]
If [Get (LastError) > 0]
Show Custom Dialog ["No records were found. Click OK to modify
your request or click Cancel to return to Browse mode."]
If [Get (LastMessageChoice) = 1]
Modify Last Find
Else
Enter Browse Mode []
End If
End If