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

AF SDK Reference

PISystem Methods

  • Last UpdatedNov 18, 2025
  • 13 minute read
PISystem Methods

The PISystem type exposes the following members.

Methods

  NameDescription
Public methodCode example
ApplyChanges
This method applies (saves) all the changes to objects modified at the system level by the current user and makes those changes available to other applications executing under the same user account.
Public methodCode example
ApplyChanges(AFCheckedOutMode)
This method applies (saves) all the changes to objects modified at the system level according to the specified AFCheckedOutMode and makes those changes available to other applications executing under the same user account.
Public methodCode example
ApplyChanges(IListIAFTransactable)
This method applies (saves) the changes to the specified modified objects and makes those changes available to other objects.
Public method
CanCreateCollective
Check if a collective can be created for this PISystem.
Public methodCode example
CheckIn
This method checks in (commits) all the changes to all modified objects at the system level by saving the object's information to persistent storage.
Public methodCode example
CheckIn(AFCheckedOutMode)
This method checks in (commits) all the changes to all modified objects at the system level by saving the object's information to persistent storage according to the specified AFCheckedOutMode.
Public methodCode example
CheckIn(IListIAFTransactable)
This method checks in (commits) the changes to the specified modified objects by saving the object's information to persistent storage.
Public method
CompareTo(Object)
Compares this instance with a specified Object.
(Inherited from AFObject.)
Public method
CompareTo(AFObject)
Compares this instance with a specified AFObject.
(Inherited from AFObject.)
Public methodCode example
Connect
Connects to the server using default credentials to allow sending and retrieving data.
Public methodCode example
Connect(NetworkCredential)
Connects to the server using the specified credentials to allow sending and retrieving data.
Public methodCode example
Connect(String)
Connects to the server using the specified Access Token to allow sending and retrieving data.
Public methodCode example
Connect(AFConnectionPreference)
Connects to the server using the specified connection preference to allow sending and retrieving data.
Public methodCode example
Connect(Boolean, IWin32Window)
Connects to the server with a credential prompt if necessary to allow sending and retrieving data.
Public methodCode example
Connect(NetworkCredential, AFConnectionPreference)
Connects to the server using the specified credentials and connection preference to allow sending and retrieving data.
Public methodCode example
Connect(String, AFConnectionPreference)
Connects to the server using the specified Access Token to allow sending and retrieving data.
Public methodCode example
Connect(String, String)
Connects to the server using the specified credentials to allow sending and retrieving data.
Public methodCode example
Connect(Boolean, IWin32Window, AFConnectionPreference)
Connects to the server using the specified connection preference with a credential prompt if necessary to allow sending and retrieving data.
Public methodCode example
Connect(String, String, AFConnectionPreference)
Connects to the server using the specified credentials to allow sending and retrieving data.
Public methodCode example
Connect(Boolean, IWin32Window, AFConnectionPreference, Boolean)
Connects to the server using the specified connection preference with a credential prompt if necessary to allow sending and retrieving data and return an indication that dialog was canceled.
Public methodCode example
ConnectWithPrompt
Connects to the server prompting for credentials.
Public methodCode example
ConnectWithPrompt(IWin32Window)
Connects to the server prompting for credentials.
Public methodCode example
ConnectWithPrompt(AFConnectionPreference)
Connects to the server prompting for credentials and specifying a connection preference.
Public methodCode example
ConnectWithPrompt(IWin32Window, AFConnectionPreference)
Connects to the server prompting for credentials and specifying a connection preference.
Public method
CreateCollective
Convert the PISystem into a member of a new AFCollective.
Public methodStatic member
CreatePISystem
Create a new PISystem instance based upon the specified host address.
Public method
Disconnect
Disconnects an open connection to the PI AF Server.
Public method
Equals(Object)
Determines whether the specified Object is equal to the current object.
(Overrides AFObjectEquals(Object).)
Public method
Equals(AFObject)
Indicates whether the current object is equal to another object of the same type.
(Inherited from AFObject.)
Public method
Equals(PISystem)
Indicates whether the current object is equal to another object of the same type.
Public method
ExportCsv(Object, IListType, IListString, CultureInfo)
Exports the CSV representation of requested object(s) and returns it as a string.
Public method
ExportCsv(Object, IListType, IListString, PIExportMode, CultureInfo)
Exports the CSV representation of requested object(s) and returns it as a string.
Public method
ExportCsv(Object, IListType, IListString, CultureInfo, String, Object, Object, EventHandlerAFProgressEventArgs)
Exports the representation of requested object(s) in comma-separated (CSV) format to a file.
Public method
ExportCsv(Object, IListType, IListString, PIExportMode, CultureInfo, String, Object, Object, EventHandlerAFProgressEventArgs)
Exports the representation of requested object(s) in comma-separated (CSV) format to a file.
Public method
ExportXml(Object, PIExportMode)
Exports the XML representation of any object(s) and returns it as a string.
Public method
ExportXml(Object, PIExportMode, String, Object, Object, EventHandlerAFProgressEventArgs)
Exports the XML representation of any object(s) to a file.
Public method
ExportXml(Object, PIExportMode, XmlWriter, Object, Object, EventHandlerAFProgressEventArgs)
Exports the XML representation of any object(s) to an XmlWriter.
Public methodCode example
FindChangedItems(Boolean, AFTime, AFTime) Obsolete.
Find all the items that have changed in the PISystem.
Public methodCode example
FindChangedItems(Boolean, Int32, Object, Object)
Find all the items that have changed in the PISystem for all types of objects.
Public methodCode example
FindChangedItems(AFIdentity, Boolean, AFTime, AFTime) Obsolete.
Find all the items that have changed in the PISystem of the specified type.
Public methodCode example
FindChangedItems(Boolean, Boolean, Int32, Object, Object)
Find all the items that have changed in the PISystem with the option to retrieve both the system and database level changes.
Public methodCode example
FindChangedItems(AFIdentity, Boolean, Int32, Object, Object)
Find all the items that have changed in the PISystem of the specified type.
Public methodCode example
FindChangedItems(AFIdentity, Boolean, Boolean, Int32, Object, Object)
Find all the items that have changed in the PISystem of the specified type with the option to retrieve both the system and database level changes.
Public method
FindCheckedOutItems
This method finds all the items that are currently checked out in the PISystem.
Public method
GetActiveDirectoryProperties
Retrieves the Active Directory settings the server uses to retrieve contact information.
Public method
GetAnonymousClientChannelTChannel
Creates a ChannelFactory. The factory will be created using the provided binding and address. The channel will use a TLS connection with no client credentials.
Public method
GetClientChannelTChannel
Creates a ChannelFactory. The factory will be created using the appropriate binding and address based on the AFAuthenticationMode the PISystem is currently connected with.
Public methodCode example
GetClientRpcMetrics
Get the remote procedure call metrics to the server for this PISystem.
Public method
GetCsvColumns(Type)
Retrieve a collection containing the required and optional CSV columns for the specified object type and its children.
Public method
GetCsvColumns(Type, IListType)
Retrieve a collection containing the required and optional CSV columns for the specified object type and its children.
Public methodCode example
GetFindChangedItemsCookie
Retrieve the server cookie used in conjunction with FindChangedItems.
Public method
GetHashCode
Gets the hash code for this instance of the object which is suitable for use in hashing algorithms and data structures like a hash table.
(Overrides AFObjectGetHashCode.)
Public method
GetIdentityProvidersandRoles
Returns a collection of the configured Roles of the .
Public method
GetIdentityServerBestRsso
Method to retrieve the Best Redundant Single Sign-On Server Endpoint for the Identity Server for the .
Public method
GetObjectCounts
Gets the total number of objects by type in the database.
Public method
GetPath
Returns the full path to the object, using just the names.
(Inherited from AFObject.)
Public method
GetPath(AFObject)
Returns the path to the object relative from another object.
(Inherited from AFObject.)
Public method
GetPath(AFEncodeType, AFObject)
Returns the path to the object relative from another object, using the name and/or id as specified by encodeType.
(Inherited from AFObject.)
Public methodCode example
GetRpcMetrics
Get the remote procedure call metrics for the server.
Public method
GetSecurity
Gets the AFSecurity information of the specified security item associated with the object.
Public method
GetSessions(NullableAFTime, NullableAFTime, AFSortOrder, Int32, Int32)
Retrieves session data for the specified filter criteria.
Public method
GetSessions(NullableAFTime, NullableAFTime, AFSessionSortField, AFSortOrder, Int32, Int32)
Retrieves session data for the specified filter criteria.
Public method
GetType
Gets the Type of the current instance.
(Inherited from Object.)
Public method
ImportCsv(AFDatabase, PIImportMode, CultureInfo, Stream, EventHandlerAFProgressEventArgs)
Imports the comma-separated value (CSV) representation of any object from a stream.
Public method
ImportCsv(AFDatabase, PIImportMode, CultureInfo, String, EventHandlerAFProgressEventArgs)
Imports the comma-separated value (CSV) representation of any object from a file.
Public method
ImportXml(Object, PIImportMode, String)
Imports the XML representation of any object from either a file or string.
Public method
ImportXml(Object, PIImportMode, Stream, EventHandlerAFProgressEventArgs)
Imports the XML representation of any object from a stream.
Public method
ImportXml(Object, PIImportMode, XmlReader, EventHandlerAFProgressEventArgs)
Imports the XML representation of any object from an XmlTextReader.
Public method
LogOut
Logs out the current OIDC user and disconnects all associated open connections to the PI AF Server.
Public method
Persist
This method returns the persistence string for the object.
(Inherited from AFObject.)
Public method
Refresh
Refreshes the client with any changes that have been made to any system-level object since loaded.
Public method
Refresh(Boolean)
Refreshes the client with any changes that have been made to any system-level and optionally database-level objects since loaded.
Public method
Refresh(IEnumerableAFObject)
Refreshes the client with any changes that have been made to the specified objects since they were loaded.
Public method
RemovePlugInAssembly
Removes a AFPlugIn assembly from the database.
Public method
RemovePlugInSupportAssembly
Removes an AFPlugIn support assembly from the database.
Public method
SetActiveDirectoryProperties
Sets the Active Directory settings the server uses to retrieve contact information.
Public method
Supports(PISystemFeatures)
Checks if the specified PISystemFeatures feature is supported by the PISystem.
Public method
Supports(String, Boolean)
Checks if the specified feature is supported by the PISystem.
Public method
ToString
Returns a String that represents the current object.
(Inherited from AFObject.)
Public method
UndoCheckOut
Rolls back all the changes to the system since the last call to the CheckOut method of each object. Any changes since the check out will be lost.
Public method
UploadPlugInAssembly
Uploads a AFPlugIn assembly to the database.
Public method
UploadPlugInSupportAssembly
Uploads a AFPlugIn support assembly to the database.

See Also

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