public String getHTMLAlignment(String latin1Allign)
,
public String getHTMLDirection()
and public
String getLocalizedGifName(String name, String language)
added
to SessionContextImpl to allow easier access to information used for
bi-directional display of the Web Client pagesAgentProviderURL
from the properties file. With this fixed it is now possible to use a
remote naming service/forms/Error.jsp
instead of Error.html
<FORM>
element in addition to the automatically generated action
and method
attributes. Logon.jsp
and Logon.html
.WebClient.properties
did not overwrite the computed values.Logon.jsp
.WebClient.properties
that will automatically restore expired HTTP sessions as long as the
Workflow session still is valid.null
when used with MQ
Workflow versions before 3.3.2.WorkItem.checkOut2()
instead of WorkItem.checkOut()
and added the
RequestContext.getImplementationData() method.AutoRefresh
setting which was not always
honoured when set to false
.<load-on-startup>
element in web.xml
.Encoding
section to the WebClient.properties
file where application server character encodings (as returned by javax.servlet.http.HttpServletResponse.getCharacterEncoding()
)
can be overwritten (WebSphere APAR PQ51629).ApplicationContext.getJavaApiVersionInfo()
backwards compatibility.ConfigurationFile
servlet initialization parameter now is no longer needed if the WebClient.properties
file is put in the <MQWFDir>/cfgs/<cfgID>/WebClient/webpages/WEB-INF
directory.ForceRestart
as a valid action for Work Items
in 'ready' state (this is an addition in MQ Workflow V3.3).WebClient.properties
which allows to restrict
the maximum size of HTTP POST requests the Web client's servlet will
accept.WebClient.properties
file to change the
DefaultViewer to com.ibm.workflow.servlet.client.JSPViewer
and updated RTC.html to use Logon.jsp instead of Logon.html. You must
reverse these changes if your application server does not support JSPs.alt
tags. This was necessary
to fully support languages other than English.CommandHandler.onLogon(SessionContext)
.CommandHandler.logon3()
.ApplicationContext.getHTMLDir()
.ApplicationContext.getDocBase()
.RequestContext.persistentOidOf()
.PRESENT
session mode when logging on.getTimeZoneOffset()
has been added to dhtml.js to encapsulate the computation.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.Old name | New name |
---|---|
ApplicationContext.getHTMLDir() | ApplicationContext.getRootURI() |
ApplicationContext.getDocBase() | ApplicationContext.getDocumentRoot() |
CommandHandler.onLogon(SessionContext) | CommandHandler.onLogon(RequestContext) |
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>/cfgs/<cfgID>/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 MQ 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.