Version 7.0rc2/SDK Development Only (2009-05-30)
|
SmartClient™ SDK Release Notes
Version 7.0rc2/SDK Development Only (2009-05-30) |
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.
smartclientSDK
smartclientRuntime
Please note that these directory names have changed from the isomorphicSDK and
isomorphicRuntime directories in the previous separate packages. You may need to
update automated integration scripts or paths that rely on the previous top-level directory names.
<isomorphic:loadISC> tag, no changes should be required. If
you load the SmartClient system by explicitly including:
isomorphic/system/Isomorphic_SmartClient.js
in your pages, you should now include:
isomorphic/system/modules/ISC_Core.js
isomorphic/system/modules/ISC_Foundation.js
isomorphic/system/modules/ISC_Containers.js
isomorphic/system/modules/ISC_Grids.js
isomorphic/system/modules/ISC_Forms.js
isomorphic/system/modules/ISC_DataBinding.js
SectionHeader styles and controls have been updated in all skins. These changes
affect the SectionStack and SectionItem components. The updated
SectionHeader controls take their images from [SKIN]SectionHeader/,
not [SKIN]TreeGrid/, by default.ListGrid components with
showFilterEditor:true has been re-skinned to use an icon only, with normal and rollover
states.accessKey attribute which allows
the user to focus on the widget in question via a keyboard shortcut.[accessKey].
This differs from all other supported browsers (including earlier versions of Mozilla) where the
key-combination is Alt+[accessKey].accessKey attribute.
isc.Timer.setTimeout()
and isc.RPCManager.sendRequest().
XMLTools class) are not available in Safari web browsers older than version
3.0.3. Current alternatives include using Firefox on MacOS, or processing XML on the
server. If you require XML processing capabilities in these older Safari web browsers, please contact
Isomorphic.
Also note that enabling RPC tracking (in the RPC tab of the DeveloperConsole) causes your application to keep extra state, increasing memory usage. This happens regardless of whether the Developer Console is open or not. This functionality is disabled by default. If you use it, be sure to turn RPC tracking off by unchecking the "track RPCs" checkbox in the RPC tag when you're done with your debugging.
Slider component was enhanced in 5.7b2 to support separate event handling paths for valueChanged() calls during a drag interaction versus at the end of a drag interaction. valueChanged() is now called twice (before and after mouseup) with the final value from a drag interaction. To detect whether the value has changed due to an ongoing drag interaction, call the new slider.valueIsChanging() method inside your valueChanged() handler. You may choose to execute temporary or partial updates while the slider thumb is dragged,
and final updates or persistence of the value in response to the other events.
The source code for this application is located in index.html and docs/resources/, with some comments for the curious.
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/.
To explore all SmartClient APIs related to animation, search for "animat" in the SmartClient Reference.
HTMLFlow and HTMLPane componentscontentsURL, setContentsURL(), and contentsType interfacesViewLoader componentevalResult and evalVars attributes of RPCRequestexamples/uiLoading/.Client-Server IntegrationData Binding > Web Service BindingData Binding > WebServiceData Binding > Client-side Custom DataBindingData Binding > DataSource (group xmlBinding)Data Binding > DataSource > OperationBindingData Binding > XMLToolsSimple 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.
SectionItem - a divider control for "accordion" formsComboBoxItem - a dropdown control with filter-on-keypress capabilityPickTreeItem - a hierarchical selection controlSpinnerItem - a numeric control with increase/decrease buttonsSliderItem - the draggable Slider component, now supported in formsComboBoxItem, 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.
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:Client-Server IntegrationData Binding > DataSource > OperationBindingData Binding > Client-side Custom DataBindingData Binding > XJSONDataSourceFor an overview of all DataSource integration options, see the Client-Server Integration topic
RPC > DMI in the SmartClient Reference. This documentation also references the DMI code examples in:examples/server_integration/generic_rpc_operationsexamples/server_integration/custom_datasource_operationsSectionItem and SectionStack components - see examples/demo_app/demo_app_JS_dragPanes.jsp for example SectionStack usageexamples/components/backButton.html for usageexamples/struts/ for integration of SmartClient Ajax form validation with existing ActionFormsFileLoader service of the optional SmartClient Network Performance module