Generate Error

This activity generates an error and causes an immediate transition to any error transitions. If there are no error transitions, the process instance halts execution. This activity is useful in a group or in a called process. If you would like to catch and raise your own error conditions, you can use this activity to do so.

For example, for a process that calls a subprocess to check the credit of a customer, you can use the Generate Error activity to raise an error for any error conditions, such as the customer does not exist, or the customer has no credit available. In the called subprocess, create a transition to the Generate Error activity after detecting the error condition and the called process terminates. Processing continues with an error in the calling process. An error transition on the Call Process activity can handle the error.

Figure 9 illustrates the example described above.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about handling errors in process definitions.

The Configuration tab has the following fields.

Field	Description
Name	The name to appear as the label for the activity in the process definition.
Description	Short description of the activity.
Select Error Schema	The process error schema to send to the parent process. - Default - specifies that the error should be propagated only in the $_error process variable. Process error schemas are defined on the Error Schemas tab of the End activity for the process. The schema specified in this field is added to the Input schema for this activity. Data mapped to the error schema is propagated to the parent process. See TIBCO ActiveMatrix BusinessWorks Process Design for more information about specifying process error schemas.

Field

Description

Name

The name to appear as the label for the activity in the process definition.

Description

Short description of the activity.

Select Error Schema

The process error schema to send to the parent process. - Default - specifies that the error should be propagated only in the $_error process variable.

Process error schemas are defined on the Error Schemas tab of the End activity for the process. The schema specified in this field is added to the Input schema for this activity. Data mapped to the error schema is propagated to the parent process.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about specifying process error schemas.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about mapping and transforming input data.

Input Item	Datatype	Description
message	string	The text of the error message to generate.
messageCode	string	The error code of the error. This is used as an identifier for the error so that applications can test for the error.
data	complex	The schema specified in the Select Error Schema field of the Configuration tab is contained in this input item. Map data from the list of process variables to this input item to propagate the data to the parent process.

The text of the error message to generate.

messageCode

string

The error code of the error. This is used as an identifier for the error so that applications can test for the error.

data

complex

The schema specified in the Select Error Schema field of the Configuration tab is contained in this input item. Map data from the list of process variables to this input item to propagate the data to the parent process.