About the Search/Replace a String wizard

Purpose

You can use the Search/Replace a String wizard to search for and replace a string wherever it appears in rules in the entire PegaRULES database. You can search and replace the string in

• all RuleSets in the system
• the RuleSets included in your RuleSet list.
• a single RuleSet or set of selected RuleSets

The wizard reports any locked RuleSets or rules that are checked out before performing the replacement, and any class names that might be affected. A list of qualifying rules appears for your review before any rules are altered.

Use this powerful tool with care. Rules updated by this wizard are not automatically revalidated and may become invalid as a result of string replacement. As a precaution, export the RuleSets in to a ZIP archive or back up the entire PegaRULES database before using this tool. The ZIP archive can serve as a backup if the results of the wizard are not satisfactory.

Starting the tool

Select Tools > Rule Management > Search/Replace a String to start the tool. For instructions on the steps, see:

• Help: Step1: Enter a string and specify RuleSets
• Help: Step 2: Are classes or RuleSets affected
• Help: Step 3: Check for locked RuleSets
• Help: Step 4: Check for rules checked out
• Help: Step 5: Select rules to be changed
• Help: Step 6: Results

Specifying the string to replace

In changing a string, the utility looks for the specified string anywhere in any value within any rule within the search scope, and gives you the option to select the rules you want to modify. For the selected rules, it will replace the original string with the replacement string.

Strings are replaced only in rules, not in work objects, assignments, attachments, or other objects. If string replacement changes rules in subclasses of Work- or any of its properties, the subsequent processing of those work objects in those classes may encounter problems.

regular expression

Tools, accelerators, and wizards