Using the Throw Element

Use this activity to signal an internal fault.

Usage

In defining the properties of this element, you can specify a fault name and a fault variable. These details can then be passed onto a fault handler that is configured to deal with this kind of exception.

Throw Element Properties

The Throw element properties are:

• Name: The name of the element.

• Fault Name: The Fault Name is a QName. You can use any name. The dialog box lets you choose a standard or already defined fault or specify a new one. The next time the dialog box is opened, the newly defined faults appear inside of User Defined Faults folder. These are collected from the current BPEL file only. Clicking the ellipsis button (...) invokes the Fault Name dialog box.

  You can use the WSDL Editor to add fault definitions to the WSDL file. For more information, see the Configuring Port Types Using the WSDL View section of Using the WSDL Editor.

• Fault Variable: Click the ellipsis button to specify the name of the variable, already declared in the BPEL file, that will contain the fault message.

• Documentation: User documentation attached to the element. This documentation is included with the source code of the BPEL process and can be extracted and included in a report.