Tag Search and Hierarchy Navigation (4.4)

ON THIS PAGE:

Overview
Hierarchy Panel
- Attribute Panel and Table of Contents
Tags Panel
Functionality
Appendix A: Videos
Release History

This article applies to versions 4.4 and later of P2 Explorer. For help on current or earlier versions, see Release History.

Overview

Tags and attributes values 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. A flat list of tags can be located using Tag Search.

This article shows you how to navigate or search for entities from a selected hierarchy, and then select attributes, as well as how to search for tags. The article also describes what you can do with tags and attribute values.

You can open the Hierarchy Panel or the Tags Panel from the Navigators group on the Explorer ribbon, which is available on the View, Studio and Trend tabs.

Navigators on the View Tab

Navigators on the Studio Tab

Navigators on the Trend Tab

Hierarchy Panel

Click Hierarchy on the View, Studio or Trend tab of the Explorer Ribbon to open the Hierarchy panel.

1. Hierarchy button:

Click Hierarchy on the View tab of the Explorer Ribbon to open the Hierarchy panel.

2. Hierarchy selector:

To change the default hierarchy, select a different one from the drop-down list.

3. Hierarchy Search box:

Type three or more letters of the entity name you are searching for, then click to select an entity in the drop-down list that appears.

4. Hierarchy:

Navigate through the hierarchy by expanding nodes. Each node is an entity. Note that from version 4.4.4, icons are retrieved from P2 Server. If no icon has been configured for the entity, no icon will appear.

5. Close:

Click the X to close the panel. Alternatively, click Hierarchy a second time, or click Tags.

Attribute Panel and Table of Contents

In the Hierarchy Panel, click an entity to open its Attributes Panel and Table of Contents ribbon tab.

1. Selected entity:

In the Hierarchy Panel, click an entity to open its Attributes Panel and Table of Contents ribbon tab.

2. Table of Contents:

The entity's Table of Contents opens in a new tab on the Explorer ribbon. If there are links for the entity's primary template, these appear on the ribbon. The default link on the template appears as the first link, and is larger than the others. Links can open Explorer pages, trends or external URIs.

The Attributes Panel:

3. Attributes and Templates Count:

The number of attributes and templates for the selected entity.

4. Template:

Expand or collapse the template using the down or up arrow.

5. Attribute Group, Attributes, and Attribute Values:

The Attribute Group consists of logically related attributes (Operating Data, in the screenshot). Each attribute (Choke, THP and THT in the example) has attribute values listed below, for example Current Position, Differential Pressure. From version 4.4.4, attributes and attribute values that are assigned to a dataset have a dataset icon; for all other attributes, a tag icon appears alongside the attribute and attribute value.

6. Close:

Click the X to close the Attributes panel.

Tags Panel

Click Tags on the View, Studio or Trend tab of the Explorer Ribbon to open the Tags Panel.

1. Tag button:

Click Tags on the View tab of the Explorer Ribbon to open the Tags panel.

2. 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.

3. Datasource selector:

Select a datasource from the drop-down list, to filter the tag list. (Not all datasources contain tags.)

4. Tag list:

A filtered list of alphabetically sorted tags. Scroll down the list to find your tag.

5. Close:

Click the X to close the panel. Alternatively, click Tags a second time, or click Hierarchy.

Functionality

There are several functions you can perform from the Tag, Hierarchy or Attribute panels.

Open Point Details for a Tag or an Attribute Value
Open an Entity's Primary Link
Drop a Tag or an Attribute Value onto a Trend
Drop a Tag or an Attribute Value onto a Page

Open Point Detail

You can open the Point Details page for an Attribute Value (the Attribute Value Details page), or for a Tag (the Tag Details page).

Watch the video in Appendix A.

To open an attribute's details: navigate to an entity in the Hierarchy Panel, and select it. Then press the Ctrl key and click on an attribute or attribute value.

1. Locate an Entity:

Search or navigate through a hierarchy to find your entity.

2. Select Entity:

Click the entity to open the Attributes Panel for that entity.

3. Ctrl and Click:

On the Attributes Panel, locate an attribute or an attribute value, then press the Ctrl key and click.

4. Attribute Value Details Page Opens:

The attribute value details page opens for the selected attribute value (or for the default attribute value if you just select the attribute).

To open a tag's details: search for a tag in the Tags Panel. Then press the Ctrl key and click, on the tag.

1. Locate a Tag:

Search or scroll to find a tag.

2. Ctrl + Click:

Locate a tag, then press the Ctrl key and click.

3. Tag Details Page Opens:

The tag details page opens for the selected tag.

Related: Point Detail.

Open an Entity's Primary Link

If an entity has a primary link, there is a short-cut method for opening this.

Watch the video in Appendix A.

1. Navigate to an entity in the Hierarchy Panel.

2. Press the Ctrl key and click.

3. The primary link opens.

If there is no primary link, a 'no primary link' message is displayed.

Alternatively, you can open the primary link (or any other of the available links) from the Table of Contents.

1. Navigate to an entity in the Hierarchy Panel.

2. Click on the entity to open its Table of Contents.

3. Click on primary link in Table of Contents: this is the large left-most link.

Drop a Value onto a Trend

You can drop a tag or an attribute value onto a trend.

Watch the video in Appendix A.

First open a trend, or create a new trend.

To drop an attribute value onto a trend: navigate to an entity in the Hierarchy Panel, and select it. Then click and drag an attribute or attribute value from the attribute panel onto the trend.

1. Locate an Entity:

Search or navigate through a hierarchy to find your entity.

2. Select Entity:

Click the entity to open the Attributes Panel for that entity.

3. Click and Drag:

On the Attributes Panel, Locate an attribute or an attribute value, then click and drag the attribute or attribute value onto the trend.

The selected attribute value or the default attribute value of the selected attribute is added to the trend.

To drop a tag value onto a trend: search for a tag in the Tags Panel. Then click and drag the tag onto the trend.

1. Locate a Tag:

Search or scroll to find a tag.

2. Click and Drag:

Click and drag the tag onto the trend.

Tags and attributes are listed in the Left Axis table, as shown below.

1.	Attribute - fully qualified:	This attribute was dragged onto the trend from the hierarchy entity's attribute list. It contains the Entity name (Beardy), the Template name (Oil Producing Well), the Attribute (Choke), and the Attribute Value (Current Position).
2.	Tag:	The actual tag name, taken from the Tag Search. You can type this name in if you prefer, surrounded by curly brackets {}.
3.	Attribute:	This attribute name has been typed in. Because the definition is missing the template name and the attribute value, the primary template, and the default Attribute Value are used.

Related: Creating a Trend.

Drop a Value onto a Page

You can drop a tag or an attribute value onto a page.

Watch the video in Appendix A.

For attributes, this can either be an attribute value of the selected entity or of the default entity, depending on how you add it.

Press Ctrl when you click and drag an attribute value onto a page, to use the page default variable, selectedEntity.
Click and drag an attribute value onto a page, to use the entity selected in the hierarchy panel.

For tags, the tag selected in the Tag Panel is used.

First open a page, or create a new page.

To drop an attribute value onto a page: navigate to an entity in the Hierarchy Panel, and select it. Then click and drag an attribute or attribute value from the attribute panel onto the page.

The first time you drop an attribute onto a page, the page default value for SelectedEntity is assigned the value of that attribute's entity.

BOSSIER 1-1, the first selected entity, is assigned to selectedEntity

When you drag an attribute or attribute value onto the page, press Ctrl then click and drag if you want to use the selectedEntity default.

Note Selecting an attribute versus selecting an attribute value:

If you click and drag an attribute value onto a page, that attribute value is used.

If you click and drag an attribute onto a page, the default attribute value is used.

1. Locate an Entity:

Search or navigate through a hierarchy to find your entity.

2. Select Entity:

Click the entity to open the Attributes Panel for that entity.

3. Click and Drag :

On the Attributes Panel, locate an attribute or an attribute value, then click and drag the attribute or attribute value onto the page.

The selected attribute value of the selected entity is added to the page as a Data Label.

OR Ctrl Click and Drag:

On the Attributes Panel, locate an attribute or an attribute value, then press CTRL, then click and drag the attribute or attribute value onto the page.

The selected attribute value of the Page Default selectedEntity is added to the page as a Data Label.

To drop a tag value onto a page: search for a tag in the Tags Panel. Then click and drag the tag onto the page.

1. Locate a Tag:

Search or scroll to find a tag.

2. Click and Drag:

Click and drag the tag onto the page.

The tag is added to the page as a Data Label.

Tags and attribute values are added to the page as a Data Label. depending on what was added, and how it was added, this is what the data label properties look like:

Press Ctrl then click and drag an attribute value onto a page:

Click and drag an attribute value onto a page:

Click and drag a tag onto a page: