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 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.

Note

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

  1. In the Class Manager, open a class for editing.
  2. In the CI Class or Relationship Class dialog box, click the Attributes tab.
  3. In the Attributes tab, click New.
  4. In the Attribute dialog box, enter information for the common fields, as listed in the following table.
  5. Enter information for the optional fields specific to your selection for the Data Type field, as listed in the following table.
  6. (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:

    View permissions

    Change permissions

    • CMDB Data View
    • CMDB Data View All
    • CMDB Write Security
    • CMDB Data Change
    • CMDB Data Change All
  7. To add more attributes, repeat step 3 through step 6.
  8. Click OK to close the Attribute dialog box.
  9. Perform one of the following actions:

Action

Steps

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

  1. Click OK.
  2. In the confirmation dialog box, click OK.


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_BaseElement, BMC_Patch, BMC_Software, and 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.

Note

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.

Field

Description

Data Type

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.

Attribute Name

A descriptive name of up to 80 alphanumeric characters (including underscores) that is indicative of the function.

Note: There is no mechanism in the Class Manager to specify a localized label to appear in place of the Attribute Name on the class form. To change the label, use BMC Remedy Developer Studio to create or edit the appropriate view of the class form. For more information about BMC Remedy AR System views, see Form views.

Namespace

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.

Field ID

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.

Entry Mode

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:

  • Required — The attribute value must be filled in when a user creates an instance. A required attribute appears with a bold label in the class form.
  • Optional — You can enter information for the attribute or leave it empty.
  • Display only — The attribute is used as a temporary field. The value of the attribute is not stored in the database.

Audit Option

An option that determines whether changes to this attribute value trigger an audit:

  • Audit — Changes to the value trigger an audit.
  • Copy — Changes to the value cause the attribute to be written to the audit form.
  • Audit and Copy — Changes to the value trigger an audit and cause the attribute to be written to the audit form.
    The default is None. For more information about these options, see Attribute audit options in classes.

Attribute Type

The type of the attribute, either regular or core. You can create only regular attributes.

Custom Properties

Additional information about the attribute. You must enter the custom properties in serialized format. The serialization format for most attribute items is:
<listSize>\<propId>\<dataType>\<dataLength>\<propValue>
Custom properties for attributes are the same as for classes. For more information, see Custom Properties.

Primary Key

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 Indexes and class attributes.

Hidden

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

    Fields

    Description

    Applicable data types

    Allowable Currency Types

    List of currency types allowed.

    Currency

    Attachment Pool

    Name of the attachment pool to which the attachment field belongs.

    Attachment Field

    Default Value

    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.

    • Character
    • Currency
    • Date
    • Date/Time
    • Decimal
    • Diary
    • Integer
    • Real
    • Selection
    • Time

    Enum Type

    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.

    Selection

    Functional Currency Types

    List of currency types to which the value can be converted when it is saved to the database.

    Currency

    ID Values

    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.

    Selection

    Input Length

    Determines the maximum size of the attachment, measured in bytes. A value of 0 defaults to the maximum allowed by the database.

    Attachment Field

    List Format

    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;\;;d in this attribute when creating an instance of the class.

    Character

    Max

    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.

    • Currency
    • Decimal
    • Integer
    • Real

    Max Length

    Maximum number of characters that a user can enter in the attribute. The default is 255.

    Character

    Menu Name

    BMC Remedy AR System menu to attach to the attribute to allow users to select a value.

    Character

    Menu Style

    Select Append to append menu selections to the attribute's existing value, or Overwrite to replace an existing value with each menu selection.

    Character

    Min

    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.

    • Currency
    • Decimal
    • Integer
    • Real

    Pattern

    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.

    Character

    Precision

    Number of decimal places displayed.

    • Decimal
    • Real

    QBE Match

    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.

    Character

    Values

    Values that appear in the selection field.

    Selection

    Related topics

    Making data model changes visible to applications
    Example of how to create attributes using CMDB driver

Was this page helpful? Yes No Submitting... Thank you

Comments