Archive for March 30, 2011

Implementing an Ajax TreeView

The WebClient TreeView advanced control was designed to work with existing Plex Active/TreeView pattern functions with minimum changes to the action diagram. Read the following for the instructions (note this article was authored by Andrew Leggett, Senior Consultant for ADC Austin. He can be reached at

For example, you may want to implement a function that looks like this as a page in a browser.

To prepare an existing Active/TreeView or ShowTree function for WebClient.

  1. Attach the WebClientControls group model as a library to your group model. Note this is a separately licensed model.


2.  You can now inherit from the WebClient/_Abstract.~TreeView function.

3. If you have existing action diagram code to display a TreeView control, the only addition you will need to make is to add a ‘Go Sub TreeView Refresh’ statement at any point where you need to update the control in the browser.  This subroutine behaves similarly to a ‘Put’ statement.  For a new TreeView function, follow the article ‘Implementing a Tree Control’ in the Plex Help.

4. When exiting the function, make sure you exit with ‘Go Sub Terminate’, as this subroutine inherits the code necessary to cleanly dispose of the tree control in memory

5. If you are displaying images for your tree nodes, you will need to make these available to the web application with the following steps: (Note: the SelectedImage property is not currently supported)

6. In Eclipse, your Web project will contain a ‘WebContent’ folder which contains the run-time resources for your web application.  Create a folder directly under ‘WebContent’ and name it ‘images’ (it is case-sensitive).

  • Copy any bitmaps that your application uses to the ‘images’ folder.

  • The web application is case-sensitive, so you need to ensure that the bitmap names match those in your model.  The Plex TreeView uses Name objects scoped to the Scripts function to get the bitmap names; e.g. MyTreeView.Scripts/FNC option NME/Image 1.  The bitmap name is stored in the literal value of the name object.  Compare these names to the bitmaps in your images folder, and rename the files if appropriate.

To see a worked example of the TreeView pattern, download the WXPCourse61 example model.

Visit our booth at the System i Networks Free Virtual Conference

Thursday, April 7, 2011 9:30 a.m. – 5 p.m. ET

Join the CM First and System iNetwork for this FREE one-day event – IBM i Essentials 2011 Virtual Conference. This interactive online event covers a wide range of fundamental topics for IBM i professionals.

Visit the CM First booth for information on WebClient i+, PHP, CA Plex, CA 2E, and more. There will be a free Android tablet computer raffled off to one lucky visitor.

March 2011 Newsletter Published

The March 2011 WebClient newsletter is available at this link.

Highlights of this edition include:

Newsletter Archive of all newsletters and to subscribe

Important WebClient Support Bulletin

WebClient ships with a version of the Plex Java Runtime (ObRun.jar). Currently this is build 43024 for WebClient 1.6.1 and 1.6.2. We generally recommend that customers build their code at this level or higher. Although it is unlikely from a WebClient perspective that problems will result from the use of different ObRun versions, for consistent results we recommend that the ObRun version is kept in sync between Plex development tool and any web projects.

There is a known issue with ObRun 43029, where grid cell control names are not generated in the panel properties resource files. Although WebClient does not use grid cell control names in the shipped templates, to be safe for any customized templates we advise that customers avoid this build. If your application requires this build level or higher for reasons other than WebClient, you can request a patch build from CA Support

If you have any questions on this support bulletin, please open up a support ticket on

WebClient 1.6.2 Service Pack Released

WebClient i+ Developers –

  • WebClient Patch Release 1.6.2 is released. To obtain this release, please login to and select Developer Content and Software Downloads.
  • This release contains bug fixes and updated documentation
  • Important Note: It is our policy to publish product updates as soon as they become available. However, unless you have been specifically advised by product support to upgrade, we do not recommend upgrading without careful consideration of the impacts to your current application. If you have questions, please open a support ticket.

Best Regards,

The WebClient i+ Development Team

© 2013 CM First Group - All rights reserved