This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Creating deprecation mappings

A class mapping is used to delete a class or migrate a class and its data to another. An attribute mapping is used to delete an attribute or migrate data from one attribute to another attribute within the same class. To deprecate a class and replace it with another, you must define class and attribute mappings. These mappings are required to migrate data to the replacement class.

The Deprecation utility enforces the following rules when deprecating classes and attributes. Make sure you observe the following rules when creating deprecation mappings:

  • You can map a class to only one class.
  • You can only map a relationship class to another relationship class. Cardinality rules are enforced for relationship classes.
  • You cannot map federation classes and relationships. They can only be marked for deprecation.
  • You can map an attribute to only one attribute. The field types must be identical on each side of the mapping, and the field length of the replacement attribute must not be less than the attribute to deprecate.
  • You cannot map an attribute or class to deprecate to an attribute or class that is deprecated.
  • You must create attribute and class mappings based on the relationship cardinality rules and endpoint class rules defined in BMC Atrium CMDB.

To create deprecation mappings

  1. Open Class Manager.
  2. In the toolbar, click Deprecation Mapping.
  3. In the Class and Attribute Deprecation window, click the Deprecate Classes tab.
  4. Click Create.
    The Deprecate Class Editor opens.

    Tip

    To edit an existing class mapping, click the appropriate class mapping row and click Edit.



    Deprecate Class Editor
  5. From the Deprecate Action section, specify whether you want to delete or deprecate the class.
    • Delete ---Deprecates the class without a mapping. The class property is set to Deprecated, indicating that the class and its data are to be deleted in a future version of the data model.
    • Replace — Deprecates the class and uses a mapping to replace it with a different class. Data is moved to the class that you specify in the Replacement Class selection list, and the class is to be deleted in a future version of the data model. When you click Replace, the Replacement Class field is enabled.
  6. From the Class to Deprecate menu, select the class to deprecate from the selection list.
  7. In the Application field, type or select the application that wants to deprecate the class or attribute.
    The application is usually the owner of the class or attribute that wants to deprecate the class or attribute (for example, BMC Atrium CMDB or BMC Remedy Asset Management).
  8. In the Version field, type or select the version number of the application in which to deprecate or replace the class (for example, 8.0.00 ).
  9. From the Replacement Class menu, select an appropriate replacement class to which you want to migrate the data from the deprecated class.
    The Attribute Mapping section is enabled.
  10. In the Attribute Mapping section, click Map Attributes.
    Complete the following steps for deprecating a class and its attributes:
    1. From the Attribute to Deprecate list, select the attribute that you want to deprecate.
    2. From the Replacement Attribute list, select the attribute on the target class that you want to replace it with.
    3. Click Add Attribute Mapping.
      The attribute is then mapped to deprecate.

      Mapping attributes to deprecate

      Note

      Make sure that the datatype of the replacement attribute matches with the datatype of the attribute to deprecate. For example, map a Character field only to a Character field. Otherwise, an error might occur when migrating data to the replacement class.

  11. Click Specify Default Value.
    Complete the following steps when transferring data from the deprecated class to the replacement class:
    1. From the Replacement Attribute list, select the attribute for which you want to specify a default value.
    2. In the Default Value field, select the default value from the list or type a value of your choice.
      This field is used to specify constant values that are used when migrating data. The value specified in this field overrides the values in the attribute to deprecate and the replacement attribute.
    3. Click Add Attribute Mapping.
  12. Click Qualify Queries.
    When you deprecate an attribute, you use Qualify Queries to specify the data to migrate to the replacement attribute. For example, you want to deprecate an attribute that has location data about your worldwide offices but your company is closing the Pojoaque office. When you depreciate the attribute in the attribute mapping, you can create a Location != Pojoaque qualification expression that migrates all location data except for Pojoaque to an attribute in the replacement class.
    Complete the following steps when modifying attribute values to determine whether the data belongs to the replaced class or the deprecated class:
    1. From the Attribute list, select an attribute on the replacement class.

      Note

      Make sure that you select an attribute for which data exists in the class to deprecate. Otherwise, data migration errors might occur.

    2. Select an operator.
    3. Select a keyword or type a value. If you type a value, enclose it in double quotation marks.

      Query qualifier for class mappings
  13. Click OK.
    You are prompted that you successfully created a class mapping.
  14. Click OK.
    The new mapping appears in the Class and Attribute Deprecation window.
Was this page helpful? Yes No Submitting... Thank you

Comments