Release Note

Contents

Introduction

As of February 1, 2012, Genesys is no longer an affiliate of Alcatel-Lucent; any indication of such affiliation within Genesys products or packaging is no longer applicable. Please see the Genesys website at http://www.genesys.com for more details.

This release note applies to all 8.0 releases of the Platform SDK & Application Blocks for .NET.

• Links in the Contents section enable you to access information regarding a specific release. Releases are listed by version number rather than in date order. For this reason, a recent release may be listed after earlier releases, if the version number is lower. Except when otherwise noted in the information for a specific release, each release includes all of the features and corrections that were introduced for the applicable operating system at earlier dates, regardless of the version numbering.
• The Release Number table lists the supported operating systems for each release at a high level. For more detailed information, see the Genesys Supported Operating Environment Reference Guide.
• The Known Issues and Recommendations section is a cumulative list. It includes information on when individual items were found and, if applicable, corrected.
• The Corrections and Modifications section for each release may list additional issues that were corrected without first being documented as Known Issues.
• The Discontinued Support section is cumulative. It lists functionality that is no longer supported and the release number of the version in which support was discontinued.

Use of Third-Party Software

Genesys follows applicable third-party redistribution policies to the extent that Genesys solutions utilize third-party functionality. For additional information on third-party software used in this product, see the Read Me. Please contact your technical support representative if you have any questions.

Supported Operating Systems

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

The Platform SDK now provides improved stability when connecting to large numbers of HA T-Server pairs. Previously, this scenario could cause an application to stop unexpectedly with a Genesyslab.Platform.Commons.PlatformException: Closing Selector message. (ER# 281099752)

When configured for warm standby, the Configuration Object Model Application Block now behaves correctly after failover. Previously, the application block would throw an InvalidOperationException after failover. (ER# 270982556)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

WarmStandbyService can now correctly reconnect or switch over following an ADDP disconnect. (ER# 269941434)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

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

• Subscribe to Attributes — You can now create a subscription to any attribute in any message (as long as you know the related IDs) by using the AttributeSubscriptionList class and the ConnectionContext interface.

• EspEmail Protocol — The Web Media Platform SDK now includes the EspEmail Protocol, which provides an improved way to handle the submission of web-based e-mail to E-Mail Server Java using the RequestCreateWebEmailIn and EventCreateWebEmailIn messages.

• Extension of Message Server API — An additional structure has been added to EventLogMessage to represent data which had previously been presented as a binary stream.

• Custom Server Protocol — Allows a router to gather information from a custom server (created using this protocol) within a routing strategy, to use when making routing decisions.

• Server-Side TLS — Allows Platform SDK-based servers to secure incoming connections.

• Improved Log Filtering — The new Tag option adds the ability to "wrap" sensitive parts of a log message in pre-defined strings, which can then be used for log filtering.

• Hide Data in Logs — Sensitive data can now be hidden in the Platform SDK logs. For details about dealing with sensitive data in logs, refer to the Using the Platform SDK Log Library for .NET article in your API Reference.

• Warm Standby Application Block Extendibility — The warm standby algorithm utilized by the application block can now be customized.

• Improved platform support — The Platform SDKs now include support for Windows 7.

• A new RegistrationException exception is thrown when a protocol in the Platform SDK encounters registration problems.

• New Methods for KeyValuePrinter Class — The following public methods were added to the KeyValuePrinter class to make printing easier:
  • public string ToString(string key, Object value);
  • public string ToString(string key, Object value, int indent);
  • public void AppendValue(StringBuilder buf, string key, Object value);
  • public void AppendValue(StringBuilder buf, string key, Object value, int indent);

Corrections and Modifications

This release also includes the following corrections and modifications:

The Platform SDK & Application Blocks for .NET now closes connections correctly after an ADDP timeout occurs. (ER# 258400722)

The buffer used to parse XML messages is now the correct length. Previously, some XML messages would fail to parse. (ER# 255101070)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

The Voice Platform SDK for .NET now correctly connects to a primary Nortel T-Server in hot standby HA mode correctly, even after a connection with the backup T-Server has been established. (ER# 261898295)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

The Protocol Manager Application Block can now switch to a TLS connection correctly when using auto-detect mode. Previously, TLS could only be enabled when the connection was in a Closed state. (ER# 247953574)

In Switch Policy Library for .NET, the IsPossible rules for Nortel Meridian switches were updated to allow agent-related actions (Login, Logout, Ready, and NotReady) on a DN of type Position when the agent status for that DN is Unknown. (ER# 247465164)

In Switch Policy Library for .NET, the IsPossible rule now indicates that on-hold calls cannot be released on NEC switches. Previously, this rule incorrectly indicated that such calls could be released. (ER# 248694153)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

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

• The following new subcomponents were added for this release:

  • Routing Platform SDK for .NET — Allows you to write .NET applications that work with Universal Routing Server to ensure that interactions reach the right targets at the right time.
  • Platform SDK Log Library for .NET — Presents an easy-to-use API for creating and customizing Framework-compliant log messages that can be sent to a standard file or to Message Server.
  • Platform SDK Switch Policy Library for .NET — Exposes the policies for all supported switches to developers, offering flexibility in adjusting for switch-specific behavior or adding new switch policies.

  For details, refer to the individual subcomponent release notes.

• Alarm Sending/Buffering Enhancements — The Platform SDK now allows extended attributes to be attached to log messages before submission to centralized log storage. Alarm events can also be automatically buffered for up to 24 hours in the event that the connection with Message Server is lost.

• Access to System Host Data — The Platform SDK now provides access to system host statistics such as CPU utilization and memory usage so that administrative desktops are able to present the data in a unified way.

• Role-based Access — The Platform SDK now exposes access to role capabilities, including the ability to add or modify roles and assign a role to a user.

• Last Logged In — This security feature supports the ability to determine a user's last logged in date and time, as defined by user authentication with Configuration Server.

• XML Metadata — The Platform SDK now provides XML Metadata describing application options for use by Administrative desktops.

• Hierarchical Data Access — Hierarchical multi-tenancy data layers in Management Framework and Configuration Server can now be accessed using the Platform SDK.

• New Management Layer Functionality — The Platform SDK now provides the ability to subscribe to Message Server events that are also buffered until processed.

• Improved OS/Platform Support:

  • Vista Client
  • Citrix XenApp 4.0, 4.5
  • Solaris 10 Container
  • IBM PowerVM

Corrections and Modifications

This release also includes the following corrections and modifications:

KeyValueCollection objects now use the KeyComparer property to specify whether a search is case-sensitive or case-insensitive. This property is set to StringComparer.Ordinal (case-sensitive) by default. (ER# 226176641)

TLS server authentication now reads the Certificate_name property correctly, even if the certificate name received from the server is different than what is set in the client application. (ER# 231170101)

If a host has multiple IPs assigned and an application on that host is using one of those IPs as a local-endpoint, then connections from that application to Genesys Servers will use the first appropriate IP from the list of available IPs for this host given by DNS. (ER# 230570922)

.NET documentation included with the Platform SDKs has been updated to remove incorrect links.

Genesys still recommends checking for and downloading the latest available SDK documentation from the Genesys Developer Zone on a regular basis. (ER# 226399770)

Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Library Subcomponents

Application Block Components

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in the initial 8.0 release of the Platform SDK & Application Blocks for .NET.

• The Management Platform SDK is now able to generate alarms using the new RequestActivateApplicationAlarm, as well as receive notification of incoming alarms from Solution Control Server (SCS).

• The Statistics Platform SDK now provides additional statistics functionality, taking advantage of the full Stat Server protocol. Because of these changes, the Statistics Platform SDK for this release is not compatible with previous versions of the SDK.

  The new Packaged Statistics Platform SDK contains the same functionality that was offered in previous versions of the Statistics Platform SDK. The Packaged Statistics Platform SDK is deprecated, and should only be used to provide backwards compatibility for existing applications.

• The Configuration Platform SDK now returns configuration data as an XDocument to improve usability and presentation, and includes new utilities to make working with delta values easier.

  A deprecated version of the Configuration Platform SDK is also provided with this release. This deprecated SDK returns data using the XMLDocument class (which is supported by .NET Framework 2.0) and can be used to provide backwards compatibility with applications developed using earlier versions of the Configuration Platform SDK.

• The Platform SDKs support new search capabilities introduced in the e-Services Solution.

• The Platform SDKs now support client-side port definition of the client/server connection.

• The Platform SDKs now support .NET 3.5 or higher.

• The Platform SDKs now support Transport Layer Security (TLS) for .NET based applications.

• The Platform SDKs now support TCP/IP version 6 (also known as IPv6).

• The Platform SDK packaging now uses a version-insensitive IP, allowing multiple versions of the SDKs to be installed at one time for development purposes.

• The Platform SDKs now support Windows 2008 Server (the server version of Vista).

• The Platform SDKs now support Microsoft Terminal Service.

• The Platform SDKs now support VMWare virtual platform.

• The Configuration Object Model (COM) Application Block now has the ability to cache COM objects.

• Documentation for the Platform SDKs has been improved and expanded, and now offer a combined API Reference that provides information about all of the SDKs and Application Blocks from a single source. See the Genesys Documentation website for a complete listing of updated documents.

Corrections and Modifications

This release includes the following corrections and modifications that were made between Release 7.6 or earlier releases and the initial 8.0 release:

Shortcuts to the Application Blocks are now handled correctly when multiple versions of the Platform SDK for .NET are installed on a single computer. Previously, shortcuts to different versions of the Application Blocks could be grouped together incorrectly. (ER# 219851833)

Subcomponents in this Release

This release of the Platform SDK contains two types of subcomponents: SDKs and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents

Application Block Subcomponents

Top of Page

Known Issues and Recommendations

This section provides the latest information on known issues and recommendations associated with this product.

Documentation provided with the Platform SDKs is still being improved and enhanced. To ensure you are working with the most correct and comprehensive information, please download the most recent SDK documentation from the Genesys Documentation website.

Shortcuts for the Platform SDK Application Blocks may appear at an incorrect location (under a previously installed instance of the Platform SDK for .NET shortcuts folder) if more than one instance of the Genesys Platform SDKs are installed. (ER# 248860531)

KeyValueCollection currently offers no method for specifying a case-sensitive or case-insensitive search by key. (ER# 226176641)

Some links in the initial .NET documentation included with the Platform SDKs may not work correctly. Download the most recent SDK documentation from the Genesys Developer Zone to fix this issue. (ER# 226399770)

If a host has multiple IPs assigned and an application on that host is using one of those IPs as a local-endpoint, then connections from that application to Genesys Servers might not be successful in the following cases:

• If the local-endpoint IP is specified by host name.
• If the local-endpoint IP being used is a non-DNS IP (such as VMWare, for example).

(ER# 230570922)

If the certificate name received from the server is different than what is set in the client application, then the Certificate_name property is ignored during TLS server authentication. (ER# 231170101)

Top of Page

Discontinued Support

This section documents features that are no longer supported in this software. This cumulative list is in release-number order with the most recently discontinued features at the top of the list.

There are no discontinued features or functions in this release of the Platform SDK & Application Blocks for .NET 8.0.

Top of Page

Internationalization

Information in this section is included for international customers.

There are no internationalization issues for this product.

Top of Page

Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Technical Support website. The following documentation (located on the Developer Documentation CD, the Technical Support website, and the Genesys Documentation website) also contains information about this software. Please consult the Deployment Guide first.

• Genesys Documentation Website - More details about the Platform SDK for .NET, including deployment guidelines and developer information, can be found on the Genesys Documentation website.

• The Platform SDK 8.0 API Reference for the version of the Platform SDK that you are using. This combined guide provides an introduction to the Platform SDKs, together with tips and recommendations about using the Platform SDK to interact with Genesys Servers. It also includes details about the messages, events, data types, and constants defined by each protocol within the Platform SDK.

  Information about the Application Blocks that are packaged with this release of the Platform SDK is also included in the Platform SDK 8.0 API Reference, including tips and suggestions about how to use each application block, along with details about the classes, methods, and properties that are defined by the application block.

Product documentation is provided on the Technical Support website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly) or the Developer Documentation CD.

Note: For the DVD/CD, the New Documents on this DVD/CD page indicates the production date for that disc. Due to disc production schedules, documentation on the Technical Support website may be more up-to-date than what is available on disc immediately after a product is released or updated. To determine the version of a document, check the version number that is located on the second page in PDFs or on the About This File topic in Help files.

Top of Page