Use the Rename a Class wizard to rename a class and all of its pattern inheritance dependent classes. In addition you can choose to rename associated objects such as work- instances, properties, activities, and flows.
The wizard reports any locked rulesets or rules that are checked out before renaming anything.
In addition to exact matches to the specified class name to be changed, the wizard identifies references to the current class name in embedded strings, for example in property names or in embedded Java modules. The wizard displays a listing of these "inexact" matches, and you can select which to include to be renamed and which to preserve unchanged.
In particular, use Rename a Class for applications with fewer than a thousand work objects, or select No on the Work Objects page to drop references in the work objects to the new class name. After the class is renamed, work items that referenced the original class can be viewed only as XML.
Starting the wizard
To improve performance, purge all existing work objects from the class before running the Rename a Class wizard.
Selectto start the wizard. You can return to a previous step using the <<Back button.
Alternatively, select a case type or work pool in the Application Explorer, right-click, and select Refactor > Rename a Class from the context menu.
No rules are altered by the wizard until you click Next after reviewing additional rules to be changed on the next-to-last page. For instructions on the forms, see:
Resuming the wizard
This wizard creates a work item with prefix
pxW-. To find open wizard
work items, select the menu option
Dev Studio > Application > Tools > All Wizards
You can rename a class if it meets these conditions:
- The class must be visible in your Access Group.
- The class may not be one of the standard classes, those in the Pega- rulesets.
- The original class cannot have Final availability.
- All rules to be modified must be checked in. (If rules are checked out, check them in and restart the wizard.)
- All rules to be modified must belong to unlocked ruleset versions. You must supply the appropriate password to unlock the locked rules, or you can opt to skip them for this operation.
- The new name of the class must not already exist in the system. Class names need to be unique system-wide, rather than unique within a specific ruleset.
- You cannot change an abstract class to a concrete class or vice versa. For example, class A- cannot be renamed to B, and B cannot be renamed to A-.
When complete, the renaming wizard changes your system in the following ways:
- The class is renamed.
- Direct and pattern inheritance references the new class name. As a result, there will be no effect on rule resolution.
- If the option has been selected, Work- instances associated with the class are renamed.
- All properties, activities, flows, and other rules that referenced the original class now reference the class by the new name.
- If the class is a work pool or defines an external data table, the Data-Admin-DB-Table instance is updated to reflect the new class name.
- The wizard creates a new History- class for the new class, and it will identify that the class has been renamed. The History- class for the old class name is deleted.
The old class name is retained until all changes to dependent classes and Work- instances are completed. Then the original class is deleted. If the system is stopped while renaming is in progress, you can restart the process by executing the utility from the beginning.
- Selecting a Class to Rename and RuleSets
Use the Rename a Class wizard to select class to rename and rulesets.
- Verifying classes
Verify the classes to rename with the Rename a Class wizard.
- Identifying locked ruleset versions
To avoid errors with the Rename a Class wizard, identify rules in locked ruleset versions.
- Checking for checked-out rules
To avoid errors, review the list of checked-out rules before you continue to use the Renaming Class wizard.
- Reviewing the list of rules to change
This form reports the number of occurrences of the class or ruleset names that to change.
- Selecting additional rules to change
Use the Rename Class wizard additional rules report to list matches with the class name you asked to change that are found in strings that are not clearly class names. These are additional occurrences not included in the summary on the page, "Rules That Will Be Changed." The wizard cannot determine whether these strings should be changed when the class names are changed.
- Reviewing the results
Review the list of rule instances that you selected to be renamed that could not be changed successfully. Hover over the error message in the Status column to see more details on the error.
- Using the Rename a Class wizard