timezoneOffset parameter from the
BuiltinHandler.suspendInstance command to
BuiltinHandler.logon so it can be stored in the session.SuccessLocation parameter is
{_HTMLDir_}/forms/ProcessStarted.html.Cache-Control: no-cache HTTP header
was overwritten in the Web Client's responses.
transferItem command when using the EmailHandler sample.com.ibm.workflow.servlet.client.MonitorHandler
into the servlet core. You must no longer specify it in the
CommandHandler section of WebClient.properties.WebClient.properties which determines if the
Web Client owns (that is, creates and invalidates) the
HttpSession objects it uses to store session information.WebClient.properties for Application servers that
do not support querying this configuration information through the
servlet API. The DocumentRoot setting should also be
used if the Application server used does not support separate
document roots for each Web application.webpages/forms/ForceFinish.jsp and
webpages/forms/ForceRestart.jsp files to confirm
force finishing or force restarting work items and to be prepared for
future extensions where container data can be specified for these
commands.PropertiesViewer.jsp.JSPViewer class. This feature will
catch 'no session' exceptions and instead of returning the error to the
user, remember the command that caused this exception, send a logon page
and -- if the logon was successful -- execute the remembered command. This
is useful when the HTTP session expired or when you want to invoke
Web Client commands from external URLs (for example, email - see
EmailHandler).NoSessionException.
If credentials are present, the Workflow session will be established
transparently.ViewerSelectionHandler sample shows how onLogon()
can be used to set up different Viewers depending on the client
browser.BuiltinHandler.transferWorkItem().Viewer.transferWorkItemResponse().BuiltinHandler.deleteWorkItem().Viewer.deleteWorkItemResponse().ApplicationContext.persistentOidOfProcessInstance().ApplicationContext.persistentActivityInstance().WebClient.properties file.ListViewer.jsp that only showed up
with the Netscape browser.Servlet.properties to
WebClient.properties.JSPViewer.{_WorkitemName_} for
transferItem to {_ItemName_}.PropertiesViewer.jsp.ListViewer.jsp.PropertiesViewer.jsp.BuiltinHandler.doWorkItemActionThroughActivity()
and Viewer.doWorkItemActionThroughActivityResponse()
methods.MonitorHandler to no longer use a tmp
directory. This fixes the bug that monitors for objects whose OIDs
contains a '/' character could not be displayed.checkoutWorkItem
and createAndStartInstance commands.WebClient.properties file.checkOutWorkItem request.PropertiesViewer.jsp.<MQWFDir>/WebClient/webpages/images/icons must now be all
lowercase like the shipped default images.step1/GroupWorkListViewer.NCollectCreditRequest.jsp
sample.<MQWFDir>/smp/java/WebClient
to <MQWFDir>/smp/WebClient.DefaultViewer section of
Servlet.properties become obsolete:
HTMLDir setting in Servlet.properties.MonitorHandler.JSPViewer now also respects the enableXXXList settings
in Servlet.properties.DefaultViewer section in Servlet.properties.ClientException.JSPViewer's worklist.JSPViewer that forms for processes were displayed although
no input data was required.CommandHandlerAdapter sample that handlers
listed first were not necessarily called first.ViewContext class to
RequestContext to be consistent with the other context
classes.Viewer.Accept-Language setting.resources/Error.properties file. Use
Viewer.errorResponse()
instead.OldDefaultWorklistRenderer,
OldDefaultInstancelistRenderer, and
OldDefaultTemplatelistRenderer samples.Viewer.Page class to
ResponsePage.HTMLClient to WebClient.background.gif to the
samples/images directory so that it is not automatically
installed.WebClient directory to the
webpages directory./servlet/MQWFServlet
to /MQWFClient/servlet/Main.Servlet.AgentConfiguration property that can be used instead
of Servlet.AgentLocator.ServletName and HTTP_Port servlet
initialization parameters, and moved the HTMLDir servlet
initialization parameter to the
Servlet.properties file.JSPViewer.java class from package
com.ibm.workflow.sample to com.ibm.workflow.servlet.client.WorkitemViewContext, TemplatelistViewContext,
InstancelistViewContext, and WorklistViewContext
classes into the
RequestContext
class.java.util.Properties to
com.ibm.workflow.servlet.client.Config.AutoRefresh setting from a Servlet
property to a DefaultViewer property.index parameter of all
commands to id and the
meaning from 'index' to OID.| Old name | New name |
|---|---|
| startProcess | createAndStartProcess |
| createInstance | createAndStartProcess |
| refreshTemplates | queryProcessTemplates |
| showTemplates | queryProcessTemplates |
| templateSettings | showTemplateProperties |
| refreshInstances | queryProcessInstances |
| showInstances | queryProcessInstances |
| instanceSettings | showInstanceProperties |
| refreshWorkitems | queryWorkItems |
| showWorkitems | queryWorkItems |
| workitemSettings | showWorkItemProperties |
| checkinWorkitem | checkInWorkItem |
| restartWorkitem | forceRestartWorkItem |
| prepareTransfer | transferWorkItem |
| transferWorkitem | transferWorkItem |
| checkoutWorkitem | checkOutWorkItem |
| Command | Old name | New name |
|---|---|---|
| logon | UserID | userID |
| logon | Password | password |
| logon | SystemGroup | group |
| logon | System | system |
| createAndStartInstance | TemplateName | templateName |
| createAndStartInstance | _InstanceName_ | instanceName |
| checkInWorkItem | _RC | returnCode |
| transferWorkItem | NewUser | userID |
| Old name | New name |
|---|---|
| openInitial | logonResponse |
| openAfterLogoff | logoffResponse |
| openTemplatelist | queryProcessTemplatesResponse |
| openInstancelist | queryProcessInstancesResponse |
startProcess) HTML command:
InternetConnectionWorklistRenderer
class to InternetConnectionViewer and let it implement the
Viewer
interface instead of the deprecated
WorklistRenderer
interface.createAndStartInstance method on the template with the same
index in the template list.forceRestart instead of a cancelCheckout
(see also changes in release 1.3).Servlet.properties could not be read using
the hostname. Now using the IP address instead.NullPointerException in the JSPViewer
when the .jsp file did not exist and logging was turned off.NullPointerException when trying to start a process
anonymously while the Servlet.Starter user does not exist in
the workflow database.ch166.sh shell script which sets the
necessary owner and permissions for the HTML Client files on Unix platforms.SuccessLocation was missing
in 'process starter' HTML forms.Servlet.properties could not be read on OS/390.{_HTMLDir_} prefix in the
DefaultViewer.PageAfterLogoff
setting.web.xml).webserver/MQWFClient and
appserver into the HTMLClient directory.HTMLDir=/).Servlet.AgentLocator property did not
work (the Servlet was looking for Servlet.Agent.Locator).DefaultViewer.EnableTemplatelists and
DefaultViewer.EnableInstancelists from false to
true.Servlet.Errorn properties from the
Servlet.properties file and implemented
error page detection heuristics instead.ServletName initialization parameter. This parameter is now
detected automatically.Servlet.AgentConfigID property that can be used instead
of Servlet.AgentLocator.Servlet.properties
file cannot be read.com.ibm.workflow.servlet
to com.ibm.workflow.servlet.client.com.ibm.workflow.servlet.MQWFServlet
to com.ibm.workflow.servlet.client.Main.
MQWFServlet.properties to Servlet.properties.com/ibm/workflow/servlet/resources/MQWFServlet.properties to
com/ibm/workflow/catalog/servlet/Client.properties to conform
with the naming conventions of the MQSeries Workflow Java API.
MQWFServlet.errors to
resources/Error.properties and made this file configurable through
the Servlet.ErrorMessages setting. If you do not specify a file name,
the Java API's messages which are NLS-enabled will be displayed.settings directory to forms
and moved Error.html, ProcessStarted.html, and
Transfer.html there.
templates directory to
programs to avoid confusion with the term Process Template.processes directory for the process' data entry
forms. This is to avoid name clashes between process and program names
since they do not share the same name space.Viewer interface also allows to
specify the initial page after logon. Note that the Viewer
interface replaces the old renderer classes which are now deprecated.
Migration is straightforward: Simply move the code of the various renderers'
format() methods to the appropriate open()
method of a Viewer class. For an example, see
DefaultViewer.java which uses the now deprecated renderers
to display lists.format() methods
to take a single ViewContext bean as parameter instead of a list of
objects.Viewer, e.g.
com.ibm.workflow.sample.JSPViewer, in the servlet's properties
file. Note that your application server must support version 2.1 of the
servlet APIs if you want to use JSPs.Servlet.NumErrors property in the servlet
configuration file.Servlet.Logging property in the servlet
configuration file.Servlet properties to
DefaultViewer properties:
DefaultViewer.java.
:br suffix to all form fields. This suffix
causes line breaks to be preserved in the resulting HTML output. This
suffix is currently used in the Description and
Documentation fields of all settings forms.com.ibm.workflow.sample.MQWFServlet.properties file to the resources directory.
This allows usage of the servlet on non-US English environments.MQWFServlet.errors.MQWFServlet.errors and is located in the MQWFClient directory.
WorklistFormatter, TemplatelistFormatter, and
InstancelistFormatter.MQWFServlet.properties file.MQWFServlet.properties file to specify if
the sessions should be removed and users logged off when the servlet is destroyed.<form> ... </form> tags.<form> tag in the HTML template
forms will be replaced by a special tag that allows the servlet to process the output
container values.