|
Exception Conditions
|
Define rows of this array, identifying the responses under each type of exception.
Rows for
When errors
are evaluated in sequence. The order of other entries is not significant.
|
|
Condition
|
Select:
-
Mapping error
— If an error occurs while mapping incoming data from the request message to the clipboard, the system returns the response message specified in this row.
-
Security error
— — If an error occurs while authenticating the application client credentials, the system returns the response message specified in this row.
-
Service error
— If the service activity cannot be found, the system sends the response message data specified in this row.
-
When error
— The system evaluates the when condition specified by the
When Key
field. If true, return the response message data specified in this row. If false, continue evaluating the next when condition rule in this array. If all specified when condition rules are false, return the default response data. Use this feature to extend the normal set of fatal error conditions that result in exceptions being returned to the client.
If a runtime exception occurs but this array does not include an entry for the exception condition, the system returns a standard error report message to the client application.
|
|
When Key
|
If the
Condition
value is
When, specify the name of the when condition rule to be evaluated. Otherwise, leave this field blank.
|
|
Map From
|
Select how the system creates response values.
-
Clipboard
— The system maps the data value to the scalar property specified by the
Map From
key.
-
Constant
— The system sends a fixed value.
-
XML Stream
— The system evaluates and returns the results of an XML Stream rule.
-
HTML Stream
— The system evaluates and returns the results of an HTML rule defining a complete page.
-
HTML Frame
— The system evaluates and returns the results of an HTML rule defining a frame within an HTML page.
If more choices appear, they identify a custom function rule in a
MapFrom
library. Review the function rule to determine what it does.
|
|
Map From Key
|
Identify the source of the
Map From
value:
-
If the
Map From
value is
Clipboard, enter the property name from which to map the data for the reply. This property can be an embedded
Page List
property with a page class that inherits from the
Embed-Java-
class (that is, it is a
Java Page
property), or a property of mode
Java Object List.
-
For
Constant, enter a literal string. To include blank spaces in your text string, surround the string with double quotes.
-
For
XML Stream, identify the
Stream Name
key part of an XML Stream rule. To find the rule, the system uses the class in the
Page Class
field of the
Service
tab as the
Applies To
key part and
MapFrom
as the final key part.
-
For
HTML Stream
and
HTML Frame, identify the
Stream Name
key part of an HTML rule. To find the HTML rule, the system uses the class in the
Page Class
field of the
Service
tab as the
Applies To
key part.
|