Embedded Trend (4.5.4)

This article applies to version 4.5.4 of P2 Explorer. For the latest, see Embedded Trend.

Overview

The Embedded Trend component is used to embed a smaller version of a trend within an Explorer page, and is used for quick and simple diagnostics in Display Mode. As with the full Explorer trend, you can use hairlines on the embedded trend, and add comments to tags at a point in time, by clicking the trace line.

In Display Mode, you can drag and drop time series data labels from the page onto the trend, or drag tags and attributes from the Navigators. Right-click on the embedded trend to open a full Trend display.

Related: Using an Embedded Trend, Styling an Embedded Trend

Tutorial

In this tutorial, we'll show you how to add an embedded trend to a page in Studio, and then how to use the trend in Display Mode.

Adding the Embedded Trend

Step 1. Prepare a Studio Page

Before you start, click the New Page button on the Home tab of the ribbon. Choose the Precision Layout.

 

Step 2. Add an Embedded Trend

The Embedded Trend component is found under Charts in the Toolbox. Drag and drop it onto a page, and resize it so that it can be used to add data in Display Mode.

1. Drag and drop it onto a page in Studio (Design Mode).

2. Resize the embedded trend so that it can be used to add data in display mode.

 

It’s ready to use, or can be further configured.

 

Using the Embedded Trend

Save the page by clicking Finish and Open so that you can see it in Display Mode.

This is how your blank embedded trend appears in Display Mode.

Dragging Values onto the Embedded Trend from the Navigators

Still in Display Mode, see how you can drag and drop values from the Hierarchy Navigator and Tags Navigator onto the embedded trend.

1. On the Page ribbon tab, click Hierarchy to open the Hierarchy Navigator.

2. Select an entity.

3. Open the Attributes Panel, by clicking Show Attributes (the label changes to Hide Attributes).

4. Drag and drop an attribute value onto the embedded trend.

5. Click Hide Attributes to hide the Attributes Panel.

The attribute value appears on the embedded trend.

You can also add a tag: open the Tags Navigator, then drag and drop a tag onto the embedded trend.

Watch this short video to follow the steps outlined above.

Dragging Values onto the Embedded Trend from Data Labels on the Page

Also in Display Mode, you can add a data label's value onto the embedded trend, provided the value is a tag or an attribute.

First, we'll add data labels to the page. Then we'll add these to the embedded trend in Display Mode.

1. On the Page ribbon tab, click Edit to get back into Studio (Design) Mode.

2. On the Studio ribbon tab, click Hierarchy to open the Hierarchy Navigator.

3. Select an entity.

4. Open the Attributes Panel by clicking Show Attributes (the label changes to Hide Attributes).

5. Drag and drop an attribute value onto the page (which is still in Studio Mode), just above the embedded trend.

Now try this out in Display Mode.

1. Switch to Display Mode by clicking Finish and Open .

2. In Display Mode, drag and drop the data label onto the embedded trend.

The value is added as a trace line.

Watch this short video to follow the steps outlined above.

Configuring an Embedded Trend

The embedded trend works without any configuration, as many of the options are selected by default. Its purpose is to provide a place for users to add or remove data in Display Mode.

If you would like to configure the embedded trend, here are the options:

Related: Read about Explorer's Trend display, which shares many of the options found in the embedded trend component.

1. Data: You can add data in Design Mode, which is added to in Display Mode. Either drag and drop tags and attributes into this area, from the Navigators, or search for data in the Search edit box. 2. Show Legend: Selected by default. If you deselect the check box, the trend won't have legends. 3. Show x-axis: Selected by default. If you deselect the check box, the trend won't have the horizontal x-axis, showing time. 4. Show y-axis: Selected by default. If you deselect the check box, the trend won't have the vertical y-axis, showing values. 5. Auto Range: Selected by default. Auto Range manipulates the y-axis so that all values appear on the trend. 6. Trend Controls: Tip: Display the trend control values on the page, using text labels, or allow users to changes these by using interactive controls such as a Combo Box or Option Links. - Start Time defines the start of the trend range. The default value here is the page default for startTime. - End Time defines the end of the trend range. The default value here is the page default for endTime. - Sample Interval defines the method (for example, average) that P2 Server uses to collect the trend data. The default value here is the page default for pageSampleMethod. - Sample Method defines the interval (for example, 1 week) that P2 Server uses to collect the trend data. The default value here is the page default for pageSampleInterval. - Hairline Mode defines the number of hairlines allowable on the embedded trend (Single, Dual, Multiple or None). The default is None. 7. Hairline Start and Hairline End: The times here apply to the hairline start and end times. The defaults are hairlineStart and hairlineEnd, respectively. The values change as you pick the earliest (hairline start) and latest (hairline end) times. 8. Entity Context: Set the Entity Context if you have an ad hoc calculation as part of the embedded trend data. selectedEntity will update for the selected entity on the Hierarchy Navigator, if you open the page from the entity's Table of Contents ribbon tab. 9. Style: Select a style from the drop-down list.

Configuring Data for the Embedded Trend

Either drag and drop attribute values or tags from the Navigators, or type the values into the Search edit box.

This video shows how to add an attribute value, a tag, a calculation tag, and an ad hoc calculation to the embedded trend, by typing into the Search edit box.

 

Note that in Display Mode, you can remove data that was added in Display Mode [2], but data added in Design Mode [1] cannot be removed.

To remove a single trace item, click the little X in the legend. To remove all data added in Display Mode, click Reload on the Page ribbon tab.

Configuring Legend and Axes

Here are some examples of how the embedded trend appears in Display Mode, depending on how the options are configured.

No change to the configuration of legend, axes or auto range

Show Legend is deselected

Show x-axis is deselected

Show y-axis is deselected

Auto Range is deselected

---

Release History

• Embedded Trend 4.5.4 (this release)
  • You can now drag a data label for an ad hoc calculation onto an embedded trend
  • You can drag a data label from a different page onto an embedded trend
  • Embedded Trend Colours improved
  • The editor now shows a calculator icon for ad hoc calculation data

• Embedded trend (4.5)
  • The Embedded Trend component was introduced in Explore version 4.5.