Click or drag to resize
OSIsoft, LLC

PIPointFindPIPointsByPath Method

Find a collection of PIPoint objects from a specified list of path names as keyed results. The path name is the key to lookup the PIPoint object in the result.

Namespace:  OSIsoft.AF.PI
Assembly:  OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 2.10.6.195
Syntax
public static AFKeyedResults<string, PIPoint> FindPIPointsByPath(
	IEnumerable<string> paths
)

Parameters

paths
Type: System.Collections.GenericIEnumerableString
The collection of strings containing fully qualified pathnames to locate each PIPoint.

Return Value

Type: AFKeyedResultsString, PIPoint
Returns a dictionary of results where the key is the specified path and its value is the PIPoint resolved from the path.
Remarks
This method is used to resolve a list of tag path names to a collection of PIPoint objects. In addition to handling more than one server, this method will also handle duplicate pathnames within the requested list. Any unresolved tag path names can be found in the errors collection in the result. Server level error can be found in the PIServer errors collection of the result.

The fully qualified pathname should be in the form \\server\point. The server portion of the path should be in one of the following forms. The order of the serverName and serverID determines the preference (the first one has higher preference) when resolving the server by Name or ID.

  • serverName
  • {serverID}
  • serverName;{serverID}
  • {serverID};serverName
  • PIServers[serverName]
  • PIServers[{serverID}]
  • PIServers[{serverID};serverName]
  • PIServers[serverName;{serverID}]

The PI Point (tag) portion of the path should be in one of the following forms. The order of the pointName and pointID determines the preference (the first one has higher preference) when resolving the PI Point by Name or ID.

  • pointName
  • ?pointID
  • pointName?pointID
  • pointName;?pointID
  • ?pointID;pointName
  • PIPoints[pointName]
  • PIPoints[?pointID]
  • PIPoints[?pointID;pointName]
  • PIPoints[pointName?pointID]
  • PIPoints[pointName;?pointID]

Version Information

AFSDK

Supported in: 2.10.5, 2.10, 2.9.5, 2.9, 2.8.5, 2.8, 2.7.5, 2.7, 2.6, 2.5
See Also
Enabling Operational Intelligence