You can implement a User Task or System Task activity to use applications outside of
IBM® Business Process Manager. For example, you can model an
activity that is run by a custom Eclipse RCP or Microsoft .NET application.
Before you begin
To use an external application, implement the activity as an external implementation. To
create an external implementation, you must be in the
IBM Process
Designer desktop editor. See
Creating an external implementation.You can select an external implementation from an activity in
the web process editor .
About this task
The following steps describe how to select a custom application as the implementation for
a process activity.
Procedure
- Open a process and click the activity that you want to implement using a custom
application.
- Click the Implementation tab in the properties.
- Under Implementation, select the User Task or System
Task option from the displayed list.
- Click the Select button to choose an external implementation from the
library.
- In the Task Header section, specify the following properties:
Table 1. Properties in the Task Header sectionProperty |
Action |
Subject |
Type a descriptive subject for the task that is generated in IBM Process
Portal when you run the process. You can also
use the IBM Business Process Manager embedded JavaScript syntax
(for example, <#=tw.local.mySubject#>) to express the subject. |
Narrative |
Type an optional description. You can also use the IBM BPM embedded JavaScript syntax to express the
narrative. Restriction: Do not use JavaScript variable references in task narratives if
you need the data to be available after the task completes. Once a task is complete, IBM BPM removes
the data for completed tasks to conserve space. Instead, store the data items in another location,
such as a
database.
|
Note: For the following properties (in the Priority Settings section) you can click the JS button
for an option if you prefer to use a JavaScript expression with predefined variables to establish
the priority settings.
- For the Priority field, select one of the default priority codes: Very Urgent, Urgent, Normal,
Low, or Very Low. You can also use a JavaScript expression with predefined variables to establish
the priority settings.
- Enter the Due In date in one of the following ways:
- Enter a value in the text box and then choose Minutes, Hours, or Days.
Do not set a due
in value greater than 800 Hours, Minutes, or Days as it decreases performance. Instead, use a
JavaScript expression to directly set the due date.
- Enter JavaScript. You must return a TWDate object
- Select an existing variable from the library. At run time, the variable should reflect the
value that you want for the time period. Be sure to select the option that you want from the
drop-down list: Minutes, Hours, or Days.
- For the Time Zone field, select the time zone that you want to apply to the tasks that result
from the current activity. For example, you can select US/Pacific for users
who work in California.
- For the Holiday Schedule field, you can leave the setting at (use default) as
described in the preceding note or you can click the JS button if you prefer to use a JavaScript
expression. Each Holiday Schedule is made up of a list of Dates.
You can leave the Time Schedule, Timezone, and Holiday Schedule fields set to (use default). If
you do, the work schedule specified for the process used. See Setting the work schedule for a process for more information.
If you choose JavaScript, you can enter either a String (or String-generated JavaScript) or
JavaScript that returns a TWHolidaySchedule variable. If you use a String, then IBM BPM looks up the holiday schedule by name according
to those rules. If you use a TWHolidaySchedule variable, then IBM BPM assumes that the holiday schedule is filled in
appropriately. (Go to the System Data toolkit and open the TWHolidaySchedule variable to view its
parameters.)
- Click the Data Mapping tab in the properties.
Because you added the input and output parameters for the external implementation when you
created it, the Data Mapping tab for the activity in the process should include those
parameters.
Under Input Mapping, click the auto-map icon in the upper-right corner, and then click the
auto-map icon in the upper-right corner of the Output Mapping section. For more information about
mapping variables, see Business objects and variables in Process Designer.
- Click Save or Finish Editing.