Hints and Tips

In this section, you may be able to find some useful information to resolve your problems in using the Rapid Deployment Wizard.
It contains the following parts:

Properties file - RapidDeployment.properties

The Rapid Deployment Wizard uses its own properties file, RapidDeployment.properties, which is located on the root directory for this wizard. (For example, <WSAD rootdir>/plugins/com.ibm.workflow.RapidDeployment.wizard)

Key name Description
defaultTemplate The relative path to the template JSP file for an activity implementation. The default path is "template/rdtemplate.jsp".
This template will be used when "Generate JSP for the activity" is checked in "Selecting a target process or an activity" and "Default template" is selected in "Selecting a JSP file and a template".
defaultProcessTemplate The relative path to the template JSP file for a process instanciation. The default path is "template/rdprocesstemplate.jsp"
This template will be used when "Generate JSP for the activity" is cleared in "Selecting a target process or an activity" and "Default template" is selected in "Selecting a JSP file and a template".
profileName The relative path to the profile to save current profile information.
documentRootDirectory The document root directory of the MQSeries Workflow Web Client. The default value is "webApplication".
This value will be used to show a default "Output Folder" for a JSP file to be generated in "Selecting a JSP file and a template".
programOutputDirectory The relatice path to the project folder for an activity implementation. The default value is "program".
This value will be used to show a default "Output Folder" for a JSP file to be generated in "Selecting a JSP file and a template".
processOutputDirectory The relatice path to the project folder for a process instanciation. The default value is "process".
This value will be used to show a default "Output Folder" for a JSP file to be generated in "Selecting a JSP file and a template".
readDoubleMethod The prototype method for referring to a FLOAT type member. The output is located in a generated JSP file, and the name arguments are replaced by the referred member name. You must declare this method in the template files.
readStringMethod The prototype method for referring to a STRING type member. The output is located in a generated JSP file, and the name arguments are replaced by the referred member name. You must declare this method in the template files.
readLongMethod The prototype method for referring to a LONG type member. The ouput is located in generated JSP file, and the name arguments are replaced by the referred member name. You must declare this method in the template files.
readGlobalMethod The prototype method for referring to a Global Container member. The ouput is located in generated JSP file, and the name arguments are replaced by the referred member name. You must declare this method in the template files.
loopIndex This is a variable name of the loop index used for an array member in the Output JSP file.
buttonFormat.index This is a type of a format for a submit button which is used for the predefined buttons in "Editing the submit button properties.
You can specify a tag format for a button where %(name) and %(value) should be used for a name and a value for the tag. This format is reffered by the property of buttons in the next item.
button.name.properties This is used to register the properties of a submit button which is used for the predefined buttons in "Editing the submit button properties.
If you want to add your own submit button to the predefined button list, you need to specify the following properties.
  • priority
    The index number of the list
  • type
    These values are allowed:
    • process
      for a process instanciation only
    • activity (default)
      for an activity implementation only
    • all
      for both
  • format
    The corresponding index number of the button format
  • description
    The description for the submit button. This string will be shown in the predefined button list.
  • value
    The value of the submit button
  • default
    The flag whether the button is default or not. If this value set to "true". the button will be shown as the default buttons in the panel.
  • command
    The command string of the submit button. This command need to be processed by the servlet of MQSeries Workflow WebClient.

TroubleShooting

The following Q&A may help you from your troubles with the Rapid Deployment Wizard.

Q. How to remove the "Request Context" and "Instance Name" from the JSP for a process instanciation

A. Please follow the following step:

  1. Go to the following directory:
    <WSAD root>/plugins/com.ibm.workflow.RapidDeployment.wizard/template
    (<WSAD root> is the root directory of WebSphere Application Developer)
  2. Open rdprocesstemplate.jsp.
  3. Remove or comment out the following lines:
    Instance Name:<input name="instanceName" type="text" value="<%=context.getTemplate().name()>">
    Process Context:<input name="context" type="text" value="">
  4. Save the file.

Q. How to add or remove the predefined submit buttons

A. Please refer to the button's section of the propery file.

Q. How to resolve the following exception error in compiling JSP file for the activity implementation including the access to the global container member

Internal Servlet Error:

javax.servlet.ServletException: com.ibm.workflow.servlet.client.RequestContext: 
    method getGlobalContainer()Lcom/ibm/workflow/api/ReadOnlyContainer; not found
	at javax.servlet.ServletException.(ServletException.java:161)

A. The version of MQSeries Workflow on your environment may be 3.3.2. You need to install Service Pack 1 to support a global container.
Otherwize, you need to remove the access method to the global container member in JSP file. Please follow the following step:

  1. Go to the following directory:
    <WSAD root>/plugins/com.ibm.workflow.RapidDeployment.wizard/template
    (<WSAD root> is the root directory of WebSphere Application Developer)
  2. Open rdprocesstemplate.jsp.
  3. Remove or comment out the following line in the getGlobalMember method:
      val = context.getMemberValue(context.getGlobalContainer(), name, "");
    
  4. Save the file.
  5. Do the same thing to rdtemplate.jsp.


© Copyright IBM Corporation 2002. All Rights Reserved.