Emerson PACSystems User Manual page 33

User Guide
GFK-3019G
▪
Note: The PI Server Web API limits the maximum length of a given request. To keep each HTTPS request
from the OSI PI Machine Adapter under this limit, each piConfig is limited to a maximum of 200 tag
elements.
▪
▪
OSI PI Machine Adapter
The piServerIpAddress attribute must be set to the web URL where the PI Server
—
is installed.
The piServerPort attribute must be set to the port number for the PI Server,
—
which is configured at the time of PI Web API installation. Default value is 443.
Each tag element corresponds to one PI Point on the PI Server
The piPointName attribute must be set to the value of Name associated with PI
—
Point we are interested in within PI Web API. If multiple server instances are
present, specify the full path name including the server instance and PI Point,
\\<ServerName>\<PIPointName>. In the case of a single server instance only
the PI Point is required, <PIPointName>. If the full path is not specified and
multiple server instances are present the first matching point found will be
used.
The tsTagName attribute is an optional parameter and can be set to the tag
—
name that is desired to be associated with the PI Point. This is the name that
will appear in the Predix Time Series Database, for example. It must have a
unique name relative to other tags in the same Predix Time Series Database. If
not specified, the above configured piPointName will appear in the Predix Time
Series Database.
Inside the dataSubscriptionConfigs element, each dataSubscriptionConfig
element corresponds to a desired subscription, which includes one or more tags
configured to be read at a given update interval.
The name attribute must be set to a text name that uniquely identifies this
—
subscription. This name is later used in the Hoover Spillway configuration file
to configure the subscription as data released to a given Data River.
The updateInterval attribute must be set to the desired time interval between
—
consecutive attempts to read the tags configured for this subscription. Specific
format to be followed is <NUints> where N is the interval numeric and Units can
be ms (Milliseconds), s (Seconds), m (Minutes), or h (Hours)
The startPointUnit attribute is the unit of measure applied to the
—
startPointOffset attribute. Possible values include "SECONDS" "MINUTES" and
"HOURS". If this attribute is not present, the default unit of measure is
SECONDS.
The startPointOffset attribute is the amount of time to wait after the OSI PI
—
Machine Adapter starts to begin reading configured tag data. The unit of
measure defaults to seconds unless the startPointUnit attribute is provided, in
which case the unit of measure is either minutes or hours.
Each subscriptionNode element lists the name of a piConfig attribute set in the
—
dataNodeConfigs section to be included in the subscription.
Save and close com.ge.ac.machineadapter.osipi-0.xml.
Chapter 5
Oct 2019
29