Manual Ad-hoc Task

What is an ad-hoc task in BPME?

An ad-hoc task is a standalone task in a business process that is performed after the business process instance starts in BPME. You can have several ad-hoc tasks in a process. One ad-hoc task can be executed multiple times. The preconditions for ad-hoc tasks added in Studio determine when they become available for execution by the permitted users. An ad-hoc task might not be triggered at all during the entire course of the process instance. An ad-hoc task is not part of the flow of events, so it does not have an incoming or outgoing flow during the lifetime of a process.

What is a manual ad-hoc task in BPME?

An ad-hoc task can be invoked manually when the preconditions are enabled. However, the appropriate privileges should be added to the user to start and cancel that task. Manual ad-hoc tasks create a work-item or call a subprocess. For more details, see TIBCO Business Studio™ - BPM Edition Modeling Guide.

How to execute manual ad-hoc tasks?

You can define manual ad-hoc tasks for all the processes, including the processes that use case data (except for page-flows.) If a manual ad-hoc task is defined in a process, you can execute it from the following options:

• Process Manager in Administrator

• Case Manager (in case the processes use case data)

• Work Views in Work Manager

• Work Item form

The following table contains information about each ad-hoc task.

Option	Description
Ad-Hoc Task Name	The name of the ad-hoc task is defined in the process in TIBCO Business Studio at design-time.
Process Instance ID	The ID of the process instance from which the ad-hoc task is performed.
Case ID	The case ID associated with the ad-hoc task. (Only applies to the Case Manager).
Process Name	The name of the process from which the ad-hoc task is performed.
	Disabled option to display an ad-hoc task.
	Enabled option to display an ad-hoc task after you select the check box before a work item, case id, or process instance id.
	The ad-hoc task has not started.
	The ad-hoc task is currently running.
	The ad-hoc task can be started multiple times.
	The ad-hoc task has been completed.
	Additional details of an ad-hoc task that has been completed. This indicates that the task has run once. This task may have been configured to run once or multiple times.
	Additional details of an ad-hoc task that has been completed. This task has been configured to run multiple times. Currently, it has run 6 times.
	Additional details of an ad-hoc task that has not been completed. This task might have been configured to run once or multiple times. But, it has either just started, or not started at all.
	The ad-hoc task is disabled and might not be executed. For example, there might be a precondition for this task that is not satisfied and so is not started.
	Click this to start an ad-hoc task that can be started multiple times.
	Click this to start an ad-hoc task that can be started once.
	Select this to cancel the ad-hoc task currently in progress.
	Manual ad-hoc task
	Automatic ad-hoc task Note: You cannot start an automatic ad-hoc task manually.
	Refresh the information in the dialog box or current window.

Execute Manual Ad-hoc Tasks

You can execute the manual ad-hoc tasks by performing the following steps:

• The user who executes a manual ad-hoc task is assigned the startAndCancelAdHocActivity system action privileges to view the ad-hoc windows. Privileges might be applied to each ad-hoc task that is required to start an instance.

• The process instance is started.

Procedure
1. Select the Start icon to start the ad-hoc activity.
   When an ad-hoc activity is started, its status changes to . You can select the Cancel option at any time to cancel the ad-hoc activity.
   
2. Process the work item. For more information, see Processing Work Items.
3. Once the work item is complete, the ad-hoc activity displays either or , depending on whether or not the activity can be executed again.
4. You can refresh the page at any time by clicking the Refresh icon.
5. Select Close to close the ad-hoc activity page.

Top