Search for attributes on event frames

Use the Event Frame Attribute Search window to retrieve event frame attribute data that matches your search criteria.

1. In the navigator pane, click Event Frames.

2. Choose from the following actions:

   • From the PI System Explorer menu, select Search > Event Frame Attribute Search.

   • In the browser, right-click the Event Frame Searches collection and select New Attribute Search.

3. Set the Event Frame Attribute Search window to find the desired attributes in the PI AF database:

   Under Where, set the fields to restrict attributes retrieved:

   1. Attribute name

      Enter the name of the attribute to retrieve. You can enter special characters to match part of a name. See Special characters in name searches.

   2. Attribute description

      Enter a string (of up to 440 characters) that retrieved attributes must match.

   3. Attribute category

      Select the category that retrieved attributes must match.

   4. Attribute value type

      Select the type of value that the retrieved attributes must store.

   5. Maximum results

      Enter the maximum number of matching attributes to retrieve.

4. In the Event Frame Criteria area, set the fields to restrict the search to matching attributes:

   • Search

     Choose criteria to find transfers that overlap the time period specified by Search start and Search end.

   • Search start / Search end

     Choose or enter start and end times for the search time period.

   • Search Root

     Enter the event frame to use as the root or base level for the attribute search. Type the exact name or click Browse to open the Event Frame Browser window, where you can view the hierarchy and select an event frame. You cannot include wildcard characters in the entered name. If you do not specify an event frame, the root is set to the main level of the hierarchy. Depending on the complexity of your PI AF hierarchy, specifying search root can improve search performance.

     Select the Search Sub-Event Frames check box to search the entered root and its children. Clear this check box to search only the entered root.

   • Name

     Enter the name of the event frames you want to search for attributes. You can enter special characters to match part of a name. See Special characters in name searches.

   • Description

     Enter a description string of up to 440 characters to retrieve only those elements that match.

   • Duration

     Enter minimum and maximum duration values to limit the attribute search to event frames whose duration is within these limits.

   • Category

     Select the category of the event frames you want to search for attributes.

   • Template

     Select the template of the event frames you want to search for attributes.

     If you specify values for multiple settings, the search returns only those attributes that match all the specified settings.

5. Click Search to retrieve the matching attributes into the Search results table.

   You can limit the results further to list only those attributes that match the text entered into the Search results field.

6. Select items in the search results list and click OK.

   The results are displayed in the viewer and in the browser tree. For more information on working with search results, see Manage search results.