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

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

Using the Qualification Builder

This topic describes the procedure for creating a qualification rule using the Qualification Builder. 

When you configure a normalization feature, such as Version Rollup Rule or Relationship, the configuration page for the feature has a Qualifier field with the Qualification Builder icon . The Qualification Builder dialog box is displayed after you click the icon.

To build a qualification rule

  1. Click Allow manual edit if you want to manually enter the qualification rule.
    This option eliminates the need to build a qualification rule by clicking the attribute names and operators.

    In the right pane, the Name column displays a class name such as, BMC.CORE:BMC_BaseElement, that you selected when configuring the normalization feature. The attributes of this class are displayed under the class name. 

  2. In the Attributes section, click As Name if you want to insert an attribute name (for example, AccountID), or click As Value if you want to insert the value of an attribute (for example, $AccountID$) in the qualification rule.
  3. Click the attribute name that you want to insert in the rule. 
  4. In the left pane, click an operator such as AND, OR, and so on, to insert it in the qualification rule.
  5. (Optional) This step applicable only if you are configuring the Attribute Values field for a normalization feature:
    1. In the left pane, click the  icon to view the available functions such as CONCAT, TRUNCATE, and so on.
    2. Click the function names that you want to insert in the qualification rule. For more information about the description of each function, see the following section, Attribute Value functions. 
  6. Repeat steps 3 through 5 as many times as required, until you have built a valid qualification rule.
  7. Click Ok to close the Qualification Builder.
    The final qualification rule is displayed in the Qualifier field of the normalization feature page.

Attribute Value functions

When creating a relationship rule or a custom rule, you can use the Attribute Value functions to build an expression value that the Normalization Engine should apply to the selected attribute.

For example, Calbro Services wants to make sure that the OwnerName and ShortDescription attributes of their computer system CIs are consistent. To do this, Calbro Services creates custom rules for the BMC_ComputerSystem class and specifies the following attribute expressions:

  • CONCAT($Name$,$CITag$) — The value that is populated for the ShortDescription attribute is a concatenation of the Name (Calbro) and CITag (LT30795) attribute values (CalbroLT30795).
  • UPPER($OwnerName$) — The value of the OwnerName attribute is populated as uppercase characters. For example, if the value that is discovered for the OwnerName attribute is in  lowercase characters (for example, finance), this expression changes the attribute value to uppercase (FINANCE).

The following table contains descriptions of all Attribute Value functions.

FunctionDescription

CLASSNAME(n1)

Extracts the class name of the current CI. For example, CLASSNAME($ClassId$) looks up the class name using the ClassId.
CONCAT(n1,n2)Concatenates two strings. For example, if Name = Calbro and CITag = LT30795, then CONCAT($Name$,$CITag$) returns CalbroLT30795, the concatenation of Name and CITag.
LOWER(n1)Converts the value to lowercase. For example, if OwnerName contains Finance, LOWER($OwnerName$) returns finance.
MAJOR(n1)

Gets the major version number. For example, if VersionNumber contains 5.1.2, MAJOR($VersionNumber$) returns 5.

MAJORMINOR(n1)

Gets the major and minor version numbers. For example, if VersionNumber contains 5.1.2, MAJORMINOR($VersionNumber$) returns 5.1.

NULLOP()

Replaces the attribute value with a true NULL value. For example, if you want a certain attribute to be NULL, you can use the NULLOP() operation for that attribute.

NULLRepresents a blank value. You must use empty double quotes to represent NULL. For example, 'Name' != ""
REPLACEALL(n1,n2,n3)

Replaces all occurrences of a string value with another string value. For example, REPLACEALL($Hostname$," ","_") replaces all blank characters in Hostname with the underscore character.

REPLACEFIRST(n1,n2,n3)

Replaces first occurrence of a string value with another string value. For example, REPLACEFIRST($Hostname$," ","_") replaces the first blank character in Hostname with the underscore character.

SUBSTRING(n1,begin,end)

Extracts a substring from the attribute.

For example, SUBSTRING($Hostname$,"4","8") returns the string beginning with the fourth character and ending with the eighth character.

If end is 0, the rest of the string from begin is returned. For any error condition, the complete attribute string is returned.

TRUNCATE(n1,n2)

Truncates the string value to a specified length.

For example, if ShortDescription contains a 20 character string, TRUNCATE($ShortDescription$,"10") shortens it to the first 10 characters.

UPPER(n1)

Converts the value to uppercase. For example, if OwnerName contains Finance, UPPER($OwnerName$) returns FINANCE.



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

Comments