The types node presents various types of data used in TrueSight Server Automation as accepted, for example, by rules, properties, or configuration objects.
The types node can contain the following data type nodes:
Note
For built-in data types — enumerations, property classes, and configuration objects with built-in="true", as well as all primitives — definitions reflect the current configuration; you cannot use the content format file to define new built-in data types or to modify the definitions of existing built-in data types.
Primitives data type
Primitives are the most basic data forms, such as those based on simple strings or numbers. For each primitive, you specify an ID and a name, as well as a list of operators supported by the primitive.
Note
If an operator uses a different data type for the right-hand-side operand (as compared to the left-hand-side operand), that type appears in the rhs-type attribute before the id attribute. If the rhs-type is List, the additional rhs-backing-type attribute specifies the type of list (for example: Primitive:Decimal).
The ID of a primitive always begins with the Primitive: prefix.
The following XML code defines a primitive data type named Decimal.
<primitives> <primitive name="Decimal"> <operators> <operator-ref/> <operator-ref rhs-type="Range:Primitive:Decimal Range"/> <operator-ref/> <operator-ref/> <operator-ref rhs-backing-type="Primitive:Decimal" rhs-type="List"/> <operator-ref rhs-backing-type="Primitive:Decimal" rhs-type="List"/> <operator-ref/> </operators> </primitive>
</primitives>Enumerations data type
The enumeration data type enforces a choice of values from a closed list. The ID of an enumeration always begins with the Enumeration: prefix.
The following XML code defines an enumeration data type.
<enumerations> <enumeration name="ServiceErrorControlEnumeration" type="Primitive:String" built-in="true"> <value name="IGNORE">IGNORE</value> <value name="NORMAL">NORMAL</value> <value name="SEVERE">SEVERE</value> <value name="CRITICAL">CRITICAL</value> </enumeration>
</enumerations>Ranges data type
A range defines values between two points. Supported operators are listed for each range. Currently, TrueSight Server Automation supports three ranges: Integer Range, Date Range, and Decimal Range.
The ID of a range always begins with the Range: prefix.
The following XML code defines supported ranges.
<ranges> <range name="Integer Range" type="Primitive:Integer"> <operators> <operator-ref/> <operator-ref/> </operators> </range> <range name="Date Range" type="Primitive:Date"> <operators> <operator-ref/> <operator-ref/> </operators> </range> <range name="Decimal Range" type="Primitive:Decimal"> <operators> <operator-ref/> <operator-ref/> </operators> </range>
</ranges>Lists data type
The list data type accepts multiple values provided by the user. For each list you specify the list type and provide a list of operators supported by the list.
Note
If an operator uses a different data type for the right-hand-side operand (as compared to the left-hand-side operand), that type appears in the rhs-type attribute before the id attribute. If the rhs-type is List, the additional rhs-backing-type attribute specifies the type of list (for example: Primitive:Decimal).
The following XML code defines two lists.
<lists> <list type="Class://SystemObject/Device"> <operators> <operator-ref rhs-type="Class://SystemObject/Device"/> <operator-ref/> <operator-ref/> </operators> </list> <list type="Primitive:Encrypted String"> <operators> <operator-ref rhs-type="Primitive:Encrypted String"/> <operator-ref/> <operator-ref/> </operators> </list>
</lists>Property-classes data type
The property-classes data type defines property classes as configured in the Property Dictionary. For each property class, you provide a list of operators that are supported by that property class, as well as an optional list of properties included in the class.
Note
If an operator uses a different data type for the right-hand-side operand (as compared to the left-hand-side operand), that type appears in the rhs-type attribute before the id attribute. If the rhs-type is List, the additional rhs-backing-type attribute specifies the type of list (for example: Primitive:Decimal).
The ID of a property class always begins with the Class: prefix, and includes the full path to the property class within the Property Dictionary (for example: //SystemObject/User).
The following XML code defines a property class.
<property-classes> <class visible="true" deprecated="false" name="Class://SystemObject/User" built-in="true"> <description>Every User is an Instance of this Class</description> <operators> <operator-ref rhs-type="Primitive:String"/> <operator-ref rhs-type="Primitive:String"/> <operator-ref/> <operator-ref/> </operators> <properties> <property deprecated="false" editable="false" built-in="true" required="true" used-in-report="false" type="Class://SystemObject/Role"> <description>Default Role</description> </property> <property deprecated="false" editable="false" built-in="true" required="true" used-in-report="false" type="Primitive:Integer"> <description>Number of failed logins</description> <default> <value>0</value> </default> </property> <property deprecated="false" editable="true" built-in="false" required="false" used-in-report="false" type="enumeration"> <description></description> <enumeration type="Primitive:Integer"> <value name="intvalue1">1</value> <value name="intvalue2">2</value> </enumeration> <default> <value>1</value> </default> </property> </properties> </class>
</property-classes>Configuration-objects data type
The configuration-objects data type defines extended objects, server objects, and configuration files, as defined in the Configuration Object Dictionary.
The following XML code defines several configuration objects.
<configuration-objects> <extended-objects> <extended-object> <description></description> <grammar-data grammar-ref="ini.gm" os="Windows" encoding="Default"/> <command remote-execution="false">blquery $server:host$ -E "/C/Program Files/BMC Software/BladeLogic/ 8.0/share/sensors/extended_objects/groups.blq"</command> </extended-object> </extended-objects> <server-objects> <class root="false" version="1" name="Extended Object" built-in="true"> <properties> <property name="Path" type="Primitive:String"/> <property name="Name" type="Primitive:String"/> </properties> </class> </server-objects> <configuration-files> <configuration-file> <grammar-data grammar-ref="ini.gm" os="Windows" encoding="Default"/> <path>??TARGET.WINDIR??/desktop.ini</path> </configuration-file> </configuration-files>
</configuration-objects>
