Release Note

.NET Web API Server and Samples

8.0.x

Genesys Telecommunications Laboratories, Inc. © 2009–2011

Contents

Introduction

Release Number AIX HP-UX Linux Solaris Tru64 UNIX Windows
8.0.210.03 [06/03/11] – General           X
8.0.210.02 [04/01/11] – General           X
8.0.200.02 [12/17/10] – General           X
8.0.100.07 [04/01/10] – General           X
8.0.000.06 [10/30/09] – General           X
8.0.000.05 [07/27/09] – General           X

Link to 7.6 Product Release Note (Cumulative)
Known Issues and Recommendations
Discontinued Support
Internationalization
Additional Information


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.genesyslab.com for more details.

This release note applies to all 8.0 releases of .NET Web API Server and Samples.

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.


Release Number 8.0.210.03 [06/03/11] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

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 corrections or modifications.


.NET Web API Server no longer loses its ADDP connection to Local Control Agent (LCA) after a restart of Framework’s host. Previously .NET Web API Server lost this connection repeatedly in the following scenario:

  1. Configuration Server, Solution Control Server, and Message Server are running on one host, .NET Web API Server is running on another host.
  2. Framework’s host restarts.
(ER# 271125829)


Top of Page


Release Number 8.0.210.02 [04/01/11] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of .NET Web API Server and Samples.

Corrections and Modifications

This release includes no corrections or modifications.

Top of Page


Release Number 8.0.200.02 [12/17/10] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of .NET Web API Server and Samples.

Corrections and Modifications

This release includes no corrections or modifications.

Top of Page


Release Number 8.0.100.07 [04/01/10] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of .NET Web API Server and Samples.

Corrections and Modifications

This release includes no corrections or modifications.

Top of Page


Release Number 8.0.000.06 [10/30/09] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. No new features were introduced in this release of .NET Web API Server and Samples.

Corrections and Modifications

This release also includes the following corrections and modifications:


There is no longer a problem with the webapistats.cfg link in the Statistical information sample. (ER# 230763861)


Web API Server now works correctly when the ADDP protocol is enabled for Configuration Server and/or Solution Control Server and/or Message Server. (ER# 229876907)


Checking the chat default queue option no longer produces an incorrect result description about an option being empty or undefined. (ER# 230646795)


Top of Page


Release Number 8.0.000.05 [07/27/09] – General

Supported Operating Systems
New in This Release
Corrections and Modifications

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features were introduced in the initial 8.0 release of .NET Web API Server and Samples.

Corrections and Modifications

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


In this release, on the ChatSelfTest page in the Result Description for Checking chat WebAPI port settings, the webapi-port option is now used instead of the flex-disconnect-timeout option. (ER# 217046611)


In this release, .NET Web API Server can now gather predefined statistics from Stat Server installed on a Windows operating system. (ER# 217706766)


In this release, .NET Web API Server now writes about the reconnection to the backup message server to the event log. (ER# 211277576)


Top of Page


Known Issues and Recommendations

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


On Firefox, for all chat samples, scrolling for multiline messages is incorrect: only the first lines or the last lines display. (ER# 270637688)

Found In: 8.0.210.02 Fixed In: 

On Firefox, there are the following issues with display of the samples when the text size (DPI) is larger than the default:

As a workaround, set the text size to default. (ER# 270291895)

Found In: 8.0.210.02 Fixed In: 

There are the following issues with display of the samples on Internet Explorer 6 and 7, and on versions of Firefox older than 3.6.15:

(ER# 270485722)

Found In: 8.0.210.02 Fixed In: 

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

Workaround:

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)

Found In: 8.0.200.02 Fixed In: 

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.

Workaround:

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)

Found In: 8.0.100.07 Fixed In: 

The virtual root structure is not created during the installation of Web API Server .NET with IIS 7 Web Server.

Workaround:

  1. In IIS Manager, navigate to the Default Website.
  2. Add a virtual directory and name it WebAPIServer801.
  3. Point this virtual root to the Web API Server folder.

(ER# 241660687)

Found In: 8.0.100.07 Fixed In: 

After installation, Web API Server version 8.0.1 is not registered as a .NET Application in IIS 7.

Workaround: To register this application, right-click the WebAPIServer801 virtual directory and select Convert to Application.

(ER# 247074047)

Found In: 8.0.100.07 Fixed In: 

The web browser might return an error while clicking on the webapistats.cfg file link in the Statistical information sample if the .cfg extension is not specified in the Web server MIME types.

Workaround:

To manually add the cfg MIME type to IIS:

  1. Select Default Web Site and bring up the Properties dialog box.
  2. Select the HTTP Headers tab.
  3. Under MIME types, click the MIME Types button and select New Type.
  4. Type .cfg in the Extension field and text/plain in the MIME type field, then click OK.

(ER# 230763861)

Found In: 8.0.000.05 Fixed In: 8.0.000.06

.NET Web API Server might not function correctly when ADDP protocol is set with any or all of the following:

(ER# 229876907)

Found In: 8.0.000.05 Fixed In: 8.0.000.06

While checking the chat default queue option, an incorrect result description similar to the one shown below might be displayed on the Chat self-test page:

"default" option from "endpoints:xxx" section empty or undefined. Please create it and give a value.

Workaround:

Change i < 110 to i < 150 in the TestTool80\ChatSelfTest.aspx.cs file. Use 150 or a larger number so that the number is greater than the tenant’s DBID:

bool bFoundOne = false;
for (i = 101; i < 110; i++)

{
        strOption = LoadBalancer.getOption(strAppName, "endpoints:" + i.ToString(), "default", "");
        if (strOption != null && strOption != "")
        {
              htOneStep = new Hashtable();
              htOneStep.Add(WebApiSelfTestInfo.SELFTEST_STEP_NUMBER, iStep.ToString("D2") + "." + iSubStep.ToString("D2"));
              htOneStep.Add(WebApiSelfTestInfo.SELFTEST_STEP_DESCRIPTION, "Checking chat default queue option.");
              htOneStep.Add(WebApiSelfTestInfo.SELFTEST_RESULT_DESCRIPTION, "\"default\" option from \"endpoints:" + i + "\" section has \"" + strOption +                 "\" value.");
              htOneStep.Add(WebApiSelfTestInfo.SELFTEST_STEP_RESULT, "pass");
              htSteps.Add(iStep.ToString("D2") + "." + iSubStep.ToString("D2"), htOneStep);
              iSubStep++;
              bFoundOne = true;
         }
}

(ER# 230646795)

Found In: 8.0.000.05 Fixed In: 8.0.000.06

Because of technical limitations, Test Tools pages work only in Internet Explorer browser versions 6.0–8.0. They are XML/XSL web-based applications and are not supported by all browsers. (ER# 231119851)

Found In: 8.0.000.05 Fixed In: 

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

Workaround:

Add the following code to <system.web> in the web.config file in the web application’s folder, and adjust it with the necessary values.

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"
  />
Found In: 8.0.000.05 Fixed In: 

If changes have been made to tenants in Configuration Manager (for example, names, DBIDs), LoadBalancer might not update this information on startup when it reads information from Configuration Server.

Workaround:

Restart .NET Web API Server if any information related to tenants (for example: names, DBIDs) has been changed in Configuration Server. (ER# 168180935)

Found In: 7.6.000.07 Fixed In: 

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)

Found In: 7.5.000.03 Fixed In: 

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.


Windows 2000 (IIS 5) is no longer supported.

Discontinued As Of: 8.0.000.05

Microsoft .NET 2.0 is no longer supported.

Discontinued As Of: 8.0.000.05

Top of Page


Internationalization

Information in this section is included for international customers.


Tenant names in Korean are corrupted on the Loadbalancing page. (ER# 114085802)


Time formats in Korean are corrupted on the Loadbalancing page. (ER# 114085804)


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 Technical Support website. The following documentation also contains information about this software. Please consult the Deployment Guide first.

Product documentation is also provided on a Documentation Library DVD, which is produced monthly. The New Documents on this DVD page on the DVD indicates the DVD production date. Because the DVD is produced monthly, documentation on the Technical Support website may be more up-to-date than that on the DVD. To verify the latest version of a document, check the version number, located on the second page in PDFs and on the "About This File" topic for Help files.

Top of Page