Managing Enumerated Data Sets

About this task

An enumerated data set provides an enhanced way of displaying data. It enables you to retrieve numeric data as string state values. You can use the string values in reports, charts, etc.
An enumerated set contains several states. A state is the number-string value pair in a set. It contains a set of numeric values and their corresponding string values. You can define an enumerated set for a single value or a range of values. These state values are defined for data states stored in Data Archiver. Data is retrieved using the value of the state. You have to define state values within a set to assign enumerated values.
Table 1. Example of a Single-Value Enumerated Set
State Name State Value
Manual 0
Automatic 1
Table 2. Example of a Range-of-Values Enumerated Set:
State Name State Value
ON 0 to 100
OFF 101 to 200
State names can be duplicated. If duplicated states exist, take precautions to avoid unpredictable results. For example, a tag is associated with an enumerated set defined as follows.
State Name State Value
0 Open
1 Close
2 Close
2 Open
The server will return unpredictable results due to the State Name duplication for an input of 2.
Note: You cannot assign an enumerated set to an array tag.

Procedure

  1. Access Historian Administrator.
  2. Select Tags.
  3. Select Define Enumerated Set.
    The Define Enumerated Set window appears.
  4. To create a set:
    1. Select Create New Set.
    2. Enter values as described in the following table.
      Field Description
      Set Name Enter a name for the set.
      Description Enter a description for the set.
      Enumerate By Specify whether you want to define a single value or a range of values.

      A single value is best used with integer values because they match exactly. A range of values can be used with floating point values because they may not match exactly due to rounding.
    3. Add a state.
    4. Select Save Set.
      The enumerated set is created.
  5. To create a state:
    1. In the State section, select New State.
    2. In the Enumerate by field, specify whether you want to use a single value or a range of values.
      If you select Single Value, the State Name, State Value, and Description fields appear. If you select Range, the State Name, Start Range, End Range, and Description fields appear.
    3. Enter values in the respective fields.
      Enter only numeric values in the State Values field; string values such as ON/OFF are not supported.
    4. Select Save to List.
      The state is created and added to the enumerated set.
  6. To delete a state:
    1. To delete a single state, select the state and select Delete State. To delete all the states, select Select All , then select Delete State.
      A message appears, asking you to confirm that you want to delete the state.
    2. Select Yes.
      The state is deleted.
  7. To delete a set:
    1. Right-click the set that you want to delete, and then select Delete Selected Set.
      A message appears, asking you to confirm that you want to delete the set.
    2. Select Yes.
      The enumerated set is deleted.