Replace Results

You can replace single results or multiple results with the replacement text string you specified. You can also test a single result before replacing it. Depending on the type of document that contains the search result, the following occurs when a replacement is made:

• Database: The result is replaced with the replacement text and the database record updated. The form containing the search result is not opened; to see the location of the search result before or after the replacement is made, use the Go To command.
• Cicode/VBA: The Cicode file containing the matched text loads (if it is not loaded already), the replacement is made, and the file saved.
• Graphic: The page opens in the Graphics Builder (if it is not already) and the replacement made. If the page is open and contains unsaved changes, you're instructed to save or discard the changes before making the replacement. If there are multiple changes to be made to the same graphics page, the page remains open until every change has been made.
• Report: The found text is replaced with the replacement text and the file is saved.

Note: Replacements cannot be undone once performed. Take care to check your replacements before making them, especially when working with multiple replacements.

Test a Result

To test a result:

1. With the result you want to test highlighted, click Test. A dialog box appears showing the result of the text replace.
2. Click Accept to accept the text replacement, or click Cancel.

Replace a Single Result

To replace a single result:

• With the result you want to replace highlighted, click Replace. The replacement is made and the result removed from the Results window. The next result in the list is then selected.

Replace Multiple Results

To replace multiple results:

1. With the search results you want to replace listed in the Results window, click Replace All. A confirmation dialog appears.
2. The replacements are made and removed from the Results window. (Replacements that are not made remain in the results list. This will occur if, for example, you try to replace a property that is read-only.)

Note: Clicking Stop during this process does not undo any replacements already made.

When attempting to make a replacement, you might encounter an alert message. For details, see Find and Replace alert messages.

Published June 2018