Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

About the Rename a Class wizard

Updated on April 5, 2022

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.

Note: The Rename a Class wizard is designed to assist with refactoring applications that are in development. It is not intended to be used on a deployed production application.

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.

Select ConfigureSystemRefactorClassesRename a Class to 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:

  1. The class must be visible in your Access Group.
  2. The class may not be one of the standard classes, those in the Pega- rulesets.
  3. The original class cannot have Final availability.
  4. All rules to be modified must be checked in. (If rules are checked out, check them in and restart the wizard.)
  5. 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.
  6. 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.
  7. 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:

  1. The class is renamed.
  2. Direct and pattern inheritance references the new class name. As a result, there will be no effect on rule resolution.
  3. If the option has been selected, Work- instances associated with the class are renamed.
  4. All properties, activities, flows, and other rules that referenced the original class now reference the class by the new name.
  5. 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.
  6. 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

    Work Objects

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us