Archive for September 27, 2010

WebClient Runtime Framework Explained

At application runtime, your WebClient application operates under the control of the WebClient i+ Server, also known as the WebClient i+ Runtime Framework. The WebClient i+ Runtime Framework is implemented as an extension of a standard J2EE Servlet, and provides all the services necessary to deploy your WebClient application as secure, high performance web applications. The servlet model is powerful – fast performance and ease of use make it the architecture of choice over older mechnisms like CGI. For example, servlets can be utilized in high performance, load balanced configurations utlizing multiple web server instances

The WebClient Runtime Framework comes in two editions – the ADC Server edition and the Websydian Server+ edition. There is no difference between the editions, except that the Websydian edition is compatible with WSE applications and can run classic Websydian applications.

The WebClient i+ Runtime Framework consists of the following services:

CA Plex Application Connection

The WCi+ server connects the browser Ajax presentation layer to the business logic generated from your CA Plex action diagrams. For example, user interactions like right-clicking on a grid or selecting a value from a combo box are communicated as events to the CA Plex applications. And corresponding, action diagram statements that affect the presentation layer like updating values or refreshing the grid are communicated to the browser.

Session Management

As is standard for web applications, the WCi+ server creates and manages sessions for each web site user. Session tracking is a mechanism that is used to maintain state about a series of requests from the same user (that is, requests originating from the same browser) across some period of time. Typical session data that can be of interest is the authenticated user (if any), the URL used to start the web application, the session id, method (GET or POST), query parameters, etc. For more information on tracking sessions in WebClient, please visit this blog post:

The WCi+ server also manages session timeouts. For more information on setting inactivity timeouts, please visit this wiki page:

Logging and Tracing

The WCi+ Server logs application events of interest, including errors. See the setting for details. The log can be configured to output performance metrics, which is useful when optimizing response time of your web applications. See servlet.statistics.level in the documentation for more details on this.

WCi+ can also display specific error pages when an error occurs, via the servlet.errorpage.url setting.

Calling WebClient Applications from an External Application

The WCi+ server can respond to requests to show web pages from external applications or packages, also called deep linking. With deep linking, parameters can also be passed into the web request. See the user manual for more information.


The WCi+ Server manages the licensing process, tracking how many concurrent users are logged in against the tier of server you have purchased. If you exceed the number of users you have licensed, error messages will be generated in the log.



WebClient Advanced Controls Explained

The latest release of WebClient contains a new optional pattern library with advanced Ajax web GUI control patterns. The two principle patterns released with WebClient 2010 (1.6) are ~TreeView and ~FlexGrid. ~TreeView enables your web application user to visualize hierarchies via a tree of nodes. Each node can have both text and image, and the nodes can be interactively expanded and contracted. ~TreeView can be used in a variety of business application scenarios: common examples include application menus, product bill of materials, organization charts, and Microsoft Outlook style interfaces. ~FlexGrid is advanced grid control pattern that gives the developer more control over the display and entry of tabular data than the standard CA Plex WinWidgets style grid. Using FlexGrid, you can programmatically set the color and font for individual cells without using states, add columns and rows dynamically, add images to cells, and more. This style of presentation is especially useful in creating spreadsheet-like applications, or in developing scheduling applications where there are not a fixed number of columns to model in the CA Plex panel designer.

TreeView Details

TreeView pattern inherits from and is based on the ACTIVETreeView pattern. For detailed information on constructing hierarchies, consult the CA Plex pattern documentation.

Implementation is straightforward, simply inherit from the ~TreeView pattern

Here are some examples of web trees:

FlexGrid Details

The ~FlexGrid pattern inherits from and is based on the ACTIVEFlexGrid pattern. For basic information on FlexGrid, consult the CA Plex documentation. However, with the WebClient implementation you have much more functionality available to you that you have in the ActiveX version of the control.

Implementation is straightforward, simply inherit from the ~FlexGrid pattern

There is also a more complex pattern called ~ExtendedFlexGrid. Here is a list of operations available:

Here is an example FlexGrid on the web:


More advanced controls will be added in upcoming WebClient releases. For example, FileOpen, ProgressBar, ListView, RichTextEdit and Slider patterns are all under consideration for development. Customers of the WebClient Advanced Controls pattern library will automatically get these new patterns as they become available. If you have an advanced control you would like to see supported, please drop us a note to

Upcoming WebClient Events

WebClient will be on display at these upcoming regional CA Technologies events. Join us there to see the latest version of WebClient, as well as learning about other new CA Plex and CA 2E technologies. You can click on the links below to learn more and register for Chicago and Cincinnati. For the European events, please contact your local reseller.

New Feature Survey – Help Needed

Please help us plan the next release of WebClient i+ for CA Plex. You can do this by responding the release planning survey at this link.

All responses will be considered, but customers will be given priority. If you are a customer, please include your contact information at the end of the survey.

New Licensing Bulletin

The latest version of WebClient contains some licensing changes. Please refer to the information below for more information.

Model Licensing

When you upgrade your models to WebClient 2010/1.6, you will need to obtain new CrypKey model licenses after the 30 day grace period has expired. If you are a licensed customer, please open up a support ticket with your group model site codes and a license key will be provided. If you are an evaluation customer and need to evaluate for greater than 30 days, please contact sales@adcaustin,com or your local reseller for an extended key.

The same procedure applies to the new advanced controls library, for TreeView and FlexGrid.

ADC Server Licensing

There is a no-charge 10 connection server that ships with WebClient. To activate the free license, please blank out the following entries in your file:

  • tlicensingserver.licensefile
  • licensingserver.ipaddr
  • licensingserver.tcpport

To obtain paid, production server license – please open up a support ticket on

Websydian Server+ Licensing

There is no change to Websydian Server+ licensing

© 2013 CM First Group - All rights reserved