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 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 theShortDescription
attribute is a concatenation of theName
(Calbro) andCITag
(LT30795) attribute values (CalbroLT30795).UPPER($OwnerName$)
— The value of theOwnerName
attribute is populated as uppercase characters. For example, if the value that is discovered for theOwnerName
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.
Function | Description |
---|---|
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, |
MAJORMINOR(n1) | Gets the major and minor version numbers. For example, if |
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 |
NULL | Represents 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, |
REPLACEFIRST(n1,n2,n3) | Replaces first occurrence of a string value with another string value. For example, |
SUBSTRING(n1,begin,end) | Extracts a substring from the attribute. For example, |
TRUNCATE(n1,n2) | Truncates the string value to a specified length. For example, if |
UPPER(n1) | Converts the value to uppercase. For example, if |
Comments
Log in or register to comment.