Tag Search and Hierarchy Navigation (4.3.1)

This article applies to versions 4.3.1 of P2 Explorer. For help on using Tag and Hierarchy Search and Navigation in the latest version of Explorer, see Tag Search and Hierarchy Navigation.

Overview

Tags and attributes have values that can be added to trends or viewed on pages, with or without calculations, to help you diagnose problems and visualise value changes over time.

Data that has been organised into a hierarchy in P2 Server can be located using Hierarchy Search or Navigation. The actual flat list of tags can be located using Tag Search.

This article shows you how to select a hierarchy, then navigate or search for entities, to pick attributes and attribute values. The article also describes how to search for tags.

HIERARCHY	TAGS
Overview of the Hierarchy Tab	Overview of the Tags Tab
Hierarchy button: Click Hierarchy on the View tab of the Explorer Ribbon to open the Hierarchy panel. Hierarchy search box: Type three consecutive letter of the entity you are searching for, then click to select the entity in the drop-down list that appears. Close: Click the X to close the panel. Alternatively, click Hierarchy a second time. Hierarchy selector: To change the default hierarchy, select another one from the drop-down list. Hierarchy: Navigate through the hierarchy by expanding nodes. Each node is an entity. Attribute button: Click to open the Attribute panel for the entity. This panel is described below.	Tag button: Click Tags on the View tab of the Explorer Ribbon to open the Tags panel. Close: Click the X to close the panel. Alternatively, click Tags a second time. Tags search box: Type all or part of the tag name in the search box. The filtered results make it easier to find a tag. Datasource selector: Select a datasource from the drop-down list, to filter the tag list. Tag list: A filtered list of alphabetically sorted tags. Scroll down the list to find your tag.

 

Pictured below is the attribute panel, opened for a selected entity on a hierarchy.

ATTRIBUTE PANEL

Return to hierarchy panel: Click the return button to return to the entity in the hierarchy. Close: Click the X to close the panel. Alternatively, click Hierarchy a second time. Count of attributes and templates: Number of attributes and templates for this entity. Expand attributes list: Expand the list of attributes for this template. Template: Attribute groups, with attributes listed below, are logical groupings of the template. Collapse template attribute list: Collapse the list of attributes for this template. Attribute group: A logically organised grouping of attributes. Attribute: The attribute here is defined as Attribute!Attribute Value.

Attribute Panel for an Entity on the Hierarchy

Attributes and Tags in a Trend's Tag List

Attribute - fully qualified: These attributes were dragged onto the trend's tag list from the hierarchy entity's attribute list. They contain the Entity name (Well 1), the Template name (Oil Producing Well), the Attribute (Tubing Head Pressure), and the Attribute Value (Target for the first one, and Actual for the second). Attribute: This is an attribute that has been typed in. It's missing the template name, and also the attribute value. The value here is for the Primary template, and for the default Attribute Value, which makes this attribute value {TWell 1:Tubing Head Pressure} identical to the one to its left: {TWell 1[Oil Producing Well]:Tubing Head Pressure!Actual}. You can also type in the attribute name, surrounded by curly brackets {}. Tag: The actual tag name, taken from the Tag Search. You can type this name in if you prefer, surrounded by curly brackets {}.

Use Hierarchy Navigation or Hierarchy Search to locate and use Attributes. Use Tag Search to locate and use Tags.

This video shows how to add attributes and tags onto a trend.

 

---

Tutorial 1 - Hierarchy Navigation

In this tutorial we'll navigate through the hierarchy until we find a particular entity. Then, we'll drop some of this entity's attributes onto a trend.

Related: Understanding P2 Server Data Structures: Hierarchies, Entities, Templates, and Attributes.

Hierarchy navigation is structured over two panels: the hierarchy panel and the attribute panel, as shown below:

Hierarchy Panel Description Example Hierarchy: There can be more than one hierarchy to choose from. Oil and Gas Entity: Each node of a hierarchy represents an entity. Derby. The full path here is P2 Energy Solutions>New South Wales>Far North Coast>Glen Innes>Central>Derby

Attribute Panel Description Example Template: A template is a logical grouping of attributes. Water Injection Well Attribute Group: Attributes can be distributed over logical attribute groups, which can be helpful when there are many of them in a template. Operating Status Attribute Value: Attributes may have more than one value. Each attribute value is prefixed by an exclamation ! mark. Status!Planned

 

Step by Step: Dropping an Attribute onto a Trend

We're going to search for some attributes to drop onto a trend. First we'll navigate to an entity and use some of its attributes, and then we'll search for another entity and use some of its attributes.

First we'll open a new trend.

If you have access to the training environment, you can follow the steps exactly as outlined here. Otherwise, you will need to adjust the configuration to suit your data.

 

Step 1. Add a New Trend

Open the Home tab on the Explorer ribbon, and click New Trend.

This opens a new Blank Trend. We're going to search for tags to use on this trend.

 

Step 2. Navigate to a Hierarchy's Entity

1. Open the View tab on the Explorer ribbon, and click Hierarchy.

2. Select Test Time Series Hierarchy from the hierarchies drop-down list.

3. Click to expand TOrganisation 1, then TRegion 1, then TArea 1, TField 1 and TWell 1.

4. Click the Attributes button to the right of TWell1 entity, to open the Attributes panel.

 

Step 3. Select an Attribute from the Attribute panel

The Attributes panel lists all the attribute values for your selected entity, TWell 1.

1. Locate the Oil Producing Well template on the Attribute panel.

2. Locate the Well attribute group within the Oil Producing Well template.

3. Locate the Age!Expected attribute value within the Well attribute group.

 

Step 4. Drag the Attribute Value onto the Trend Tags list

Now that you have found your attribute value, drop it onto the trend's Tag List.

 

Step 5. Add another Attribute Value to the Trend Tags list

Now search for attribute Age!Actual within the same attribute group and drop it onto the trend's Tag list.

 

Step 6. All Done!

You've managed to navigate to an entity, and add two of that entity's attributes to a trend. You can see the how the tag values change over time, if you use a trend hairline.

Don't forget to save your trend!

 

---

Tutorial 2 - Hierarchy Search

In this tutorial we'll search for an entity in the hierarchy.

Related: Understanding P2 Server Data Structures: Hierarchies, Entities, Templates, and Attributes.

1. In the Hierarchy panel search box, type in the name of the entity you are searching for. As soon as you have typed three letters, a search results drop-down list appears below the search box. The list contains a maximum of ten entities, each with its primary template. If your entity is not in the list, you can type more letters into the search box, to get the next list of up to ten entities.

2. Click the entity you want to find in the hierarchy.

The drop-down list disappears, and the chosen entity is selected in the hierarchy.

Search for the Entity	The Chosen Entity is selected in the Hierarchy
Searching for an Entity in the Hierarchy	The Chosen Entity is Selected in the Hierarchy

 

---

Tutorial 3 - Tag Search

In this tutorial we'll search for some tags to drop onto a trend.

Let's go through this process, step-by-step.

 

Step by Step: Dropping a Tag onto a Trend

We're going to search for some tags to drop onto a trend. First we'll open a new trend.

If you have access to the training environment, you can follow the steps exactly as outlined here. Otherwise, you will need to adjust the configuration to suit your data.

 

Step 1. Add a New Trend

Open the Home tab on the Explorer ribbon, and click New Trend.

This opens a new Blank Trend. We're going to search for tags to use on this trend.

 

Step 2. Search for a Tag

1. Open the View tab on the Explorer ribbon, and click Tags.

2. Select Pi Server from the datasource drop-down list.

3. Type 015AC119 in the Pi Server from the Search tags Search box.

4. Look for the 015AC119ZA.PV in list of tags.

Step 3. Drop the Tag onto the Trend Tags list

Now that you have found your tag, drop it onto the trend's Tag List.

 

Step 4. Add another Tag to the Trend Tags list

Now search for tag 015A_BENX.PV and drop it onto the trend's Tag list.

 

Step 5. All Done!

Well done. You've managed to find some tags and add them to a trend. You can see the how the tag values change over time, if you use a trend hairline.

Watch the video below to see how the tag values change as the hairline is dragged to the right and time moves forward.

 

Don't forget to save your trend!