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

AF SDK Reference

Filters

Clear all filters
Product Family
Clear all filters
Current publication
Table of Contents
HomeAF SDK Reference...OverviewWhat's NewWhat's New in PI AF 2016Current page
TABLE OF CONTENTS

What's New in PI AF 2016

Save PDF
Save selected topicSave selected topic and subtopicsSave all topics
Share
Share to emailCopy topic URL
Feedback
What's New in PI AF 2016

The PI AF 2016 (2.8.0.7444, 2.8.1.7549, 2.8.2.7626) release is a major release that implements a preview of a new, more scalable notification infrastructure. This also expands the functionality of event frames to include annotations, acknowledgments and severity. Annotations are provided for elements, transfers and cases as well.

The ability to define attributes with specific characteristics and behaviors, such as limits and predictions, and associate those with other attributes has been added.

New data access calls are available, including async versions of most data calls. New methods of RecordedValuesAtTimes and ReplaceValues allow more efficient data access with the PI Data Archive 2016.

This release also delivers improved scalability and performance overall, with major improvements focused on event frame searching. The AF SDK provides a new, simpler, text-based query mechanisms for finding Elements and Event Frames.

This topic contains the following sections:

OSIsoft.AF Namespace

The AFSecurityRights.Annotate security permission was added to control the ability to annotate an AFBaseElement and acknowledge an AFEventFrame. The AFObject.GenerateUniqueName(String, IAFList) helper method was added to allow the generation of unique names based upon the items in the supplied list. The following new properties return the configured restrictions for an AFFile which are set using the AFDiag utility: PISystem.FileAllowedExtensions and PISystem.FileMaxLength.

To support exporting in different time formats when exporting in CSV format, the PIExportMode.UseServerTimeZone and PIExportMode.UseUtcTime properties have been added. To support searching for an attribute by trait, the new path filter AFPathFilterType.Trait has been added.

To support a new, more scalable notification infrastructure, the following collections have been added in preview for this release:

OSIsoft.AF.Analysis Namespace

The AFAnalysisTemplate.CreateEnabled was added to control the initial status of auto-generated analyses.

OSIsoft.AF.Asset Namespace

An attribute can be designated for manual data entry with the new AFAttributeTemplate.IsManualDataEntry and AFAttribute.IsManualDataEntry properties. Client applications can utilize this flag to determine whether to provide users with data entry. The new method AFAttribute.IsSupportedDataMethod(AFDataMethods) was added to test if an attribute supports a data method.

The new class AFAttributeTrait has been added to allow attributes with well-known behaviors and relationships to be defined. The trait can be used when referencing or finding the attribute instead of needing to know the actual name of the attribute. The following properties and methods have been added to be used with attribute traits:

To support annotations on an AFBaseElement, the AFBaseElement.IsAnnotated property and AFBaseElement.GetAnnotations method have been added. A new copy constructor AFFile.AFFile(AFFile) was added to make it easier to copy file values. To support acknowledging an event frame, the AFElementTemplate.CanBeAcknowledged property was added. The AFElementTemplate.Severity property was added to set the default severity for a new event frame.

The AFValue.Create methods have been added to allow the creation of an AFValue without the overhead of boxing/unboxing.

To support new methods in AFData class, the following new methods have been added to a data reference:

The following new properties and methods have been added in preparation for new, more scalable notification infrastructure. Even though these objects are exposed in the SDK, they are still under development and subject to change.

OSIsoft.AF.Data Namespace

The new method AFData.ReplaceValues has been added to replace values within a time range. PI Data Archive 2016 or later is required. To get values as specific times, the AFData.RecordedValuesAtTimes and AFListData.RecordedValuesAtTimes methods have been added. These methods require the PI Data Archive 2016 or later to take full advantage of the performance gains.

Support for asynchronous method calls has been added with the addition of the following methods (corresponding methods were also added to the AFDataReference class):

To support annotations on an AFBaseElement, the following properties and methods have been added to the AFAnnotation class:

OSIsoft.AF.EventFrame Namespace

OSIsoft.AF.Notification Namespace

OSIsoft.AF.PI Namespace

The new method PIServer.Supports and new enumeration PIServerFeature have been added to allow checking if a feature is supported on the PI Data Archive. The PIPointQuery.ParseQuery method has been added to parse queries into tokens for searching.

The new method PIPoint.ReplaceValues has been added to replace values within a time range. PI Data Archive 2016 or later is required. To get values as specific times, the PIPoint.RecordedValuesAtTimes and PIPointList.RecordedValuesAtTimes methods have been added. These methods require the PI Data Archive 2016 or later to take full advantage of the performance gains.

Support for asynchronous method calls has been added with the addition of the following methods:

Related Links
Was this topic helpful?
LikeDislike