Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Asset Framework and PI System Explorer (PI Server 2018)

Manage enumeration sets

  • Last UpdatedJan 11, 2023
  • 3 minute read

Beginning with PI AF 2018 SP2, you can export digital state sets from a Data Archive to create enumeration sets. For more information, see Review digital state sets on a Data Archive.

You use enumeration sets in attribute templates whenever you want to be able to select from lists of predefined values when you are defining element attributes. You also use enumeration sets to create reason attribute traits for event frames and transfers.

  1. In the navigator, click Library.

  2. Choose from the following actions.

    To ...

    Do this ...

    Create a new enumeration set

    1. Choose one of the following actions.

      • On the toolbar, click New Enumeration Set.

      • In the browser, right-click the Enumeration Sets collection and click New Enumeration Set.

    2. In the Name field, enter a unique name for the enumeration set.

    3. Optional. In the Description field, enter a description for the enumeration set.

    4. Optional. To use hexadecimal values, select the Hexadecimal check box.

    5. Optional. If you want to configure access permissions for the new enumeration set that are different from those inherited from the Enumeration Sets collection, click the Security link. For more information, see Configure security for objects.

    Create a new enumeration value

    1. Choose one of the following actions.

      • In the browser, click an existing enumeration set. In the viewer, right-click in any Value field and click New Enumeration Value.

      • In the browser, right-click an existing enumeration set and click New Enumeration Value.

      The value is a unique numeric value associated with the enumeration and provides a quicker, less memory-intensive representation of an enumeration's value.

    2. In the Value field of the Enumeration Value Properties window, either enter a unique number manually, or click to increase or lower the value.

    3. In the Name field, enter a unique string that describes the condition or state being represented. This string is used as the displayed value when an enumeration set is selected as the value type for an attribute.

    4. Optional. In the Description field, enter a description for the enumeration value.

    Create a new child enumeration value in Enumeration Value Properties window

    1. In the browser, click an existing enumeration set.

    2. In the viewer, right-click an existing value to which you want to add a child enumeration value, and click New Child Enumeration Value.

    3. In the Enumeration Value Properties window, verify that the value selected in the Parent field is correct. Otherwise, select a different parent from the list.

    4. In the Value field, either enter a unique number manually, or click to increase or lower the value.

    5. In the Name field, enter a unique string that describes the condition or state being represented. This string is used as the displayed value when an enumeration set is selected as the value type for an attribute.

    6. Optional. In the Description field, enter a description for the enumeration value.

    Create a new child enumeration value manually

    1. In the browser, click an existing enumeration set.

    2. In the viewer, click an empty row and enter a unique number manually in the Value field.

    3. In the Name field:

      1. Enter the original enumeration value for which you want to create a child value.

      2. Enter a | character.

      3. Enter a unique string that represents the child enumeration value.

      1. Optional. In the Description field, enter a description for the child enumeration value.

      Rename an enumeration value

      1. In the browser, click an existing enumeration set.

      2. In the viewer, right-click the existing value that you want to rename and click Properties.

      3. In the Name field of the Enumeration Value Properties window, revise the name string as needed but ensure it remains unique. If the name is being used as a parent enumeration value, note that the name change will update the parent portion of all child enumeration value strings.

      Renumber enumeration values

      See Renumber enumeration values.

      Delete an enumeration value

      1. In the browser, click an existing enumeration set.

      2. In the viewer, right-click the existing value that you want to delete and click Delete.

      3. Click Yes in response to the Delete warning. Note that you will invalidate objects where the value is currently being used.

    4. On the toolbar, click Check In.

    Related Links
    TitleResults for “How to create a CRG?”Also Available in