Jump to: navigation, search

8.5.000.10

Platform SDK for .NET Release Notes

Release Date Release Type Restrictions AIX HP-UX PA HP-UX IPF Linux Solaris Windows
10/09/14 General X

Helpful Links

Releases Info


Product Documentation

Platform SDK

Genesys Products

List of Release Notes

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of Platform SDK for .NET.

  • Extended List of Managed Connection Configuration Options - Dynamic update support was added to more protocol configuration options.
  • New Key-Value Binding for ESP-based Protocols - Platform SDK now includes an improved internal feature to convert ESP messages into Platform SDK classes and vice versa. This provides increased performance and decreased CPU usage when working with ESP protocols, makes support for ESP-based messages more convenient, and allows clearer algorithms than in previous implementations.
  • Configuration Server Single Sign-On - Platform SDK now supports the Single Sign-On implementation for Configuration Server, based on Kerberos. This allows users to authenticate seamlessly on Platform SDK applications.
  • Configuration Server Localized Values - Platform SDK now detects Configuration Server multi-language mode and includes protocol elements that support localized object names and option values in Configuration Server, allowing applications to make use of the localized configuration data.
  • Deprecated Application Blocks (Message Broker and Protocol Manager) - These Application Blocks were deprecated in previous releases of Platform SDK and must not be used for new development. Existing applications should consider removing them or adopting the full source code, which is available. Additionally, the Configuration Object Model (COM) Application Block no longer uses the Message Broker Application Block.
  • Improved Exceptions on Open and Close Operations - More descriptive exceptions and detailed documentation have been introduced for the open and close protocol operations, allowing you to apply better error handling strategies in Platform SDK applications. All changes introduced are backwards compatible; newly-introduced exceptions are subclasses of the exceptions previously thrown. Most exception messages have been kept identical, although this is not guaranteed in all cases.
  • Friendly Reaction to Unsupported Messages - Platform SDK applications can now receive newly-introduced, unsupported messages and attributes. Previously, unsupported messages and attributes only raised protocol error events or log warnings.
    This allows Platform SDK applications to incorporate the latest server features without needing to wait for a new release of Platform SDK or when upgrading Platform SDK is problematic.
  • New Interaction Server Protocol Messages - The Interaction Server Protocol includes new messages, defined by the latest Interaction Server releases. In particular, RequestCancelInvite allows you to cancel an offered transfer or conference, and RequestAgentState allows you to obtain an agent state after reconnecting.
  • Asynchronicity of Protocol Procedures - Internal protocol mechanisms have been enhanced to be more asynchronous and less blocking, improving the responsiveness of Platform SDK applications. This includes the handshaking, closing, and DNS lookup procedures.
  • Retired Components:
    • Deprecated .NET Configuration Protocol - All .NET Platform SDK applications should use the current implementation of the Configuration Protocol.
    • Deprecated Packaged Statistics Protocol - All Platform SDK applications should use the current implementation of the Stat Protocol.
    • URS Protocol - This protocol has been reserved for internal purposes only.
    • Switch Policy Library - This library has been reserved for internal purposes only.
    • DB Server Protocol - This protocol has been retired, as the DB Server component has been retired.
Tip
Note on Packaging Starting with release 8.5.0, common interfaces for the Message Broker Application Block and Configuration Object Model (COM) Application Block have been moved to an individual Genesyslab.Platform.ApplicationBlocks.Commons.dll file.

Corrections and Modifications

This release also includes the following corrections or modifications:


To provide more accurate error handling when exchanging messages with a server, Platform SDK now includes ChannelClosedOnRequestException. This exception is created when a channel is closed while executing a request method. (PSDK-7133)


The ConfEvent class has been extended with a new UnsolicitedEventNumber public property, which exposes the event ID for unsolicited notification events. (PSDK-7076)


It is now possible to change the version of TLS being used on the client or server side. This feature is enabled by using application configuration file, as shown below:

<configuration>
  <appSettings>
    <add key="DefaultClientTLSVersion" value="TLS12 , SSL3"/>
    <add key="DefaultServerTLSVersion" value="tls11"/>
  </appSettings>
</configuration>

This feature can also be accessed through the PsdkCustomization.TLSServerVersion and PsdkCustomization.TLSClientVersion properties. (PSDK-7051)


Platform SDK now checks for the existence of a client certificate, when that certificate is required by the configuration. (PSDK-7044, PSDK-7169)


Configuration SDK no longer includes Configuration Information XML data without the Configuration Protocol namespace declaration. (PSDK-7041)


The ChannelClosedEvent has been extended with the HasUnsentBytes property, which indicates whether any unsent bytes remain. (PSDK-6932)


T-Server High Availability connections have been extended to support client-side port binding for the backup server connection (using the backup-transport-port connection option). (PSDK-6927)


Platform SDK has consolidated access to app.config parameters by using the PsdkCustomization static class. (PSDK-6923)


Platform SDK now overloads the Close method with an optional boolean parameter. Setting this parameter to true closes a channel immediately, without waiting for all data to be sent. (PSDK-6761)


ADDP trace information has been changed based on ADDP specifications. (PSDK-6625)


Platform SDK has overloaded attribute subscriptions with a subscription type parameter. When this parameter is set to AttributeSubscriptionType.Raw, your application can use an instance of the AttributeRawValue class which contains data about the attribute type and part of the binary network stream. (PSDK-6611)


Conversion of dates to string values now works correctly. Previously, this conversion could return incorrect results if using some non-standard calendars such as Arabic. (PSDK-7181)


Platform SDK has changed its handshake with Stat Server in order to inform Stat Server about extended client capabilities. This allows Stat Server to send extra data to correctly fill in the DnStatusEx structure. (PSDK-7167)


Platform SDK now correctly returns asynchronous operation state information due to fixed logic of events and asynchronous callbacks. (PSDK-7028)


ConfServerEnumDescription.GetDescription(Type enumType, int value) now returns the correct enumeration descriptions. (PSDK-6992)


AlarmDescriptionCodec and the serializer now correctly supports connection encoding and printing with the ToString() method. (PSDK-6906)


The Message Server protocol has been updated to better support string encoding. (PSDK-6887, PSDK-6851)


This page was last edited on February 12, 2015, at 16:25.
Comments or questions about this documentation? Contact us for support!