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 properties of the Throw element are configured from the Properties window.

The options are:

• Name

• 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 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.