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
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.
- 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.
- Click the attribute name that you want to insert in the rule.
- In the left pane, click an operator such as AND, OR, and so on, to insert it in the qualification rule.
- (Optional) This step applicable only if you are configuring the Attribute Values field for a normalization feature:
- In the left pane, click the icon to view the available functions such as CONCAT, TRUNCATE, and so on.
- 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.
- Repeat steps 3 through 5 as many times as required, until you have built a valid qualification rule.
- 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
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
ShortDescriptionattribute is a concatenation of the
CITag(LT30795) attribute values (CalbroLT30795).
UPPER($OwnerName$)— The value of the
OwnerNameattribute is populated as uppercase characters. For example, if the value that is discovered for the
OwnerNameattribute 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.
|Extracts the class name of the current CI. For example, |
|CONCAT(n1,n2)||Concatenates two strings. For example, if |
|LOWER(n1)||Converts the value to lowercase. For example, if |
Gets the major version number. For example, if VersionNumber contains 5.1.2,
Gets the major and minor version numbers. For example, if
Replaces the attribute value with a true NULL value. For example, if you want a certain attribute to be NULL, you can use the
|NULL||Represents a blank value. You must use empty double quotes to represent NULL. For example, |
Replaces all occurrences of a string value with another string value. For example,
Replaces first occurrence of a string value with another string value. For example,
Extracts a substring from the attribute.
Truncates the string value to a specified length.
For example, if
Converts the value to uppercase. For example, if