B.2 Removing a Legend Rule

You remove a legend rule by defining it in XML, and thereafter, pass the rule to the XmlCheckIn utility. The first step in the legend rule removal process is to mark the rule for removal. When a rule is marked as removed it will not be included in future legend processing unless it is re-added. Removing a legend rule can have one of the two consequences, depending on the status of the rule.

  • Processed legend. The rule for a legend that has already been mapped, is marked as deleted in the Data Warehouse database. In this scenario, the rule cannot be physically removed because it has been used, but because it is marked for deletion, it will never be used again.

  • Unprocessed legend. The rule for a legend that has never been mapped, is physically removed from the list of rules stored in the Data Warehouse database.

To remove a legend rule:

  1. Create an XML file that identifies the rule that you want to remove. For more information, see Section B.3, Creating the Removal XML File

  2. Run the xmlcheckin command. For more information, see Section B.4, Issuing xmlcheckin