Skip to main content


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

About the Delete a Class wizard

Updated on November 18, 2021

You can use the Delete a Class wizard to remove a class, all of its pattern- inheritance dependent classes and associated objects such as properties, activities, instances (including work items, attachments and assignments).

You can only delete classes that meet the following restrictions:

  • The class is not in the basic Pega- rulesets that define the Pega Platform.
  • The class is in a ruleset listed in your ruleset list.
  • The class is not mapped to an external database table.

Starting the wizard

Select ConfigureSystemRefactorClassesDelete a Class to start the wizard.

You can return to a previous step using the <<Back button. No rules are altered by the wizard until you click Next>> in step 2. For instructions on the forms, see:

Resuming the wizard

This tool creates a work item with prefix pxW-. To find open wizard work items, select the menu option Dev Studio > Application > Tools > All Wizards .

Note:

Checked out rules associated with the class will be deleted. Unlike other rule management wizards, the Delete a Class wizard does not identify and warn of checked out rules among those to be deleted.

Deleting a class might render an application inoperative. Always back up the Pega Platform system before deleting a class.

This wizard can't delete a rule that belongs to a locked ruleset version. Locked rules will be left in place during the deletion and listed on the summary of undeleted rules on page 3 of the wizard, Search for References.

The wizard cannot delete a class if it contains one or more rules that have failed deletion (perhaps because they belong to a locked ruleset version.) However, all rules that can be deleted will be when you run the wizard. To complete deleting the class, you must unlock or otherwise make it possible for the undeleted rules to be deleted and then run the wizard again.

Errors are written to a log. To examine the log, use the Application Explorer to view instances of the Log-Delete-Class.

Classes related to deleted classes by directed inheritance are not deleted. If the specified class is a subclass of Work-, all instances are deleted prior to the deletion of the class.

Using the Delete a Class wizard - Step 1: Select Class to Delete

Using the Delete a Class wizard —

Step 1: Select Class to Delete

Use the Class drop-down menu to select the class you want to delete.

The drop-down includes classes that are contained the rulesets listed on your ruleset list. On a large system it may take a while for this list to populate after you click in the field. Expand the drop-down box and make your selection.

After you have made your selection, click the Next >> button.

Click <<Back to return to the previous step. Click Cancel and then click Done to cancel the wizard.

About the Delete a Class wizard

Using the Delete a Class wizard - Step 2: Display Classes to Delete

Using the Delete a Class wizard —

Step 2: Display Classes to Delete

This page displays the class and subclasses that will be deleted. The classes and associated objects such as properties, activities, attachments and assignments will also be deleted.

Confirm whether you want to delete all the classes listed and then choose one of the following actions:

  • Click Next >> to complete the deletion.
  • Click << Back to select another class to delete.
  • Click Cancel to exit from the wizard without deleting any classes.

About the Delete a Class wizard

Using the Delete a Class wizard - Step 3: Display Results

Using the Delete a Class wizard

Step 3: Display results and search for references

This form presents a list of rules that could not be deleted. The Message column explains why the rule was not deleted and the actions required to delete it.

If there are undeleted rules, the class cannot be deleted. However, all other rules associated with the class have been deleted. To complete deleting the class, modify the rules listed so that they can be deleted and then run the wizard on the class again.

Select Reference Search

In the Reference Search drop-down, choose one of the following options to set the scope over which the wizard is to search for references to the deleted classes:

  • Don't search for references
  • Search for references in your RuleSet list.
  • Search for references in all RuleSets.

In the next step the system searches for references to deleted objects that may need to be fixed after the deletion is complete. If this search is made over the entire rulebase on a large system, it can take some time to complete.

When you have reviewed the list of rules and set Reference Search, click Next >> to complete the deletion and see a list of unresolved references.

About the Delete a Class wizard

Using the Delete a Class wizard - Step 4: Display References

Using the Delete a Class wizard —

Step 4: Display References

This form provides a list of rules and data which might still reference the deleted class. The Value column lists the instance that contains the reference, and the other columns provide the information you need to locate it.

Review this list and correct any invalid references that might interfere with your system.

To review these rules outside the wizard, click Export To Excel to create a spreadsheet of the currently displayed page, or Export All To Excel to create a spreadsheet of the entire report.

Click Finish to exit the wizard.

About the Delete a Class wizard

Using the Delete a Class wizard - Step 5: Display References

Using the Delete a Class wizard —

Step 5: End

This form appears when all steps are complete.

Click Finish to exit the wizard.

About the Delete a Class wizard

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.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us