5.3 Defining Dynamic Groups (Generator Elements)

Dynamic groups (generator elements) are created directly from database columns. Use Generator elements to represent data from the database when no additional information about them is available or required.

For example, define a Generator element for every ticket number in a trouble ticket table when there is little need for additional alarm properties or element information.

As database information changes and is re‑queried by the run-time adapter, these elements are deleted or added as column data changes.

When setting up a Generated elements definition, the requirements are organized into two main tabs:

  • Generator: Specify basic descriptive information for the Generator element definition. Specify the database field that pulls unique values to produce each element.

  • Icon: Specify an icon for the Generator elements from the Operations Center Metamodel icon class browser or select custom icon. For more information, see Section 5.7, Assigning Icons to Groups, Dynamic Groups, and Database Elements.

To define dynamic groups, following the instructions in these sections:

5.3.1 Creating a Generator

  1. In the Definition Navigator pane, select the parent element of the new generator.

  2. Click (Create a Generated Element).

    A Generator element definition is created under the element in the Definition Navigator pane.

5.3.2 Specifying Basic Properties for a Generator Element

It is possible to create a parent/child hierarchy directly from the database columns. For example, values from the first column can create parent elements, while the unique values from another column create the child elements.

To specify basic properties for a Generator element:

  1. Select the Generator element in the Definition Navigator pane.

  2. In the left pane, Generator is selected by default and the Definition Properties pane shows basic properties for the definition:

  3. Use the Fetch Rows feature at the bottom of the Database Navigator pane to run a quick sampling of database information and verify that the correct table column is used to drive a Generator element.

  4. Specify the Name and Description for the definition (used only in the Definition Editor for the definition name).

  5. Enter XML in the Hierarchy XML field.

    The Hierarchy XML text area provides support for MODL (Managed Objects Definition Language) <param> tags, custom properties, and other tags that are valid with a MODL <generator> tag. You should know the XML syntax for what you want to accomplish.

    MODL is an XML-based markup language used to create HierarchyFiles for Operations Center. The HierarchyFile reflects both the nature of information received from a management system and the processing logic of the Operations Center system.

    For more information about MODL and the HierarchyFile, see Using the HierarchyFilein the Operations Center Adapter and Integration Guide.

  6. Specify a default algorithm for the group in the Custom Algorithm field.

    For more information, see the following set of steps.

  7. In the Property Name field, specify the database column whose values will drive the creation of these elements.

  8. Specify a database column name or drag and drop a column name from the Database Navigator field to the Property Name field.

    The query Property ID set for an alarm or database element definition that is a child definition of a Generator element must match exactly the Property Name specified for the Generator element. If these properties do not match, the elements are not created at run-time.

  9. Specify an icon.

5.3.3 Specifying a Default Algorithm

To specify a default algorithm for the group in the Custom Algorithm field:

  1. In the group Definition Properties pane, click Edit Algorithm to open the Edit Algorithm dialog box.

  2. In the Edit Algorithm dialog box, select the Use the Default Algorithm for This Element radio button to specify no custom algorithm.

    None displays in the Custom Algorithm field in the group Definition Properties pane.

  3. To set a custom algorithm, select the Select an Alternate Algorithm radio button, then select an algorithm type from the drop-down list.

  4. Click OK to close the Edit Algorithm dialog box.

    For information on algorithms, see Using Algorithms to Calculate Element State in the Operations Center Server Configuration Guide.