Upgrade Guide to Websydian Version 5.7

Introduction

This document describes changes made to the Websydian product that might affect Websydian applications prior to Websydian 5.7 and may require changes to the models or runtime environment.

When upgrading from versions prior to 5.6 the upgrade guides for these versions should be applied before this document is applied.

For more information on what is changed and new features in Websydian 5.7 please read Websydian Version 5.7 - What Is New?.

Pattern Changes in Websydian 5.7

This section describes various bugs that have been fixed in Websydian 5.7. If you previously have run into any of these bugs you might have inserted code to workaround the bug.

When you upgrade to Websydian 5.7 you should remove any code you have inserted to workaround the bug.

Known problem 28641: EventHandlerWithValidation and multiple views

If the EventHandlerWithValidation function was used with more than 1 view in the WebInput variable, errors in the first view were not reported if there were not any errors in the last view.

Remove the code inserted when following the workaround described in Known Problem 28641.

Known problem 24115: Handling of decimal separator - iSeries

Numerical values are parsed correctly no matter what character is used as decimal separator on the iSeries where the Websydian application is deployed.

Remove the code inserted when following the workaround described in Known Problem 24115.

SessionWithLayoutControl - Java

When the path to the HTML template was generated back slash was used as a path separator. In Java the correct separator to use is a forward slash.

Remove the workaround code inserted in the edit point 'Start Extend temlate path' in the PageGenerator function.

PageGeneratorWithErrorList conflicts with RepeatedEventDetection

The two patterns PageGeneratorWithErrorList and RepeatedEventDetection did not work when combined.

This problem has been fixed

Known problem 29162: Sequence of complex and simple elements - TransacXML

The InsertRow function did not insert complex elements correctly if the complex element should appear before a simple element.

Changes to Distributed Websydian Architecture (DWA)

New parameters for Application Service

New parameters have been introduced when launching the Application Server. This means that any startup scripts for the Application Service must be modified so they start the Application Service with the correct number of parameters.

Please read Configure and Start a Websydian Application Service for more information.

New runtime objects

New runtime objects have been shipped with the Websydian distribution. See table below.

Replace the old objects with the new versions and update script files to use the new WsydDwa21.jar file.

Web services and UTF-8 documents

In some scenarios it was necessary to set the property servlet.encoding in the RelayService.prop file to UTF-8 when creating a web service that should respond with XML documents encoded in UTF-8.

This is no longer necessary so the servlet.encoding entry can be removed from the property file.