Click or drag to resize
Grid Solutions Framework

PIOutputAdapter Class

Exports measurements to PI if the point tag or alternate tag corresponds to a PI point's tag name.
Inheritance Hierarchy
SystemObject
  GSF.TimeSeries.AdaptersAdapterBase
    GSF.TimeSeries.AdaptersOutputAdapterBase
      PIAdaptersPIOutputAdapter

Namespace: PIAdapters
Assembly: PIAdapters (in PIAdapters.dll) Version: 2.4.181-beta
Syntax
public class PIOutputAdapter : OutputAdapterBase
View Source

The PIOutputAdapter type exposes the following members.

Constructors
 NameDescription
Public methodPIOutputAdapter Creates a new PIOutputAdapter
Top
Properties
 NameDescription
Public propertyArchiveOnChangeDataTypes Gets or sets the data types to only archive on change. Empty string value means all values archived, * means archive all values on change, DIGI means only archive digital values on change. Separate multiple values with a comma, for example: DIGI,VPHM,FREQ.
Public propertyAutoCreateTags Gets or sets whether or not this adapter should automatically create new tags when managing metadata for PI points.
Public propertyAutoRemoveTags Gets or sets whether or not this adapter should automatically remove PI tags that no longer exist locally in metadata.
Public propertyAutoStart Gets or sets flag indicating if adapter should automatically start or otherwise connect on demand.
(Inherited from AdapterBase)
Public propertyAutoUpdateTags Gets or sets whether or not this adapter should automatically update existing tags when managing metadata for PI points.
Protected propertyConnectionAttemptInterval Gets or sets the connection attempt interval, in milliseconds, for the data output adapter.
(Inherited from OutputAdapterBase)
Public propertyConnectionInfo Gets connection info for adapter, if any.
(Inherited from AdapterBase)
Public propertyConnectionString Gets or sets key/value pair connection information specific to this AdapterBase.
(Inherited from AdapterBase)
Public propertyConnectTimeout Gets or sets the timeout interval (in milliseconds) for the adapter's connection
Public propertyDataSource Gets or sets DataSet based data source available to this OutputAdapterBase.
(Inherited from OutputAdapterBase)
Public propertyEnabled Gets or sets enabled state of this AdapterBase.
(Inherited from AdapterBase)
Public propertyEnableTimeReasonabilityCheck Gets or sets flag that indicates if incoming timestamps to the historian should be validated for reasonability.
Public propertyFutureTimeReasonabilityLimit Gets or sets the maximum number of seconds that a future timestamp, as compared to local clock, will be considered valid.
Public propertyID Gets or sets numeric ID associated with this AdapterBase.
(Inherited from AdapterBase)
Public propertyInitializationTimeout Gets or sets maximum time system will wait during Start for initialization.
(Inherited from AdapterBase)
Public propertyInitialized Gets or sets flag indicating if the adapter has been initialized successfully.
(Inherited from AdapterBase)
Public propertyInputMeasurementKeys Gets or sets primary keys of input measurements the AdapterBase expects, if any.
(Inherited from AdapterBase)
Public propertyInputSourceIDs Gets or sets Source values used to filter input measurements.
(Inherited from OutputAdapterBase)
Protected propertyInternalProcessQueue Allows derived class access to internal processing queue.
(Inherited from OutputAdapterBase)
Public propertyIsDisposed Gets a flag that indicates whether the object has been disposed.
(Inherited from AdapterBase)
Protected propertyLog Log messages generated by an adapter.
(Inherited from AdapterBase)
Public propertyMaximumPointResolution Gets or sets the maximum time resolution, in seconds, for data points being archived, e.g., a value 1.0 would mean that data would be archived no more than once per second. A zero value indicates that all data should be archived.
Public propertyMeasurementReportingInterval Gets or sets the measurement reporting interval.
(Inherited from AdapterBase)
Protected propertyMetadataRefreshOperation Gets the operation that calls ExecuteMetadataRefresh.
(Inherited from OutputAdapterBase)
Public propertyName Gets or sets the name of this AdapterBase.
(Inherited from AdapterBase)
Public propertyOutputIsForArchive Returns true to indicate that this PIOutputAdapter is sending measurements to a historian, OSIsoft PI.
(Overrides OutputAdapterBaseOutputIsForArchive)
Public propertyOutputMeasurements Gets or sets output measurements that the AdapterBase will produce, if any.
(Inherited from OutputAdapterBase)
Public propertyPassword Gets or sets the password used for the adapter's PI connection.
Public propertyPastTimeReasonabilityLimit Gets or sets the maximum number of seconds that a past timestamp, as compared to local clock, will be considered valid.
Public propertyPIPointClass Gets or sets the point class string used when automatically creating new PI points during the metadata update. On the PI server, this class should inherit from classic.
Public propertyPIPointSource Gets or sets the point source string used when automatically creating new PI points during the metadata update
Public propertyProcessedMeasurements Gets the total number of measurements handled thus far by the AdapterBase.
(Inherited from AdapterBase)
Public propertyProcessingInterval Gets or sets the desired processing interval, in milliseconds, for the output adapter.
(Inherited from OutputAdapterBase)
Public propertyRequestedInputMeasurementKeys Gets or sets input measurement keys that are requested by other adapters based on what adapter says it can provide.
(Inherited from OutputAdapterBase)
Public propertyRequeueOnException Gets or sets whether or not to automatically place measurements back into the processing queue if an exception occurs while processing. Defaults to false.
(Inherited from OutputAdapterBase)
Public propertyRunMetadataSync Gets or sets whether or not this adapter should automatically manage metadata for PI points.
Public propertyRunTime Gets the total amount of time, in seconds, that the adapter has been active.
(Inherited from AdapterBase)
Public propertyServerName Gets or sets the name of the PI server for the adapter's PI connection.
Public propertySettings Gets settings DictionaryTKey, TValue parsed when ConnectionString was assigned.
(Inherited from AdapterBase)
Public propertySkipDigitalAlternateTagSync Gets or sets flag that determines if tag synchronization should skip digitals when alternate tag field is being used.
Public propertyStartTime Gets the UTC time this AdapterBase was started.
(Inherited from AdapterBase)
Public propertyStartTimeConstraint Gets the start time temporal processing constraint defined by call to SetTemporalConstraint(String, String, String).
(Inherited from AdapterBase)
Public propertyStatus Returns the detailed status of the data output source.
(Overrides OutputAdapterBaseStatus)
Public propertyStopTime Gets the UTC time this AdapterBase was stopped.
(Inherited from AdapterBase)
Public propertyStopTimeConstraint Gets the stop time temporal processing constraint defined by call to SetTemporalConstraint(String, String, String).
(Inherited from AdapterBase)
Public propertySupportsTemporalProcessing Gets the flag indicating if this OutputAdapterBase implementation supports temporal processing.
(Inherited from OutputAdapterBase)
Public propertySyncAlternateTagOnly Gets or sets flag that determines if tag synchronization should only use alternate tag fields.
Public propertyTagMapCacheFileName Gets or sets the filename to be used for tag map cache.
Public propertyTagNamePrefixRemoveCount Gets or sets the number of tag name prefixes, e.g., "SOURCE!", applied by subscriptions to remove from PI tag names.
Public propertyUpdateExistingTagCompressionState Gets or sets the flag that determines if the compression enabled state, per UseCompression flag, should be adjusted for existing tags.
Protected propertyUseAsyncConnect Returns false to indicate that this PIOutputAdapter will connect synchronously
(Overrides OutputAdapterBaseUseAsyncConnect)
Public propertyUseCompression Gets or sets flag that determines if defined point compression will be used during archiving.
Public propertyUserName Gets or sets the name of the PI user ID for the adapter's PI connection.
Top
Methods
 NameDescription
Protected methodAttemptConnection Connects to the configured PI server.
(Overrides OutputAdapterBaseAttemptConnection)
Protected methodAttemptDisconnection Closes this PIOutputAdapter connections to the PI server.
(Overrides OutputAdapterBaseAttemptDisconnection)
Public methodDispose Releases all the resources used by the AdapterBase object.
(Inherited from AdapterBase)
Protected methodDispose(Boolean) Releases the unmanaged resources used by the PIOutputAdapter object and optionally releases the managed resources.
(Overrides OutputAdapterBaseDispose(Boolean))
Public methodEqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
Protected methodExecuteMetadataRefresh Sends updated metadata to PI.
(Overrides OutputAdapterBaseExecuteMetadataRefresh)
Protected methodFinalize Releases the unmanaged resources before the AdapterBase object is reclaimed by GC.
(Inherited from AdapterBase)
Public methodFlush Blocks the current thread, if the OutputAdapterBase is connected, until all items in OutputAdapterBase queue are processed, and then stops processing.
(Inherited from OutputAdapterBase)
Public methodGetArchiveQueueStatus Gets full archive queue status.
Public methodGetHashCode Serves as a hash function for the current AdapterBase.
(Inherited from AdapterBase)
Public methodGetShortStatus Returns a brief status of this PIOutputAdapter
(Overrides AdapterBaseGetShortStatus(Int32))
Public methodGetTypeGets the Type of the current instance.
(Inherited from Object)
Protected methodIncrementProcessedMeasurements Safely increments the total processed measurements.
(Inherited from AdapterBase)
Public methodInitialize Initializes this PIOutputAdapter.
(Overrides OutputAdapterBaseInitialize)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
Protected methodOnConfigurationChanged Raises ConfigurationChanged event.
(Inherited from AdapterBase)
Protected methodOnConnected Called when data output source connection is established.
(Inherited from OutputAdapterBase)
Protected methodOnDisconnected Called when data input source is disconnected.
(Inherited from OutputAdapterBase)
Protected methodOnInputMeasurementKeysUpdated Raises InputMeasurementKeysUpdated event.
(Inherited from AdapterBase)
Protected methodOnOutputMeasurementsUpdated Raises OutputMeasurementsUpdated event.
(Inherited from AdapterBase)
Protected methodOnProcessException(Exception)Obsolete.
Raises the ProcessException event.
(Inherited from AdapterBase)
Protected methodOnProcessException(MessageLevel, Exception, String, MessageFlags) Raises the ProcessException event.
(Inherited from AdapterBase)
Protected methodOnStatusMessage(String)Obsolete.
Raises the StatusMessage event.
(Inherited from AdapterBase)
Protected methodOnStatusMessage(String, Object)Obsolete.
Raises the StatusMessage event with a formatted status message.
(Inherited from AdapterBase)
Protected methodOnStatusMessage(MessageLevel, String, String, MessageFlags) Raises the StatusMessage event and sends this data to the Logger.
(Inherited from AdapterBase)
Protected methodOnUnprocessedMeasurements Raises the UnprocessedMeasurements event.
(Inherited from OutputAdapterBase)
Protected methodProcessMeasurements Sorts measurements and sends them to the configured PI server in batches
(Overrides OutputAdapterBaseProcessMeasurements(IMeasurement))
Public methodQueueMeasurementForProcessing Queues a single measurement for processing. Measurement is automatically filtered to the defined InputMeasurementKeys.
(Inherited from OutputAdapterBase)
Public methodQueueMeasurementsForProcessing Queues a collection of measurements for processing. Measurements are automatically filtered to the defined InputMeasurementKeys.
(Overrides OutputAdapterBaseQueueMeasurementsForProcessing(IEnumerableIMeasurement))
Public methodRefreshMetadata Initiates request for metadata refresh for OutputAdapterBase, if implemented.
(Inherited from OutputAdapterBase)
Public methodRemoveMeasurements This removes a range of measurements from the internal measurement queue.
(Inherited from OutputAdapterBase)
Public methodSetInitializedState Manually sets the initialized state of the AdapterBase.
(Inherited from AdapterBase)
Public methodSetTemporalConstraint Defines a temporal processing constraint for the adapter.
(Inherited from AdapterBase)
Public methodStart Starts this OutputAdapterBase and initiates connection cycle to data output stream.
(Inherited from OutputAdapterBase)
Public methodStop Stops this OutputAdapterBase and disconnects from data output stream.
(Inherited from OutputAdapterBase)
Public methodToStringReturns a string that represents the current object.
(Inherited from Object)
Top
Events
 NameDescription
Public eventConfigurationChanged Event is raised when adapter is aware of a configuration change.
(Inherited from AdapterBase)
Public eventDisposed Event is raised when AdapterBase is disposed.
(Inherited from AdapterBase)
Public eventInputMeasurementKeysUpdated Event is raised when InputMeasurementKeys are updated.
(Inherited from AdapterBase)
Public eventOutputMeasurementsUpdated Event is raised when OutputMeasurements are updated.
(Inherited from AdapterBase)
Public eventProcessException Event is raised when there is an exception encountered while processing.
(Inherited from AdapterBase)
Public eventStatusMessage Provides status messages to consumer.
(Inherited from AdapterBase)
Public eventUnprocessedMeasurements Event is raised every five seconds allowing host to track total number of unprocessed measurements.
(Inherited from OutputAdapterBase)
Top
Fields
 NameDescription
Public fieldStatic memberInstances Accesses local output adapter instances (normally only one).
Top
See Also