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 Viewer
s 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.