The Fail component aborts the parent job (jobflow or graph) with a user-specified error message.

Component	Same input metadata	Sorted inputs	Inputs	Outputs	Each to all outputs	Java	CTL	Auto-propagated metadata
Fail			0-1	0

The input field errorMessage is automatically used for a user-specific error message, which interrupts the job, if it is not otherwise specified in mapping.

Fail interrupts a parent job (jobflow or graph). The first incoming token to the component throws an exception (org.jetel.exception.UserAbortException) with a user defined error message. The job finishes immediately with a final status ERROR. Moreover, the dictionary content can be changed before the job is interrupted. In general, the component allows to interrupt the job and return some results through the dictionary, at the same time.

The Fail component works even without an input port attached. In this case, the job is interrupted immediately when the phase with the Fail component is started up.

Mapping details

Mapping in the Fail component is generally used for two purposes:

• Assembling of an error message from an incoming record.

• Populating dictionary content from an incoming record.

  	Note
  	Only output dictionary entries can be changed.

Figure 59.2. Example of mapping for the Fail component

The error message compiled by the mapping has the highest priority. If the mapping does not set errorMessage, the error message from the component attribute is used instead. If even this attribute is not set, predefined text user abort is used instead.