Reference > Script steps reference > Editing script steps > Perform Find/Replace
 
Perform Find/Replace
Purpose 
Finds/replaces data according to the options in the Perform Find/Replace Options dialog box.
See also 
Format 
Perform Find/Replace [With dialog: On/Off; "<text to be found>"; "<replacement text>"; Find Next/Replace & Find/Replace/Replace All]
Options 
With dialog specifies whether to display the Find/Replace Summary dialog box at the end of the find/replace operation. Setting With dialog to Off also prevents display of the confirmation dialog box when a Replace All operation is executed.
If you want the user to be able to enter find or replace criteria, use the Open Find/Replace script step.
Perform lets you choose which action you want the find/replace to perform:
Find Next finds an instance of the find term.
Replace & Find finds an instance of the find term, then replaces the term and searches for the next instance when the script is run again.
Replace replaces highlighted text that matches the find term with the replace term. When using the Replace action, you may need to pair the Perform Find/Replace script step with the Select All script step.
Replace All finds and replaces all instances of the find term.
Find what specifies the find term.
Replace with specifies text to replace instances of the find term.
Direction specifies the direction you want the find/replace to search through records.
Match case considers the find term’s case when performing the find.
Match whole words only omits finds where the find term is embedded in another word.
All records/requests finds within all records/requests in the found set.
Current records/requests restricts the find to the current record/request.
All fields finds within every field on the layout.
Current field restricts the find to within the active field. You can use the Go to Field script step to select the field before the Find/Replace is performed.
Compatibility 
 
Where the script step runs 
Supported 
FileMaker Pro 
Yes 
FileMaker Server 
No 
FileMaker Go 
No 
Custom Web Publishing 
No 
FileMaker WebDirect 
No 
Runtime solution 
Yes 
Originated in 
FileMaker Pro 6.0 or earlier
Description 
If Perform Find/Replace doesn't find data that matches the find term, it doesn’t return an error.
Example 1 
Replaces text in the Reorder Level field that matches the find criteria in all records without prompting the user.
Go to Field [Products::Reorder Level]
Perform Find/Replace [With dialog: Off; 1; 3; Replace All]
Example 2 
Goes to the next occurrence of the product name in the Description field.
Show Custom Dialog ["Do you want to find the current product name in the Description field?"]
If [Get ( LastMessageChoice ) = 1]
Go to Field [Products::Description]
Perform Find/Replace [With dialog: Off; Products::Name; Find Next]
End If
Example 3 
Replaces specific terms in the current field with record data.
Show Custom Dialog ["Do you want to replace placeholder terms with record data?"]
If [Get ( LastMessageChoice ) = 1]
Perform Find/Replace [With dialog: Off; "[NAME]"; Customers::Name; Replace All]
Perform Find/Replace [With dialog: Off; "[COMPANY]"; Customers::Company; Replace All]
Perform Find/Replace [With dialog: Off; "[ADDRESS]"; Customers::Address; Replace All]
End If
Related topics 
Substitute function
Script steps reference (alphabetical list)
Script steps reference (category list)