Business Processes and Rules: Siebel Enterprise Application Integration > Data Mapping Using Scripts > Exception Handling Considerations >
Exception Handling Functions
When writing your data transformation scripts, you can use the following functions to handle error conditions:
- EAIRaiseError
- EAIRaiseErrorCode
- EAIFormatMessage
NOTE: Before proceeding, read Exception Handling Considerations.
EAIRaiseError() Method
This method raises a fatal error and terminates the script. Table 56 presents the parameters for this method. Syntax
EAIRaiseError(msg [, formatParameters])
Table 56. Parameters for EAIRaiseError() Method
|
|
msg |
Error message text from the Data Mapping Engine. |
formatParameters |
Optional string arguments inserted in the return value in the positions specified by the positional arguments in the msg parameter. A maximum of nine format parameters are allowed. |
Usage
You can provide format parameters to format the message text. For details, see EAIFormatMessage() Method. EAIRaiseErrorCode() Method
This method raises a fatal error, terminates the script, and returns an error symbol that it receives from the business service. Syntax
EAIRaiseErrorCode(errorSymbol, msg) Usage
You can use this function when you want to pass an error symbol to a workflow as an indication to branch on an exception. If you are not branching on the specific error code in your workflow, use EAIRaiseError instead. EAIFormatMessage() Method
This method formats strings that have position-independent arguments. Table 57 presents the parameters for this method. Syntax
EAIFormatMessage(msg [, formatParameters])
Table 57. Parameters for EAIFormatMessage() Method
|
|
msg |
A string that contains positional arguments. The substitution operation replaces the percent sign followed by a digit with the corresponding format parameter. |
formatParameters |
Optional string arguments inserted in the return value in the positions specified by the positional arguments in the msg parameter. A maximum of nine format parameters are allowed. |
Returns
A string of the formatParameters argument values in the positions specified by the positional arguments included in the msg parameter. Usage
You can use this function to generate messages from strings that are translated and whose positions have changed as a result of the translation. Example
EAIFormatMessage("Data: '%2', '%3', '%1'", "A", "B", "C")
returns the string: "Data: 'B', 'C', 'A'"
|