PointAttributes Collection

                      

 

 

The PointAttributes collection object is used to manage characteristics of a PIPoint. The collection contains PointAttribute objects which taken together, define a point’s configurable characteristics.

The logical meaning of the objects contained in a PointAttributes collection depends on the context. When addressing a PointAttributes collection obtained from a PointClass object the values of the contained attribute objects represent the default (or starting) values of the particular attribute for new points of that class.

When addressing a PointAttributes collection obtained from a PIPoint object, the values of the contained attribute objects represent the current values of the particular attribute for the particular point.

A PointAttributes collection obtained from an AttributeSets collection logically represents an attribute set. There is no specific AttributeSet object. The values of the contained attribute objects represent the default (or starting) values of the particular attribute for the attribute set.  

This object supports the IRefresh interface.

Remarks:

The PointAttributes returned for a point are server specific, though many attributes are common among PI2 and PI3 systems.  PI3 systems allow the definition of new PointClasses which contain custom PointAttributes.  PI2 systems contain attributes for historic reasons that are no longer supported in PI3.  For example, the "tag" attribute is common to both systems, but the PI2 system also supports, ShortName, LongName, and PlainName (PlainName is only defined in PISDK 1.3.1 and higher).  The ShortName is the tag name including delimiters (PI2 systems typically used : and . as delimiters in the tag name to form names like "01:Boiler.PV").  The LongName is an optional alias for a tag which can be up to 80 characters.  The PlainName is a representation of the ShortName without the delimiters (e.g. 01BoilerPV). The Tag attribute on PI2 returns the LongName if one is defined else the ShortName.

Enabling Operational Intelligence