Create an event view

If you want to analyze your data by event frames, create an event view. If you want to analyze your data broken down by assets, see Create an asset view. If you want to analyze your data broken down by assets and you need values streamed for real-time analytics or some other analysis, see Create a streaming view.

Note: PI Integrator for Business Analytics only returns closed event frames (with a valid start and end time). It cannot publish open event frame data.

1. Click the menu icon and click Create Event View.

2. Enter a name for the view.

   Note: Observe the naming conventions of the target to which this view will be published. For more information, see View names and destination endpoints.

3. If your user account is assigned to multiple PI AF identities with access to PI Integrator for Business Analytics, then click View Owner and select the identity to which you want to give view access.

   If your user account is mapped to only one PI AF identity that has been granted access to PI Integrator for Business Analytics, this identity is automatically assigned to the view.

   When you first create a view, you can only grant access to one PI AF identity. You can later grant access to additional PI AF identities. For more information, see Secure your views.

4. Click Create View.

5. In the Source Events pane, click Create a New Shape.

   Tip: You can use the shape of an existing view by clicking Import a Shape from Another View.

6. Use the Server and Database fields to select the PI AF server and database where the event frames are stored.

   Note: If application impersonation security setting is on, there will be a button that allows the user to see the Data Access identities used for the view.

7. From the Event Frames pane, drag the event frame and referenced element onto the Event Shape pane.

   Note: Click the icon in the Source Events pane and set filters to display only event frames that are of interest. For example, you can filter by time, assets, events, and asset or event templates. On the More Options pane, if All descendants is selected, the entire PI AF hierarchy is searched. If this is not selected, only the root-level event frames are searched.

   Tip: For tips on creating event shapes, see Tips on building shapes in event views.

8. Click the icon next to the element to open the Assets tab and go directly to its location in the PI AF hierarchy.

9. Drag any assets and attributes from the PI AF tree on to the Event Shape tree.

   For tips on creating asset shapes, see Tips on building shapes in event views.

10. To retrieve data for all event frames that share the same PI AF template:

    1. Click the icon next to the event frame in the Event Shape tree.

    2. Clear the Event Frame Name check box.

    3. Select the Event Frame Template check box and click Save.

11. Click Next to preview a subset of your data.

    The start time displayed is the start time of the first event frame that was added to the shape.

    PI Integrator for Business Analytics retrieves only closed event frames.

12. To refine the results, you can add more data, modify columns, filter the data, or change how values are retrieved. For more information, see Modify the data in your asset and event views.

    Note: Because PI Integrator for Business Analytics only displays the first 100 rows for the first 10 matches of your shape, you could set your filters in a way that excludes this data. In this situation, no data will appear on the page even though your configured view results in valid matches.

13. Click Next to publish your data.

14. From the Target Configuration list, select a target.

15. Click Run Once to publish the view once, or click Run on a Schedule to periodically append new data to the view.

16. Click Publish.