Oracle WebLogic Integration Worklist provides the capability to direct the flow of work and manage the routing of tasks to the people in an enterprise. Integral to the flow of work are actions such as receiving, approving, modifying, and routing documents. The documents that accompany work activities provide the information necessary for people to perform and complete tasks. The Worklist enables people to collaborate in business processes including assigning tasks, tracking the status of tasks, handling approvals, and other activities required to manage workflow.
To support the Worklist functionality, Oracle WebLogic Integration provides two controls in Oracle Workshop for WebLogic, the Task control and the Task Batch control. These controls expose Java interfaces that can be invoked directly from your business processes. The Task control enables a business process to create a single Task instance, manage its state and data, and provide callback methods that report status. The Task Worker control allows specified users to acquire ownership of Tasks, work on them, and complete them. It also provides administrative privileges, such as starting, stopping, deleting, and assigning. Access to the Task Worker control can be done with a business process or through a user interface (UI).
Tutorial: Building a Worklist Application
Worklist controls enable the automated manipulation, creation, and management of Tasks. A Task instance represents a unit of work that requires completion within a certain time period. After the work is completed, you can use a Task instance to represent a detailed record of that unit of work.
A Task instance is a particular object in the run-time Worklist system that represents a work assignment in the real world. Task instances are part of the Oracle WebLogic Integration server and exist independently of any controls or business processes. Multiple business processes can interact with a Task throughout its lifecycle concurrently. Tasks remain in the run time indefinitely, either until they are explicitly deleted or purged by the Oracle WebLogic Integration purging process. You can create, delete, and manage Tasks through the following mechanisms:
Task instances, or simply Tasks, offer a variety of properties that describe the work to be done and the state of the work. Task instance properties can describe the following:
Tasks have the following characteristics, qualities and behaviors that can be defined, configured or used:
The following Worklist controls are provided for building a Worklist system with Oracle WebLogic Integration:
Worklist controls are extensible. Common extensions include implementing callback functions and performing system queries. Extensibility is provided by Java annotations.
An instance of a Task control can create a single task instance. If multiple tasks need to be created, use a factory type of Task control. See “Using Task Control Factories” in Advanced Topics in Using the Worklist Tutorial.
A Task control instance can also interact with a task instance that already exists by setting its active task ID. After creating or setting the active task ID, your control instance can get information about that task or update that task in various ways.
You can customize Task controls for different business purposes, by adding new operations or callbacks, or by altering the signatures of existing operations or callbacks.
Note: | If the Data Palette view is not visible in Oracle Workshop for WebLogic, click Window > Show View > Data Palette from the menu bar. |
The Insert control: Task dialog box appears (see Figure 19-1).
A new Task control and an instance of it are created and the Insert Control dialog box is closed.
A new Java file is created and displayed in the Package Explorer pane in Oracle Workshop for WebLogic. (You can double-click any Java file to view or edit it in the Design or Source view.) The instance of the control is displayed on the Controls tab of the Data Palette.
For examples of designing interactions between a business process and an instance of a Task control, see Using Task and Task Batch Controls in Business Processes.
Task Instances have data values associated with them, many of which are set when the task is created. You can use the JPD Configuration pane on a Task control to set the default values for some of these data values. These values are used whenever that control instance creates a new task. Note that the properties set on a factory type Task control propagate to any Task control instances created from that factory.
Note: | To learn how to use the JPD Configuration and Properties pane for specifying properties for control types versus control instances, see Interacting With Resources Using Controls. |
The Task Worker control allows specified users to acquire ownership of Tasks, work on them, and complete them. It also provides administrative privileges, such as starting, stopping, deleting, and assigning. Access to the Task Worker control can be done with a business process or through a user interface (UI). You can customize each Task worker control for different business purposes.
This topic describes how to create a new Task Worker control. Task Worker controls do not have any properties to configure.
Note: | If the Data Palette view is not visible in Oracle Workshop for WebLogic, click Window > Show View > Data Palette from the menu bar. |
The Insert control: Task Batch dialog box appears.
When you click finish, the control java file is displayed in the Package Explorer pane. In both Design and Source view, you can double-click any control java file to view or edit it. The instance of the control is displayed on the Controls tab of the Data Palette.
For examples of designing interactions between a business process and an instance of a Task control, see Using Task and Task Batch Controls in Business Processes.
Before you begin working with the Task and Task Batch controls, you should be familiar with the features and components of the Worklist. To learn more about the Worklist, see Using the Worklist.
To design the interaction of a Task or Task Worker control with a business process, you must decide which methods on the control you want to call from the business process to support the business logic.
In the same way that you design the interactions between business processes and other controls in the Oracle Workshop for WebLogic, you can bind the Worklist control method to the appropriate control node in your business process (Control Send, Control Receive, and Control Send with Return). You do this in the Design view by simply dragging a control method from the Data Palette onto the business process at the point in your business process at which you want to design the logic.
When you create task control, out of user properties like Integer
and Float
in the task plan, the user properties argument become long
and double instead of Integer
and Float
, this change in input will not lead to data loss.
To see an example of using a Task control in a business process, see Tutorial: Building a Worklist Application.