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.1 releases of .NET Web API Server and Samples.

• 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 Manual.
• 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 about third-party software used in this product, see the Read Me. Please contact your Genesys Customer Care representative if you have any questions.

Supported Operating Systems

New in This Release

• The underlying Platform SDK libraries are updated to the more recent release 8.1.000.22.

Corrections and Modifications

This release includes the following correction and modification:

The runtime exceptions KeyNotFoundException and IndexOutOfRangeException are no longer produced by functions used in Web API .NET. Previously, when threads in memory tried to access unsynchronized collections, the KeyNotFoundException and IndexOutOfRangeException runtime exceptions occurred and the web application was stopped by IIS. (ESR-10673)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This release contains no new features or functionality.

Corrections and Modifications

This release includes the following correction:

Web API Server no longer fails to connect to backup servers when only primary servers have been added to the application cluster. (ER# 284310487)

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix release of this product. No new features were introduced in this release of .NET Web API Server and Samples.

Corrections and Modifications

This release includes the following correction and modification:

The runtime exceptions KeyNotFoundException and IndexOutOfRangeException are no longer produced by functions used in Web API .NET. Previously, when threads in memory tried to access unsynchronized collections, the KeyNotFoundException and IndexOutOfRangeException runtime exceptions occurred and the web application was stopped by IIS. (ER# 300816819, 301650787)

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.1 release of .NET Web API Server and Samples.

• Support of TLS with Configuration Server, Solution Control Server, Chat Server, Interaction Server, Stat Server, E-mail Server, and Universal Contact Server.
• Client-side port definition with Configuration Server, Solution Control Server, and Message Server.
• New sample named "Chat HA" for working with High Availability Chat Server.
  

Corrections and Modifications

There are no corrections and modifications for this release of .NET Web API Server and Samples.

Top of Page

Known Issues and Recommendations

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

The Web API Server will not connect to backup servers if only primary servers have been added to the application cluster.

Workaround:

Remove the primary server applications from the application cluster and add them to the Web API Server's connection list.

(ER# 284310487)

The .NET Web API Server and Samples is not compatible with E-mail Server version 8.0.1 and earlier.

If E-mail Server version 8.0.0 or 8.0.1 is required, use the 8.0.0 or 8.0.1 E-mail samples. The Email folder of SimpleSamples802 should be populated with the content of the same folder from SimpleSamples80 or SimpleSamples801.

(ER# 261672141)

If an agent is handling a chat session with a customer and a supervisor in a coaching mode joins the session actively, the customer is not notified of that change and therefore cannot see text entered by the supervisor.

To enable customers to see the supervisor's text, replace �if (ei.getUserType() == UserType.Agent)� in the HtmlChatCommand.jsp with �if (ei.getUserType() == UserType.Agent) || if (ei.getUserType() == UserType.Supervisor)�.

(ER# 248217391)

With the cobrowse dynamic start-up page, the credit card types of Mastercard and American Express display as Visa in the Response Live Page. (ER# 241080821)

.NET Web API Server fails to send e-mails that contain large (usually greater than 1 MB) file attachments. (ER# 230646763)

Workaround:

For example, the following entry in web.config allows files that are smaller than or equal to 8 megabytes (MB) in size to be uploaded:

  <httpRuntime
   maxRequestLength=�8192"
   executionTimeout=�600"
  />

During installation, if you set the default-code-page option to a code page not present on the destination server, your selected code page fails to update. In this case, you must manually input the code page value into the file encoding field. However, if you pre-configure your host for the particular local language you want to use (keyboard, language settings, and regional settings all set to your local language in the Windows Control Panel), then the selected code page updates without a problem.

To manually update the code page, use the following workaround.

Workaround:

1. After installation, open IIS Manager.
2. Locate the WebAPIServer801 virtual root and select Properties.
3. Click the ASP.NET tab.
4. Click Edit Configuration.
5. Click the Application tab.
6. Enter desired encoding into the File encoding field. For example, windows-1251 (Cyrillic alphabet).
7. Click OK.

(ER# 106856255)

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. For more information on discontinued support for operating environments and databases, see Discontinued Support in the Genesys Supported Operating Environment Reference Guide.

There are no discontinued features for this product.

Top of Page

Internationalization

Information in this section is included for international customers.

The test tool displays corrupted Tenant names in Korean. (ER# 163994931)

When an e-mail request is sent in a Korean environment while using multiple languages at the same time, some characters may be displayed as ?. (ER# 123328426)

If .NET Web API Server samples for chat use multiple languages, some characters may be displayed as ?. (ER# 123328421)

Top of Page

Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Customer Care website. The following documentation also contains information about this software. Please consult the eServices 8.1 Deployment Guide first.

• eServices 8.1 Deployment Guide describes deployment procedures for all eServices components. It also contains a high-level description of the eServices system, its architecture, and a list of new features in the current release.

• eServices 8.1 User's Guide provides overall information about and recommendations on the use and operation of Genesys eServices.

• eServices 8.1 Reference Manual provides a reference listing of all configuration options and of field codes used in standard responses.

• eServices 8.1 Web API Client Developer's Guide describes the structure of the Web API, explains the Simple Samples, and describes procedures for customizing them.

• For a listing of classes, methods, fields, and constants of the Web API portion of the Web API Server component, see:

  • eServices 8.1 .NET Web API Reference for the .NET Web API
  • The API References of the Platform SDK for the Java-based Web API

• eServices (Multimedia) 8.0 Selected Conceptual Data Models for the UCS Database describes a portion of the Universal Contact Server (UCS) database.

• 8.1 Universal Contact Server Manager Help is a guide to the Universal Contact Server Manager user interface.

• eServices 8.1 Knowledge Manager Help is a guide to the Knowledge Manager user interface.

• Universal Routing 8.1 Interaction Routing Designer Help is a guide to Interaction Routing Designer, including the portion of it that designs interaction workflows and business processes for eServices.

• Universal Routing 8.1 Business Process User's Guide contains step-by-step instructions for using Interaction Routing Designer to design interaction workflows. It also describes the sample business processes supplied with eServices.

• Genesys Desktop 7.6 Help is a guide to using the Genesys Desktop.

• Genesys 8.1 Security Deployment Guide describes the deployment and configuration of some of the security features provided in Genesys software.

• Genesys Events and Models Reference Manual includes a set of basic interaction models, showing the components involved and the event messages sent among them. For authoritative description of the event messages, see the next item.

• The API References of the Platform SDK, which provide the authoritative information on methods and functions for each SDK, including requests and events. The class Message includes all event and request messages.

• eServices Social Media Solution Guide describes deployment and use of the Genesys Social Messaging product.

Product documentation is provided on the Customer Care website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly).

Note: For the DVD, the New Documents on this DVD page indicates the production date for that disc. Due to disc production schedules, documentation on the Genesys Documentation 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