Isomorphic Software Logo SmartClient™ SDK Release Notes
Version v9.1p_2021-05-18/AllModules Deployment (2021-05-18)


SmartClient provides an open DHTML/Ajax client engine, rich user interface components, and metadata-driven client-server databinding systems, for rich GUI, zero-install web applications. Whether you are upgrading from an earlier release, or exploring SmartClient for the first time, these notes will help you to install and use this release more quickly and effectively. Please take a few minutes to review this file.

SmartClient version 9.1

Please see the Isomorphic Blog for an overview of the latest set of features introduced by this release.

See the change log for a more extensive list of changes.

See below for details of previous releases.

Quick Start

The SmartClient SDK distribution includes an embedded application server and database engine for rapid, stand-alone development and evaluation. To get started quickly:
  1. Download and install the Java 2 Runtime (JRE or SDK) 1.4+ if necessary. (Mac OS X users note: JDK 1.4+ is already installed on your system)
  2. Start the embedded server by running start_embedded_server.bat (Windows), .command (MacOSX), or .sh (*nix).
  3. Open the open_ISC_SDK_from_server shortcut (Windows/MacOS) or open a web browser and browse to http://localhost:8080/index.html (all systems).
  4. Create a bookmark or favorite in your web browser to the URL javascript:isc.showLog(), for easy access to the SmartClient Developer Console and integrated SmartClient Reference.

The SmartClient Quick Start Guide (PDF format) is your best starting point for an overview of the SmartClient SDK, system, and capabilities. This guide also covers common installation and configuration issues.

The SmartClient Reference is the central reference and usage documentation for SmartClient developers.

Supported Clients

SmartClient v9.1p_2021-05-18/AllModules Deployment applications run in the following standard web browsers:
As well as the following mobile device web browsers:
As new browser versions are released, Isomorphic evaluates the stability of the new browser and may announce official support, sometimes with patches or special settings required to work around browser flaws.

Support is available for earlier browser versions for customers with support contracts. Please contact Isomorphic for details.

Supported Servers

SmartClient v9.1p_2021-05-18/AllModules Deployment server-side components require a Java Servlets 2.3 compatible server (complete list here).

SmartClient .zip and .tar.gz packages include an embedded Tomcat server for rapid stand-alone development, but SmartClient is also tested and supported on BEA WebLogic, IBM WebSphere, Oracle iAS, Sun AS, Caucho Resin, Mortbay Jetty, and JBoss servers. SmartClient .war and .ear packages without Tomcat are provided for deployment in existing server environments. See the Server Installation Notes for server-specific configuration and tested versions.

The SmartClient SDK includes an embedded HSQL database for rapid prototyping and evaluation using the SmartClient object-relational connector. This connector is also tested against DB2, Oracle, SQL Server, MySQL, PostgreSQL, and Firebird databases. See the Server Installation Notes for database-specific configuration and tested versions.

New features in prior SmartClient releases

For new features in prior SmartClient versions greater than 8.3, please see the Isomorphic Blog.

What's New in 8.3

SmartClient version 8.3 is a major upgrade from 8.2. It contains a lot of new features, extensive bug fixes and stability / performance enhancements as well as various changes to take full advantage of new HTML5 / css3 features (while maintaining backwards compatibility for older browsers that do not support these features).
A brief overview of the major changes:

What's New in 8.2

SmartClient version 8.2 contains a number of new features, enhancements and bug fixes from the previous SmartClient release.
A brief overview of the major changes: See the change log for a more extensive list of changes.

What's New in 8.1

SmartClient version 8.1 is a significant upgrade from 8.0, containing powerful new features and a wealth of bug fixes and general enhancements. A brief overview of the major changes: See the change log for a more extensive list of changes per release.

What's New in 8.0

8.0 is another monster release, with spectacularly powerful new features and a gorgeous look & feel refresh. The following features have been added:

What's New in 7.0

What's New in 6.5

What's New in 6.0

What's New in 5.7/5.7.1

What's New in 5.6

SmartClient 5.6 has the following major themes. See below for a detailed list of changes.

What's New in 5.5.1

SmartClient 5.5.1 is a maintenance release with small feature additions and documentation updates.

What's New in 5.5

SmartClient 5.5 implements the following themes and features:

1. SmartClient SDK Explorer

This small SmartClient application replaces the old SDK homepage with an interactive, window-based launcher for SmartClient developer resources. To use the SDK Explorer:

The source code for this application is located in index.html and docs/resources/, with some comments for the curious.

2. Rich look & feel

SmartClient GUI components and services have been broadly enhanced to support a range of new visual effects and customized themes, including:

The "SmartClient" theme has been upgraded to take advantage of these new features. This skin is now applied to the SDK Explorer, Demo Application, and Hello World examples. If you are interested in creating your own rich GUI themes, start by examining load_skin.js and skin_styles.css in isomorphic/skins/SmartClient. Check with technical support for the status of undocumented skinning interfaces.

The skinning interfaces will be documented separately in an upcoming release. For more information on the relevant APIs in this release, search the SmartClient Reference for the terms "edge", "shadow", "icon", or "src".

Note: The old "SmartClient" theme has been renamed "fleet", and is still available in isomorphic/skins/.

3. Animation effects

SmartClient visual components now implement a wide range of animation effects, to increase usability and improve user experience. For live examples of many of these effects, see SDK Explorer > Examples > Animation. The SDK Explorer itself demonstrates several window animation effects (expand, collapse, flash, and minimize).

To explore all SmartClient APIs related to animation, search for "animat" in the SmartClient Reference.

4. Background resource loading

In addition to background data operations and remote procedure calls, SmartClient provides interfaces for background loading of: without reloading your entire application. For more information, see the SmartClient Reference entries for: Simple usage examples are also provided in examples/uiLoading/.

5. Client-side XML/WSDL integration

SmartClient now provides easy interfaces to consume and process XML resources directly in the web browser, including: For more information, see the SmartClient Reference entries for:

Simple usage examples, including client consumption of RSS feeds, are provided in examples/dataBinding/. XML loading and XSLT transformations are also provided directly under the XML tab of the SmartClient Developer Console.

Note: These capabilities are not currently available in MacOS Safari web browsers.

6. Rich form controls

SmartClient 5.5 provides a collection of enhanced form controls, including:

ComboBoxItem, PickTreeItem, and SpinnerItem controls are used in the SmartClient Demo App in this package.

Please refer to the SmartClient Reference for more information on these new controls.

7. DataSource operation bindings

SmartClient DataSource objects now support custom bindings at the operation level. Each DataSource operation (Fetch, Add, Update, Remove) may be bound to a different WSDL operation, XML feed, or server object/method. For detailed documentation, see the SmartClient Reference entries for:

For an overview of all DataSource integration options, see the Client-Server Integration topic

8. Direct Method Invocation

SmartClient now provides a direct method invocation (DMI) path for server integration. DMI enables you to bind DataSource operations and RPCRequests directly to methods or attributes of your server objects. For detailed documentation, see RPC > DMI in the SmartClient Reference. This documentation also references the DMI code examples in:

Other features

In addition to the core feature areas listed above, SmartClient 5.5 provides an assortment of enhancements including:
  1. End user application layout with SectionItem and SectionStack components — see examples/demo_app/demo_app_JS_dragPanes.jsp for example SectionStack usage
  2. Flexible back button support — see examples/components/backButton.html for usage
  3. Deeper Struts integration — see examples/struts/ for integration of SmartClient Ajax form validation with existing ActionForms
  4. Modular Ajax client — separate Ajax client modules for independent loading of standard capabilities (Core, Foundation, Containers, Forms, Grids, DataBinding), advanced options (Analytics, FileLoader, RealtimeMessaging) and custom feature packages
  5. Resource preloading & caching — using the FileLoader service of the optional SmartClient Network Performance module

Sneak Preview: Visual SmartClient

This release also includes a "sneak preview" of the in-development Visual SmartClient application builder. You can launch this browser-based development tool from SDK Explorer > Tools > Visual Builder. This Visual SmartClient preview provides: Note: This preview is provided for evaluation only. Licensing and support of the Visual SmartClient tools are not yet formalized.

Contact Us

If you have any questions, comments, or requests, please feel free to contact the SmartClient product team: We welcome your feedback, and thank you for choosing SmartClient.

©2013 and beyond Isomorphic Software, Inc.  All rights reserved.  Your use of this software is subject to the License Agreement. Isomorphic Software, SmartClient, and all Isomorphic-based names and logos that appear herein are trademarks or registered trademarks of Isomorphic Software, Inc. All other product or company names that appear herein may be claimed as trademarks or registered trademarks of their respective owners. This product includes software developed by the Apache Software Foundation ( This product includes Hypersonic SQL.