Defining and Maintaining Workflows


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \| Glossary

WebLogic Collaborate Doc Home \| Studio User Guide \| Previous Topic \| Next Topic \| Contents \| Index

The following sections introduce you to WebLogic Process Integrator workflow templates and workflow template definitions. It also explains how to perform a number of workflow template definition and maintenance tasks.

Understanding Workflow Templates and Workflow Template Definitions

A workflow template is, in essence, a folder or a container for WebLogic Process Integrator workflow template definitions. Each workflow template can hold one or more WebLogic Process Integrator workflow template definitions. WebLogic Process Integrator workflow template definitions are identified in the folder tree by an Effective and Expiry date. (See Understanding Effective and Expiry Dates.)

Figure 3-1 Workflow Templates and Workflow Template Definitions

Creating a New Workflow Template

To create a new workflow template:

Right-click on the Templates folder in the WebLogic Process Integrator main window.
Select New Template from the pop-up menu to display the Template Properties dialog box.
Figure 3-2 Template Properties Dialog Box
In the Name field, enter a meaningful name for the workflow template. All workflow template definitions defined within this workflow template use this name for identification, once they are instantiated (placed into run time) and become workflow instances. The name must be unique.
In the Organizations section of the dialog box, select the organization (or organizations) under which you will define this workflow template.
To make the workflow template available to all organizations, click All Orgs; to make the workflow template available to no organization, click No Org.
Click OK. The new workflow template appears under Templates in the folder tree of the WebLogic Process Integrator main window.

Creating a New Workflow Template Definition

To create a new workflow template definition, proceed as follows:

Right-click the workflow template that will contain the new workflow template definition in the folder tree.
Choose Create Template Definition from the pop-up menu to display the Template Definition dialog box.
Figure 3-3 Template Definition Dialog Box
In the Template Definition dialog box, specify the following:
Click OK to save changes and display the workflow drawing area.

In the workflow drawing area, a default workflow template definition is presented along with a toolbar containing drawing shapes used for defining the workflow template. The default workflow template definition contains three shapes: Start, Task, and Done. Modify and define properties for the default workflow template definition as needed.

More than one workflow template definition diagram can be opened simultaneously, and you can toggle between these within WebLogic Process Integrator.

Figure 3-4 Workflow Drawing Area

Specifying Workflow Template Definition Properties

To specify the properties of a workflow template definition:

Right-click anywhere in the workflow drawing area, and choose Properties from the pop-up menu to display the Template Definition dialog box. Alternately, display the Template Definition dialog box by right-clicking the workflow template definition in the folder tree and selecting Properties from the pop-up menu.
The Template Definition dialog box contains two tabs:
- General — changes general workflow template definition values as needed. (See Creating a New Workflow Template Definition.)
- Exception Handlers — assigns system and custom-defined workflow exception handlers to the workflow template definition. (See Handling Workflow Exceptions.)
  Figure 3-5 Template Definition Dialog Box: General Tab
In the General tab of the Template Definition dialog box, specify the following:
In the Exception Handlers tab of the Template Definition dialog box, select a system or custom-defined exception handler to assign to the workflow template definition.
Click OK to save changes. If you click Cancel, any pending changes to the fields in the Template Definition dialog box are discarded.
Use the buttons situated to the right of the Exception Handlers tab as follows:

Note: For detailed instructions on using the Exception Handler Properties dialog box, see Handling Workflow Exceptions.

Opening Workflow Template Definitions

To open an existing workflow template definition:

Right-click the workflow template definition in the folder tree, and choose Open from the pop-up menu.
Figure 3-8 Workflow Template Definition Menu

The Existing Instances dialog box is displayed, if there are existing instances of the selected workflow template definition, meaning that the selected workflow template definition has been started and an instance of the template definition exists in the server. Multiple instances of a single workflow template definition can exist.

Figure 3-9 Existing Instances Dialog Box

This message warns that changing a workflow template definition might cause a problem with the workflow template definitions currently in process.
Select from the following options:

Saving and Closing Workflow Template Definitions

When you make changes within WebLogic Process Integrator Studio, you must save them. If you make changes to a workflow template definition and attempt to close the workflow template definition in the drawing area without saving it, you will be prompted to save.

In the WebLogic Process Integrator Studio folder tree, an asterisk (*) appears to the left of each workflow template definition that needs to be saved. From the folder tree, you save by right-clicking the workflow template definition and choosing Save from the pop-up menu. From the workflow drawing area, you save by right-clicking in the drawing area and choosing Save.

A workflow template definition cannot be modified unless it is opened. When a definition is not open, you cannot modify its values. Once you open a definition, it is locked and cannot be opened by another user. When you close a definition, it is unlocked and available for use by another user.

Printing Workflow Template Definitions

You can print workflow template definition diagrams from WebLogic Process Integrator. There are two methods for invoking the print facility.

Right-click the workflow template definition in the folder tree of the Studio and select Print from the pop-up menu.
Right-click anywhere in the workflow template definition diagram in the drawing area and select Print from the pop-up menu.

The Text tab contains information relevant to each workflow node, including action and node notes, as well as details on actions within tasks, events, decisions and done nodes, including subactions within actions.

Figure 3-10 Print Workflow Text

The Graphics tab contains a diagram of the workflow template definition.

Figure 3-11 Print Workflow Graphics

Click Print to print the information on the selected tab, or click Print All to print both the information contained in the Text tab and the diagram contained in the Graphics tab.

The Print dialog box is displayed. Select the printer name and click OK.

Figure 3-12 Print Dialog Box

Copying Workflow Template Definitions

WebLogic Process Integrator allows you to take an existing workflow template definition, copy it, and paste it as a new workflow template definition into the folder tree. When this is done, all of the assigned workflow template definition properties are copied as well. This saves you time when you must create more than one workflow template definition with similar properties. The properties of the new workflow template definition can be modified as needed.

In addition, WebLogic Process Integrator allows you to copy nodes (shapes) within workflow template definitions and paste them into the current workflow template definition or other open workflow template definitions. All properties assigned to nodes are copied as well.

Note: The copied (new) workflow template definition will not be marked active. You must mark it active in the workflow Template Definition Properties dialog box in order for it to be processed in the workflow.

Copying Entire Workflow Template Definitions

To rename the new workflow template definition, right-click anywhere in the drawing area, choose Properties from the pop-up menu to access the Template Definition dialog box, and make changes as needed. Modifying the Expiry and Effective dates changes the name of the workflow template definition in the folder tree and reflects the new dates.

Copying Nodes Within Workflow Template Definitions

You can copy a shape representing a node within a workflow template definition and paste it into the current workflow template definition or into another open workflow template definition. Any properties that have been defined within the node are also copied. To do so, proceed as follows:

Click the node that you will copy.
Right-click in the drawing area, and select Copy from the pop-up menu.
Place your cursor in either the current workflow template definition or another open workflow template definition, depending on where you want to paste the shape, and right-click.
From the pop-up menu, select Paste.

The shape is pasted in the indicated workflow template definition. Modify the properties of the node as needed.

Copying Actions Within or Between Workflow Node Shapes

WebLogic Process Integrator also allows you to copy actions within or between shapes representing a node within a workflow template definition. Any properties that have been defined within the action are also copied. The ability copy actions saves you time.

Copying Actions Within Workflow Nodes

The ability to copy actions within workflow nodes is useful when, for example, you must define a new action within a workflow task node that will contain properties similar to an already defined action within that task node. By copying the existing action and pasting it as a new action within the same task node, you save yourself time. Rather than having to define a whole new action, which might be a complex action, you might only have to make one or two modifications to the pasted action.

To copy actions within the same node, proceed as follows:

From the drawing area, right-click the node shape containing the defined action that you will copy.
Select Properties from the pop-up menu to display the Properties dialog box for that node shape.
In the Actions portion of the window, select the appropriate tab containing the action to be copied: Created, Activated, Executed, or MarkedDone.
Right-click the defined action that you will copy, and select Copy from the pop-up menu.
Figure 3-13 Copy Action
In the Actions portion of the window, select the appropriate tab where you will paste the action: Created, Activated, Executed, or MarkedDone.
Right-click anywhere in the Actions portion of the window.
Select Paste from the pop-up menu.
Depending on the copied action, a dialog box appears that corresponds to the copied action.
Make changes, if needed, to the action definition, and Click OK. The action is copied into the Actions portion of the window.

Copying Actions Between Workflow Nodes

The ability to copy actions between workflow nodes benefits you in the same manner as the ability to copy actions within workflow nodes. However, rather than copying actions within the same workflow node, you copy actions within one node and paste them into another node within the same workflow template definition. The ability to copy actions between nodes simplifies and speeds up the workflow definition process. When an action is copied, all of its properties are also copied, so you do not need to redefine all of the properties in the pasted node.

To copy actions between nodes, proceed as follows:

From the drawing area, right-click the node shape containing the defined action that you will copy.
Select Properties from the pop-up menu to display the Properties dialog box for that node shape.
In the Actions portion of the window, select the appropriate tab containing the action to be copied: Created, Activated, Executed, or MarkedDone.
Right-click the defined action that you will copy, and select Copy from the pop-up menu.
Figure 3-14 Copy Action
From the drawing area, right-click the node shape to which you will paste the defined action.
Select Properties from the pop-up menu to display the Properties dialog box for that node shape.
In the Actions portion of the window, select the appropriate tab to which the action is to be copied: Created, Activated, Executed, or MarkedDone.
Right-click anywhere in the Actions portion of the screen, and select Paste from the pop-up menu.
Figure 3-15 Paste Action
Depending on the pasted action, a dialog box appears that corresponds to the action.
Make changes, if needed, to the action definition, and Click OK. The action is pasted into the Actions portion of the window.

Deleting Workflow Template Definitions

To delete a workflow template definition, right-click the workflow template definition name in the folder tree, and choose Delete from the pop-up menu. The Delete Workflow dialog box asks you to confirm or cancel the delete.

Note: The workflow template definition must be closed in the drawing area before you delete it, or you will receive an error message.

Figure 3-16 Delete Workflow Dialog Box

When a workflow template definition is deleted, the following also occurs:

All instances of that workflow template definition are deleted (including all tasks regardless of their current status).
All history relating to that workflow template definition is deleted and is therefore no longer available in statistical reports.
Workload reports that refer specifically to the deleted workflow template definition are changed to refer instead to all remaining workflow template definitions.

Deleting Workflow Templates

You can delete a workflow template from WebLogic Process Integrator, in which case all workflow template definitions within the workflow template are also deleted. To delete a workflow template (and all of its workflow template definitions), proceed as follows:

Right-click on the workflow template name in the folder tree.
Figure 3-17 Delete Workflow Template
Choose Delete to display the Delete Template dialog box.
Figure 3-18 Delete Template Dialog Box
Click Yes to delete the workflow template and all of its workflow template definitions, or click No to cancel the delete.

Understanding Effective and Expiry Dates

In the folder tree, a workflow template definition name consists simply of its Expiry and Effective dates. The effective and expiry dates represent the range of time within which the workflow template definition is available for instantiation.

The Effective and Expiry Date features are useful in that they allow you to make workflow template definitions valid for exact periods of time. Perhaps you have a cyclical business, which requires you to run a particular workflow template definition for the first six months of the year, followed by a second workflow template definition having different tasks or variables the remaining six months of the year.

Rather than having to manually inactivate one workflow template definition and activate another at different times, you can define separate workflow template definitions having different properties and make them available at the right time by managing the effective and expiry dates.

Within a single workflow template, a workflow template definition's timeline cannot overlap that of another workflow template definition. In other words, only one workflow template definition can run at a time within one workflow template.

You can not have two active definitions with the same effective date. When trying to make a workflow template definition active, WebLogic Process Integrator prevents you from doing so, if another definition with the same effective date exists.

Exporting Workflow Template Definitions

You can export a workflow template definition from WebLogic Process Integrator to any drive mapped in your computer. You can, for example, move a workflow template definition from WebLogic Process Integrator Studio to another system. An exported workflow template definition is saved as an XML document.

To export a workflow template definition, right-click it in the folder tree, then choose Export from the pop-up menu. In the Save dialog box, select the drive where you will save the exported workflow template definition.

Figure 3-19 Save Dialog Box

Importing Workflow Template Definitions

You can import a workflow template definition (that was previously exported) into WebLogic Process Integrator to create a new workflow template definition.

Note: Imported workflow template definitions are always marked as "inactive." Before an imported workflow template definition can be instantiated, you must change the definition to "active" in the Template Definition dialog box. Refer to Creating a New Workflow Template Definition.

To import a workflow template definition, proceed as follows:

In the WebLogic Process Integrator folder tree, right-click the workflow template into which you will import the workflow template definition.
From the pop-up menu, select Import Template Definition to display the Save dialog box.
In the Save dialog box, select the current location of the exported workflow template definition file on your hard drive, and click Save.
Note: You cannot import a workflow template definition under a different name from that it contained when it was exported. Otherwise, you will receive a warning message.

Figure 3-20 Save Dialog Box
After the file is read, an import confirmation dialog box is displayed that asks you to confirm the import. Click Yes to import the workflow template definition.
Note: In some cases, importing workflows may display warning messages. When a workflow template definition contains a Perform Business Operation or Start Workflow action, the actions must be redefined when the actions are imported in a workflow.

Displaying Workflow Instances

When a workflow template definition is started, the WebLogic Process Integrator server creates a new instance (or session) of that workflow template definition. Regardless of how many workflow template definitions exist for a given workflow template, the WebLogic Process Integrator server chooses only one of these definitions to instantiate. It chooses the most effective of the active workflow template definitions. For example, consider three definitions defined with the following effective dates:

January to March
April to June
July to September

If you instantiate your workflow in February, the most effective of the active workflow template definitions for the workflow template is selected, in this case, the one with the effective date of January to March.

To display the instances of a workflow template definition for monitoring purposes, right-click the workflow template folder and choose Instances from the pop-up menu. Refer to Monitoring Workflows, for further details.