Managing CI classes
To be able to add, update, and delete Configuration Item (CI) classes, CI management must be enabled. For more information, see Enabling-CI-management. Depending on the CI data that you want to store, you can use the available out-of-the-box CI classes, customize the attributes of the out-of-the-box CI classes, and add custom CI classes. For more information about the available out-of-the-box classes, see BMC-Remedyforce-CMDB-Common-Data-Model.
This topic contains the following information:
- Adding custom CI classes
- Updating CI classes
- Deleting CI classes
- Managing related Rule Based Asset classes
Adding custom CI classes
To add a custom CI class, you must perform the following actions:
To add the class details
- On the CMDB Classes list view page, click
.
- On the CMDB Class form, select the superclass from the Superclass lookup.
By default, BMC_BaseElement is displayed as the superclass. When you select a superclass, the hierarchy of the selected superclass, starting from the BMC_BaseElement class, is displayed. In the CMDB Class Type list, select one of the following options:
- To create a CI class, select CI.
- To create a class which is both CI and asset, select CI and Asset.
- In the Class Name field, enter a unique class name.
The system validates that the class name is unique. The class name can contain only uppercase and lowercase letters from A through Z, numbers 0 through 9, and the underscore (_) character. It must begin with a letter, not end with an underscore, and not contain two consecutive underscores. - (Optional) In the Display Label field, enter a unique display label of the class.
By default, the entered class name is displayed as the display label, which you can update. For more information, see To update an out-of-the-box or custom CI class. To display the class in the Remedyforce CMDB tab, ensure that the Display in CMDB check box is selected.
(Optional) To create an abstract class, select the Abstract check box.
(Optional) To display the default class and class impacted icons in the Remedyforce CMDB tab, Relationships tab of the Instance Editor, and in the CMDB Explorer, ensure that the Use Default radio button is selected.
By default, the Use Default radio button is selected. If you want to replace the default class and the class impacted icons with custom images, perform the following steps:- Click the Select Custom radio button.
- Next to Class Icon, click Browse.
- From the Add Image window, select the class icon image file.
- Next to Class Impacted Icon, click Browse.
- From the Add Image window, select the class impacted icon image file.
- Click
.
Adding the class attributes
When you save the class details, the Manage Attributes section of the UI is displayed on the CMDB Class form, which enables you to do the following:
- View the Field Set Label and Field Set Name fields that you must enter for the class.
Access the links to the Base Element object to add the field set and attributes of the class.
Click on Field Set to create the field set of the class; click Custom Fields to create the unique attributes of the class.
To add a field set for a custom class
- In the Manage Attributes section, click on the Field Set link.
- In the Field Sets section of the Base Element object page, click New.
- In the Field Set Label text box, enter the field set label that is displayed on the Manage Attributes section.
- In the Field Set Name text box, the field set name is automatically populated.
Ensure that the field set name is the same as the one displayed in the Manage Attributes section. - In the Where is this used? text box, enter a brief description of where and how the field set is used.
- Click Save.
To add fields for the custom class attributes
- In the Manage Attributes section, click on the Custom Fields link.
- In the Custom Fields & Relationships section of the Base Element object that opens on a new tab, click New.
- From the New Custom Field page, add custom fields for the class attributes.
For more information, see Adding-or-removing-fields-on-the-Instance-Editor-in-CMDB-2-0.
To add the fields to the field set for a custom class
- In the Manage Attributes section, click on the Field Set link.
- In the Field Set section of the Base Element object page that opens on a new tab, navigate to the corresponding field label.
- Click Edit.
- From the object palette, drag the fields to the In the Field Set list.
- Click Save.
Updating CI classes
You can update the out-of-the-box and custom CI classes as follows:
To update the class details
- On the CMDB Classes list view page, in the Class column, click the class that you want to update.
On the CMDB Class form, from the CMDB Class Type list, select the required class type.
From the Superclass lookup, and select the superclass.
The hierarchy of the selected superclass, starting from the BMC_BaseElement class, is displayed.- The Class Name field cannot be updated.
In the Display Label field, enter a unique display label.
The updated label is displayed in the Class column of the CMDB Classes list view page and on the Tile, List, and Tree views of the Remedyforce CMDB tab.- Select the Display in CMDB check box to display the class in the Remedyforce CMDB tab.
If you clear the Display in CMDB check box, the class is not displayed in the Remedyforce CMDB tab. For more information, see To add the custom CI class details. Select the Abstract check box to assign the class as an abstract class.
To remove the assignment of a class as an abstract class, clear the Abstract check box.- (Optional) To replace both the default class and class impacted icons with custom images, click the Select Custom radio button.
For more information, see To add the custom CI class details. - Click
.
To update the class attributes
You can update the attributes of a CI or a CI and Asset class from the Manage Attributes section of the CMDB Class form.
To update custom fields for the class attributes, click the Custom Fields link.
For more information, see Adding the class attributes.
- To update the field set of the class, perform the following actions:
- Click the Field Set link.
- In the Field Set section of the Base Element object page, click Edit for the corresponding field label, and then perform one or both of the following actions:
- To add new fields, drag the fields from the object palette to the In the Field Set list.
- To delete existing fields from the In the Field Set list, click
next to the fields.
- Click Save.
- Click
.
Deleting CI classes
You can delete only custom classes, and cannot delete any out-of-the-box classes. For the out-of-the-box classes, the button is disabled. However, if a custom class contains CMDB instances (such as CIs, CIs and assets, and assets), subclasses, or Rule Based Asset classes defined on it, you cannot delete that class. To be able to delete that class, you must first delete the related CMDB instances, subclasses, or Rule Based Asset classes.
To delete a custom class
- On the CMDB Classes list view page, select the custom CI class that you want to delete.
- Click
.
You can also delete a class by clicking on the CMDB Class form of that class.
Managing related Rule Based Asset classes
If the system administrator has enabled both CI and IT asset management, the CMDB Class form of a CI class displays the Rule Based Asset Classes section. It enables you to manage Rule Based Asset classes which are based on that CI class. The Rule Based Asset Classes section displays any existing Rule Based Asset classes defined on the CI class, along with the rules applied. From the Rule Based Asset Classes section, you can add, update, and delete Rule Based Asset classes.
To add or update a Rule Based Asset class based on the CI class
- In the Rule Based Asset Classes section, perform one of the following actions:
- To add a new Rule Based Asset class, click
.
- To update an existing Rule Based Asset class, select that class and click
.
- To add a new Rule Based Asset class, click
- The CMDB Class Type field displays Rule Based Asset and is not editable.
- If you are creating a new Rule Based Asset class, select the CI class based on which you want the new class from the Superclass lookup.
For existing Rule Based Asset classes, the Superclass field is not editable. - If you are creating a new Rule Based Asset class, enter a unique class name in the Class Name field.
The system validates that the class name is unique. The class name can contain only uppercase and lowercase letters from A through Z, numbers 0 through 9, and the underscore (_) character. It must begin with a letter, not end with an underscore, and not contain two consecutive underscores.
For existing Rule Based Asset classes, the Class Name field is not editable. - (Optional) In the Display Label field, enter a unique display label of the class.
By default, the entered class name is displayed as the display label, which you can update. - In the Criteria section, the Rule Based upon CI Class field displays the CI class name based on which the Rule Based Asset class is defined and is not editable.
To define the rules of the class, perform the following actions:
- From the <Field> list, select the required operand value.
The operand values that you can select from the <Field> list is based on the available out-of-the-box fields of the selected CI class. - In the <Operator> list, the only available operator is " = ", which is automatically populated.
- Enter an operand field value in the corresponding text box.
The options to enter the operand field value depends on the operand value that you have select from the <Field> list. For example, if you select CI Status from the <Field> list, you are presented with a list to select the operand field value. However, if you select Asset# from the <Field> list, you are presented with a text box to enter the asset number. - To add multiple rules, click on and add the rules.
Multiple rules are combined by using the logical operator "AND".
- From the <Field> list, select the required operand value.
- The Abstract check box is disabled for Rule Based Asset classes.
- (Optional) To replace both the default class and class impacted icons with custom images, click the Select Custom radio button.
For more information, see To add the custom CI class details. - Click
.
- To activate the Rule Based Asset class, click Activate.
On activation, new CMDB instances are automatically synchronized based upon the rules set on the CI Class. - When prompted to synchronize existing CIs, perform one of the following actions:
- To synchronize the existing CIs, select Yes.
- To synchronize the existing CIs later, select No.
To synchronize the existing CIs at a later stage, you must perform the following actions:- On the CMDB Class form of the Rule Based Asset class, click Deactivate.
- Click Activate.
- When prompted to synchronize existing CIs, select Yes.
To delete a related Rule Based Asset class, from the Rule Based Asset Classes section, select that class from the list and click .