Important Notes on Upgrading

Paths of Form Portlet Email Templates

The configuration properties template and confirmationTemplate set in the flow.xml definition file may need adjustments: A path is now either relative to the directory containing the flow.xml file as in

<param name="template">email.vm</param>

or, if an absolute path is specified, relative to the template directory as in

<param name="template">/flow/example/email.vm</param>

File Upload in Wizards

The syntax of the Tcl function ::layout::fileField was altered. Wizards in which this function is used for creating file upload fields, need to be adapted to the new syntax.

For example, the call in the Archive Import Wizard,

::layout::fileField archive "" …

has become

::layout::fileField archive "" [getParam archive.fileName] [getParam archive.ticketId] …

Please note that linklist fields with a minimum size (minSize) not equal to 0 may now be empty if the field is not mandatory.

If you use such a limitation and do not wish to allow for empty lists, please mark the lists as mandatory in the corresponding file formats.

Rails Connector Uses New Javascript Library

The Rails Connector’s edit markers and addons used to be based on the Prototype library. Starting with version 6.7.2, the Rails Connector now uses the jQuery library. Therefore, the Rails Connector now requires the jrail gem (see also Installation Requirements).

Existing Rails applications should activate the jrails integration after installing the gem using this command:

jrails install

Updated Gem Dependencies for the Rails Connector

The latest Rails Connector has some updated gem dependencies. It now depends on Rails 2.3.5, for example. For details, please refer to the Installation Requirements.

Name Shortcut for Rails Connector News Removed

When using the Rails Connector, the News class can no longer be referenced without a namespace. This shortcut was removed to avoid name conflicts. Instead, the class must now be referenced using its fully qualified name (RailsConnector::News).

Rails Connector and Mac OS X

Developers who wish to use a Mac as their development platform for applications based on the Rails Connector 6.7.2 now require Mac OS X 10.6 (Snow Leopard).