Creating CI and relationship class attributes
The BMC Atrium CMDB Class Manager helps you create attributes for Configuration Items (CI) and relationship classes. The Attributes tab of the CI Class and Relationship Class dialog boxes helps you manage the attributes of a class.
Before creating an attribute for a CI class, determine whether you want to store configuration data or lifecycle data for the CI in the new attribute. You must create a new attribute to store only configuration data for the CI. To store lifecycle data for the CI, you must add a field on the BMC Remedy ITSM Foundational form, AST:Attributes.
Version 8.0 of BMC Remedy IT Service Management moved the CI lifecycle data out of BMC Atrium Configuration Management Database (BMC Atrium CMDB) and included the data as fields in the BMC Remedy ITSM Foundational form, AST:Attributes. For detailed information about the changes, see Changes to the BMC Atrium CMDB for BMC Remedy ITSM.
Creating or modifying classes process
To create an attribute
- In the Class Manager, open a class for editing.
- In the CI Class or Relationship Class dialog box, click the Attributes tab.
- In the Attributes tab, click New.
- In the Attribute dialog box, enter information for the common fields, as listed in the following table.
- Enter information for the optional fields specific to your selection for the Data Type field, as listed in the following table.
(optional) In the Permissions section, select groups and roles that can view and modify the attribute.
If you do not specify permissions, BMC Atrium CMDB assigns the following permissions:
- CMDB Data View
- CMDB Data View All
- CMDB Write Security
- CMDB Data Change
- CMDB Data Change All
- To add more attributes, repeat step 3 through step 6.
- Click OK to close the Attribute dialog box.
- Perform one of the following actions:
You want to provide additional information for the class
Continue with the process described in Process overview for creating or modifying classes.
You are finished working with this class
Class attributes in the Class Manager
The Class Name column lists the selected class and the superclasses from which the class inherits attributes. For example, the Attributes tab for the
BMC_Patch class lists the
BMC_SystemComponent classes. Click the arrow next to a class to show all of the attributes for that class.
Attributes of the BMC_Patch class
You can view, modify, and delete existing attributes of a class. However, you can modify or delete only attributes that are unique to a class. You cannot modify or delete attributes inherited from a superclass.
When creating an attribute of the Selection data type, you can specify custom enumeration values instead of the default values, which start at 0 and increment by 1. This allows you to leave unused any numbers between the values you select. The benefit is that you can later add a selection between two others without invalidating existing data by changing the enumeration of the existing selections.
New attributes are not automatically visible on the class forms. For information about laying out attribute fields on class forms, see Control of the layout of class forms.
Common attribute fields
You can define common attributes for every attribute data type.
The following table lists the fields that appear in the Attribute dialog box and describes how you should enter information for those fields when creating an attribute. Fields marked with an asterisk are required.
The type of information that the attribute contains. After you select a data type, data type characteristics fields specific to your selection appear to the right of the Data Type field. For more information about these fields, see Data Type attribute fields.
A descriptive name of up to 80 alphanumeric characters (including underscores) that is indicative of the function.
Namespace for the attribute. Select or enter a namespace if this attribute should be in a different namespace than the class that contains it. To use the class namespace, leave this field blank. For more information, see Namespaces and partitioning the data model.
ID of the field created for the attribute on the class form. It is an integer that must be greater than 536870911 but less than 2147483647, which is the default maximum value for field IDs. To have the system generate an ID, leave this field blank.
Mode that determines whether the attribute must contain a value for each instance and whether its value is stored in the database. It can be any one of these options:
An option that determines whether changes to this attribute value trigger an audit:
The type of the attribute, either regular or core. You can create only regular attributes.
Additional information about the attribute. You must enter the custom properties in serialized format. The serialization format for most attribute items is:
Read-only value that indicates whether the attribute is a primary key for an index of this class in the database. For more information about indexes, see.
An option that determines whether the attribute is hidden on the class form.
Data Type attribute fields
Some fields in the Attribute dialog box appear only when you select certain values for the Data Type field.
The following table describes the fields on the Attribute dialog box that appear according to the Data Type selected for the attribute. All of these fields are optional. For more information about these fields, see:
- BMC Remedy AR System Field types
BMC Remedy AR System Data fields
Applicable data types
Allowable Currency Types
List of currency types allowed.
Name of the attachment pool to which the attachment field belongs.
Value that is saved for the attribute when a new instance is created if you do not enter a value. The Default Value can be a static value or a keyword from the field menu.
Specifies the way in which selection-field options are ordered in the database.
- Regular — BMC Remedy AR System assigns the IDs beginning with 0 and incrementing by 1.
- Custom — You must assign the IDs manually. You can enter any value from 10,001 through 214,74,83,647.
Note: For out-of-the-box attributes, BMC has reserved a range of enum IDs from 0 to 10,000.
Functional Currency Types
List of currency types to which the value can be converted when it is saved to the database.
If you selected a custom Enum Type for a selection field, enter the IDs for each of the values.
Note: For out-of-the-box attributes, BMC has reserved a range of enum IDs from 0 to 10,000. All new customizations must be done using IDs starting from 10,001.
Determines the maximum size of the attachment, measured in bytes. A value of 0 defaults to the maximum allowed by the database.
If you want the attribute to contain a list of character values, enter the maximum number of elements in the list in the format L <max>. If you want the attribute to contain only one value, leave this field empty. For example, enter L4 to specify a maximum of four list elements. This maximum is enforced by the BMC Atrium CMDB API. When creating instances of this class, delimit list elements in this attribute with a semicolon (; ). To include a semicolon in a list element, place a backslash (** ) in front of it. A semicolon after the last element is optional. For example, to create a list containing a, b, \;, and d, enter the string
a;b;\;;din this attribute when creating an instance of the class.
Maximum value allowed in this field. For Currency and Decimal types, the maximum can be any amount. For the Integer type, the maximum can be as high as 2147483647. For the Real type, the maximum can be as high as 1.845e+019.
Maximum number of characters that a user can enter in the attribute. The default is 255.
BMC Remedy AR System menu to attach to the attribute to allow users to select a value.
Select Append to append menu selections to the attribute's existing value, or Overwrite to replace an existing value with each menu selection.
Minimum value allowed in this field. For Currency and Decimal types, the minimum can be any amount. For the Integer type, the minimum can be as low as -2147483647 . For the Real type, the minimum can be as low as -1.845e+019.
Select a pattern if you want to allow only certain types of values in the attribute, such as alphabetic characters or selections from an attached menu.
Number of decimal places displayed.
Select the type of Query By Example (QBE) matching to be used when querying on this attribute from the class form. The default is Anywhere.
- Anywhere--The string matches if it is found anywhere in the attribute value.
- Leading--The string matches if it is found at the beginning of the attribute value.
- Equal--The string matches if it is exactly the same as the attribute value.
Values that appear in the selection field.
Related topicsMaking data model changes visible to applications
Example of how to create attributes using CMDB driver