Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

Asset Framework and PI System Explorer (PI Server 2024 R2)

Indirect PI point references

  • Last UpdatedJan 07, 2025
  • 2 minute read

You can configure a PI point data reference to point at another attribute. The referenced attribute must itself be a PI point data reference. This is called an indirect reference to whatever PI point the target attribute references. It makes sense to reference by attribute when you need multiple attributes that each use data from the same PI point.

For example, suppose you have an attribute called Level that references a PI point registering a tank level. You want three child attributes to hold the daily average, minimum, and maximum tank levels. If you configure the three child attributes to reference the Level attribute, you can later change the Level attribute to reference a different point and you do not have to reconfigure child attributes. Used in combination with templates, this significantly reduces the amount of configuration required per element instance.

An example of four tags with the top tag representing an attribute labeled Level, which references a PI point that registers tank levels. The three child attribute tags are labeled average, maximum, and minimum.

Relative paths

To reference another attribute, the configuration string uses a relative path. The relative path identifies a data reference attribute based on its name and its place in the hierarchy of elements and attributes. For the PI point data reference, the path must include an attribute path designation (| or ..) in the configuration string so that it is distinguished from a PI point reference.

The following table shows typical configurations for indirect references:

Object

Syntax

Example

Top level attribute of same element

|topLevelAttribute

See "Full path from top-level ancestor" in Examples of attribute references to the same element.

Parent attribute

..

See "Parents and grandparent attributes" in Examples of attribute references to the same element.

Child attribute

.|childAttribute

See "Descendant attributes" in Examples of attribute references to the same element.

Sibling attribute (when not a top level attribute)

..|siblingAttribute

See "Sibling attributes" in Examples of attribute references to the same element.

From event frame to primary element

.\Elements[.]|Attribute

See Data attribute references to primary elements.

From event frame to attribute of parent element

.\Elements[.]\..\|Attribute

See "Examples that use relative paths" in Data attribute references to other elements.

From event frame to attribute of child element

.\Elements[.]\ChildElementName|Attribute

See "Examples that use relative paths" in Data attribute references to other elements.

Database path

\TopLevelElement|myAttribute

See "Attributes relative to database" in Examples of attribute references to different elements.

Full path

\\myServer\myDatabase\myElement|myAttribute

See Path syntax for attribute references.

TitleResults for “How to create a CRG?”Also Available in