How to use the Rapid Deployment Wizard

This section describes how to use the Rapid Deployment Wizard in detail. To learn how to use this wizard quickly, refer to the tutorial section.
Using the Rapid Deployment Wizard consists of the following tasks:

  1. Starting the Rapid Deployment Wizard
  2. Selecting an FDL file and a project
  3. Selecting a target process or an activity
  4. Selecting a JSP file and a template
  5. Setting up JSP form properties of container members
  6. Changing the order of output fields
  7. Editing the submit button properties
  8. Generating a JSP file

These tasks are described in the following sections, supported by the corresponding screenshots, where applicable.

Starting the Rapid Deployment Wizard

The tutorial section Starting the Rapid Deployment Wizard describes how to start the wizard.

Selecting an FDL file and a project

The following screenshot displays the first window of the wizard. Here you can specify the source FDL file you want to use, and the target project.


Description:
FDL entry field Specify an FDL file for IBM MQSeries Workflow.
Browse Button If you want to select an external file, make sure that the "in the workspace" check box is not checked. Click "Browse", and select an FDL file. If you want to select a file in the workspace, check the "in the workspace" check box, click "Browse", and select an FDL there.
target project list Specify the target Web Project to which you want to add the created JSP files.

Click Next to continue.

Selecting a target process or an activity

The following screenshot displays the next window of the wizard. Here you can specify a target process and an activity.


Description
target process list Select the target process that you want to be implement with JSP files.
Generate JSP for the activity If you want to create a JSP file for the process instantiation, uncheck the "Generate JSP for the activity" check box after you specified the target process. If you want to create a JSP file for the activity implementation, check the "Generate JSP for the activity" check box, and select the target activity from the Select the activity list list.
Select the activity If you want to create an activity implementation, select a target activity from the list.

Click Next to continue.

Selecting a JSP file and a template

The following screenshot displays the next window of the wizard. Here you can specify a name for the target JSP file, and a template.


Description
Output Folder The default path is displayed. You can change it according to your needs.
JSP file name A default name for the JSP is displayed. You can change it according to your needs.
Force to create the JSP file If you want to overwrite an already existing JSP file with a new JSP, check this check box.
Round trip generating If you want to create a new JSP file, uncheck this check box, and select a default template, or a user-specific template. If you want to modify the existing JSP file, check the check box.
Select template The template JSP file is a source file for a JSP. If you do not have a specific template, use the default JSP. You can also customize the default JSP file according to your needs, and specify the JSP file as a user-specific template.

Click Next to continue.

Seting up JSP form properties of container members

The following screenshot displays the next window of the wizard. Here you can specify JSP form properties of container members, and properties for each field.


Description:
In the Container Member pane on the left, you can specify which container member you want to include in the JSP file. If you want to add a member of the input container to the JSP, click the Input tab and select the appropriate member. Then, check the "Output this field" check box. If you do not want to output your selection, uncheck this check box. For the Output and Global tabs of the Container Member pane, proceed accordingly.

In the Field Property pane, you can specify the following options:

Comment If you select this option, the comments that are created in the MQSeries Workflow Buildtime are included in the JSP file.
Document If you select this option, the documents that are created in the MQSeries Workflow Buildtime are included in the JSP file.
Field Type With this option, you can specify a field control type that you want to generate.
The following type is available for the input container:
  • Static Text
The following types are available for the output container:
  • Text field
  • Text area
  • Hidden field
  • Radio button
  • Check box
  • Dropdown list
  • List box

When you click Options, you get the following option dialogs for the various field types: After setting values and closing the dialog, you can click the Next button to proceed to next window.

Field Option Settings : Text field

Disabled Select this option if you want to disable the text field.
ReadOnly Select this option if you want the text field to be read-only.
Colums Specify the number of colums of the text field.
Max Length Specify the maximum length of the text field.
Initial Value If you want to set a constant value for the initial value, select Constant, then specify the value in the field. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.

Field Option Settings : Text area

Disabled Select this option if you want to disable the text area.
ReadOnly Select this option if you want the text area to be read-only.
Number of Rows Specify the number of the rows of the text area.
Colums Specify the number of colums of the text area.
Initial Value If you want to set a constant value for the initial value, select Constant, then specify the value in the field. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.

Field Option Settings : Hidden

Initial Value If you want to set a constant value for the initial value, select Constant, then specify the value in the field. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.

Field Option Settings : Radio button

Disabled Select this option if you want to disable the radio button.
ReadOnly Select this option if you want the radio button to be read-only.
Value Specify the value of a radio button in this field.
Add Click this button if you want to add a value for another radio button.
Replace If you want to replace a specified value, select the respective value in the list, specify the new value, then click Replace button.
Delete If you want to delete a value, select the respective value in the list, then click Delete button.
Clear If you want to clear the value field, click this button.
Up / Down Use the Up and Down buttons to sort the value list entries according to your needs.
Initial Value If you want to set a constant value for the initial value, select Constant, then select the value from the dropdown list box. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.

Field Option Settings : Check box

Disabled Select this option if you want to disable the checkbox.
ReadOnly Select this option if you want the checkbox to be read-only.
Value Specify the value of this checkbox in this field.
Initial State Select On if you want to check this checkbox enabled as an initial state. Select Off if you want to clear it. Select Depend on ContainerMember, and the initial state will be checked if the specified value and the specified container member's value are same. Otherwize, the state will be cleared.

Field Option Settings : Drop down list

Disabled Select this option if you want to disable the dropdown list.
Item Specify an item name in this field.
Value Specify the value of the item in this field.
Add Click this button if you want to add an item to the dropdown list.
Replace If you want to replace an item, select the respective item and value in the list, specify the new item and value, then click Replace button.
Delete If you want to delete a item, select the respective item and value in the list, then click Delete button.
Clear If you want to clear the item/value field, click this button.
Up / Down Use the Up and Down buttons to sort the item list entries according to your needs.
Initial Value If you want to set a constant value for the initial value of the dropdown list, select Constant, then select the item from the dropdown list box. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.

Field Option Settings : List box

Disabled Select this option if you want to disable the listbox.
Allow multiple selection Select this option if you want to select multiple items in the listbox.
Number of Rows Specify the number of rows of the listbox.
Item Specify an item name for this listbox in this field.
Value Specify the value of the item in this field.
Add Click this button if you want to add an item to the listbox.
Replace If you want to replace an item, select the respective item and value in the list, specify the new item and value, then click Replace button.
Delete If you want to delete a item, select the respective item and value in the list, then click Delete button.
Clear If you want to clear the item/value field, click this button.
Up / Down Use the Up and Down buttons to sort the item list entries according to your needs.
Initial Value If you want to set a constant value for the initial value of the listbox, select Constant, then select the item from the list box. If you want to set a value that is specified by the member as initial value, select Specified by Member, then click Browse button and specify the member in the pop-uped window.


Click Next to continue.

Changing the order of output fields

The following screenshot displays the next window of the wizard. Here you can specify the order of the output fields.


Description

In the Fields to be generated list, you can change the order of the fields by selecting the target field and clicking the Up or Down button. In the Fields to be overwritten list, you can see which fields in the current JSP will be overwritten. In the Fields to be erased list, you can see the fields that will be deleted. Click Next to proceed.

Editing the submit button properties

The following screenshot displays the last window of the wizard. Here you can specify the properties of the submit button.

Description:
In this window, you can edit, add, or delete the submit buttons. The buttons that are listed on the Submit buttons properties list will be included in the JSP file. The list also contains the default submit buttons.


Description This drop-down list contains the descriptions for the submit buttons.
You can select a button to be added from this list. This list shows the following predefined submit buttons:
  • CheckIn work item
    This button invokes the check-in and the exit operation of the activity. This is one of default submit buttons.
  • Reset form data
    This button invokes the reset to clear all fields on the current form without submitting.
  • Cancel work item
    This button leads you back to the work list and cancel the changes you made for the page. This is one of default submit buttons.
  • Complete work item
    This button invokes the check-in and the exit operation of the activity for "Web Client Extensions". If you want to use this button, you need to install the WA84 SupportPac.
  • Save as Draft
    This button invokes the suspend function of "Web Client Extensions". The inserted data is stored in the output container where it can be restarted at any time. If you want to use this button, you need to install the WA84 SupportPac.
  • Back to Saved Draft
    This button leads you back to the work list and cancels the changes you made for the page that is displayed. But at any time you can resume the activity which had been saved last time. If you want to use this button, you need to install the WA84 SupportPac.
  • Destroy Saved Draft
    This button leads you back to the work list and cancel all saved data. If you want to use this button, you need to install the WA84 SupportPac.
If you want to change this predefined buttons list, refer to the section of RDW properties file.
Name Specifies the name of the submit button that is included in the input tag.
Value Specifies the value of the submit button that is included in the input tag.
Command Specifies the command of the submit button that is included in the input tag. You cannot edit the command.
Add If you want to add a new button, select one from the Description drop-down list, and click Restore defaults. The default values of Name, Value, and Command will be shown. You can accept the provided values, or change them according to your needs. To do this, edit the respective button and click Add.
Replace If you want to modify a submit button from the list and replace an existing one, select the one to be modified, change the values for Name and Value, and click Replace.
Delete If you want to delete a submit button, that is, you do not want to add it to the JSP file, select the button to be deleted and click Delete
Clear If you want to clear all entry fields, click Clear

Click Finish to continue.

Generating a JSP file

Now the new JSP file is generated and added to a workspace of WSAD. It's ready to be customised with the Page Designer.


© Copyright IBM Corporation 2002. All Rights Reserved.