| Modeling and Implementation Guide for Oracle Business Process Management |
This chapter describes how to implement BPMN user tasks using Human Tasks. You can use an existing Human Task component created using the SOA Human Task editor, or you can create a new Human Task using the simplified interface BPM Studio provides.
This chapter includes the following sections:
Section 14.2, "Assigning an Existing Human Task to a User Task"
Section 14.3, "Creating a Human Task from Oracle BPM Studio"
For detailed information about Human Tasks, see Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite.
The implementation of user tasks requires you to define a Human Task. You can use an existing Human Task or define a new one.
If your project contains Human Tasks, then they automatically appear in the business catalog under the HumanTasks predefined module.
You can add new Human tasks to your project in the following ways:
Using the simplified interface Oracle BPM Studio provides
From the SOA New Gallery
From the SOA Composite Editor
When you double click a Human Task component in the business catalog, BPM Studio opens the SOA Human Task editor. You can edit the Human Task using this editor.
shows a Human Task component in the Sales Quote example.
For more information on how to define Human Tasks using Oracle SOA Suite, see the following chapters in Oracle Fusion Middleware Developer's Guide for Oracle SOA Suite:
There are two approaches to working with Human Tasks in Oracle BPM:
Creating the Human Task using the SOA Human Task editor
Creating the Human Task using the simplified interface Oracle BPM provides
The approach you choose depends on how you plan your work, how you divide it between the developers in your team and the complexity of the Human Tasks you are developing.
Creating the Human Task Using the SOA Human Task Editor:
Create a Human Task using the SOA Human Task
Create the corresponding taskflow using SOA Suite
Create a BPMN process with user tasks
Implement the user tasks in the BPMN process using the defined Human Tasks
Creating the Human Task Using Oracle BPM Human Task Editor
Create a BPMN process
Add a user task. From the user task implementation properties dialog, create a Human Task.
Create the corresponding taskflows using SOA Suite
You can create a Human Task using the SOA Human Task editor and then assign that Human Task to the implementation of a user task.
You must also define how the data objects in your BPM process map to the input and output arguments of the Human Task. You can do this using data associations or transformation. For more information on data associations and transformations, see Chapter 8, "Handling Information in Your Process Design".
To assign an existing Human Task to a user task:
Edit the BPMN process.
Right-click the user task.
Select Properties.
The Properties - User Task dialog appears.
Click the Implementation tab.
Click the Browse... button next to the Human Task field.
The Browse Human Tasks dialog appears.
Select a Human Task from the list.
Click OK.
The Browse Human Tasks dialog closes and the selected Human Task appears in the Human Task field.
Click OK.
The user task uses the existing Human Task for its implementation.
The SOA Composite displays the relationship between the BPMN process and the Human task by adding a wire between them.
When the BPMN Service Engine runs the user task implementation it invokes the Human Workflow Service with the parameters defined in the data association of the user task. When the Human Workflow Service finishes running the Human Tasks it provides the result to the BPMN Service Engine using the defined data association.
You can create a simple Human Task using Oracle BPM Studio. The simplified interface Oracle BPM Studio provides hides the complexity of the Human Task editor by exposing only those fields that are relevant to Oracle BPM. After you create the Human Task using the simplified editor, you can edit it using the SOA Human Task editor if needed.
The simplified Human Task editor BPM Studio provides allows you to define the following properties:
Name
Priority
Pattern
Title
Outcomes
Parameters
Outcome Target
To create a human task from Oracle BPM Studio:
Edit the BPMN process.
Right-click the user task.
Select Properties.
The Properties - User Task dialog appears.
Select the Implementation tab.
Click the Add button next to the Human Task field.
The Create Human Task dialog appears.
In the name field, enter a name to identify the Human Task.
From they Priority List, select a priority.
If you want to use an approval management pattern, select one from the Pattern list.
In the Title Field, enter a title for the WorkList to display.
Optionally, you can configure the following:
The outcome
See Section 14.3.2, "How to Configure the Outcome of a Human Task" for information on how to configure the outcome of a Human Task.
The parameters
See Section 14.3.3, "How to Add a Parameter to Human Task" for information on how to configure the outcome of a Human Task.
The outcome target
See Section 14.3.4, "How to Configure the Outcome Target of a Human Task" for information on how to configure the outcome of a Human Task.
Click OK.
The Create Human Task dialog closes and the Human Task field in the User Task Properties dialog shows the Human Task you created.
Click OK.
The User Task Properties closes and saves the implementation you configured for the user task.
To configure the outcome of a Human Task:
In the Create Human Task dialog, click the Browse button next to the Outcomes field.
The Outcomes dialog appears.
Select one or more outcomes, or click the Add button to add a new custom outcome.
Optionally click Outcomes Requiring Comment, to select those outcomes that require comments.
Click OK.
The Outcomes dialog closes and the selected outcomes appear in the Create Human Task dialog, in the Outcomes field.
You can add multiple parameters to a Human Task by following these procedure.
To add a parameter to a Human Task:
In the Create Human Task dialog, click the Add button in the Parameters table.
The Data Objects dialog appears.
Select a data object from the Data Objects dialog and drop it on the Parameters table.
The selected data object appears in the Parameters table.
Close the Data Objects dialog.
Optionally you can mark the parameter as editable by selecting the Editable column in the Parameters table.
To configure the outcome target of a Human Task
In the Create Human Task dialog, click the Add button next to the Outcome Target field.
The Data Objects dialog appears.
Select a data object from the Data Objects dialog and drop it on the Outcome Target field.
The selected data object appears in the Outcome Target field.
Close the Data Objects dialog.
The Human Task automatically appears in the HumanTasks predefined module in the business catalog. You can use the Human Task to implement the user task you are editing or other user tasks in the BPM project.
You can edit the created Human Task using the SOA Human Task editor to configure implementation details.
Human task patterns allow you to use a predefined flow to create the Human Task. These predefined patterns contain standard process flows that are common to all business processes.
Oracle BPM supports the following Human Tasks patterns:
Complex
FYI
Group
Initiator
Management
User
You can add a Human Tasks that uses patterns by selecting the specific user task in the Interactive Activities section in the Component Palette, or you can add a generic user task and when you create the Human Task select the pattern you want to use.
For more information about Human Task patterns, see Chapter 25, "Using Approval Management".