How to delete a class (V5.5)
Summary
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 objects, attachments and assignments).
You can only delete classes that meet the following restrictions:
- The class is not in the basic Pega- RuleSets that define Process Commander.
- The class is in a RuleSet listed in your RuleSet list.
Classes related to deleted classes by directed inheritance are not deleted. If the specified class is a subclass of Work-, all instances are deleted before the class itself is deleted.
Rules associated with the class that are checked out by current operator running the wizard will be deleted. Rules checked out by others will not be deleted and will be listed on the summary of undeleted rules on page 3 of the wizard, Search for References. Unlike other rule management wizards, the Delete a Class wizard does not identify and warn of checked out rules among those to be deleted before performing the operation.
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 can't 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.
Suggested Approach
Before You Begin
Deleting a class might render an application inoperative. Always back up the Process Commander system before deleting a class.
To ensure complete results, be sure that rules associated with this class are checked-in and unlocked.
Using the Wizard
- Select Tools > Rule Management > Delete a Classto start the tool.
- In the Class drop-down, select the class you want to delete.
The drop-down lists classes that are contained in the RuleSets in 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.
Click Next to continue.
- Confirm the classes to be deleted.
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.
Click Next to delete these classes, Back to select another class to delete, or Cancel to exit from the wizard without deleting any classes.
If you choose Nextthe wizard performs the delete and presents a listing of rules that could not be deleted and an option to search for references to the deleted class that are still in the system.
- Choose whether to search for existing references to this class. Review rules that could not be deleted.
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 reference
- 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.
Review Undeleted Rules:
This page also lists rules that could not be deleted. The Message column explains why the rule was not deleted.
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 to correct the problem listed in the Message for that rule and then run the wizard on the class again.
Click Next to continue.
- Review and correct references to the deleted class still in your system.
This page lists rules and data which might still reference the deleted class. Review this list and correct any invalid references that might interfere with your system.
The rules are identified by their Rule Type and Name. The specific item that will be changed is identified in the Path and Value columns. The Path column specifies the property that contains the value, and the Value column contains the string that will be changed. The final columns specify the RuleSet and RuleSet Version of each rule.
If there is more than one page of records, you will see page navigation tools at the top of the page.
To review these rules outside the wizard, click Export To Excel or Export To PDF to create a listing of the rules on the currently displayed page. To create a listing of the entire report, containing the rules listed on all the pages, scroll to the bottom of the page and click Export All To Excel.
Click Finish to exit the wizard.