Configure state variables in SEM

Use the Groups grid to add, edit, and delete state variables and the number, text, and time fields associated with each variable.

State variables are used in rules to represent temporary or transitional states. For example, you can create a state variable to track the state of a system, setting it to a different value depending on whether the system comes online or goes offline.

You can also configure rules to monitor the contents of a state variable to validate or invalidate a rule. For example, you can set a DEFCON value and ensure that the DEFCON value is over 3 before notifying your on-call staff.

If you require permanent lists of data that can be preserved over long periods of time, you can use user-defined groups in a similar manner.

Add a new state variable field

  1. On the SEM toolbar, navigate to Build > Groups.

  2. In the Groups grid, click , and then select State Variable.

    If you are editing a state variable, click next to the variable, and then select Edit.

    The State Variables pane displays as an editable form. If you are editing an existing state variable, the form displays any preconfigured fields.

  3. In the Name box, enter a name for the state variable.

  4. Click the Manager drop-down list and select the SEM Manager instance that will host the state variable. If you are editing an existing group, this field displays the hosting Manager.

  5. To display the Add Variable Field form, click .

  6. In the Name box, enter a name for the state variable field.

  7. In the Type list, select the type of state variable the field represents (Text, Number, or Time).

  8. To save the field, click Save in the first column.

    The new State Variable field appears in the State Variables grid with the field name and comparison type.

  9. Repeat steps 5 through 8 for each field you want to add to the state variable.

  10. To save the state variable settings, click Save in the right column.

    The new state variable displays in the Groups grid and the State Variables list in Rule Builder. You can incorporate this state variable whenever you add or edit a rule.

Edit a state variable field

  1. On the SEM toolbar, navigate to Build > Groups.

  2. In the Groups grid, select a state variable.

  3. Click , and then select Edit.

    The State Variables pane opens as an editable form.

  4. In the Fields grid, select the state variable field you want to edit.

    The Add Variable Field form appears, showing the current field configuration.

  5. Edit the field Name or Type as required.

  6. To apply your changes, click Save.

    The updated field appears in the fields grid.

  7. To save your changes to the state variable, click Save in the lower-right corner below the Comparison Type column.

Delete a state variable field

  1. On the SEM toolbar, navigate to Build > Groups.

  2. Select a state variable you want to delete.

  3. Click and then select Edit.

  4. In the Groups grid, do either of the following:

    The State Variables pane opens as an editable form.

  5. In the Fields grid, select the field you want to delete.

  6. Click to delete the field.

    The field is removed from the Fields grid.

  7. To save the changes, click Save.

Manage state variable folders

As with rules and email templates, you can use the Folders pane to organize your state variables into folders and sub-folders. You can add, rename, move, and delete state variable folders.