You are here: Reference > Rule types > Service JSR94s > Service JSR94 form - Completing the Exceptions tab

Service JSR94 form
Completing the Exceptions tab

  1. About 
  2. New 
  3. Service 
  4. Request 
  5. Response 
  6. Exceptions 
  7. History 
  8. More... 

Complete the optional Exceptions tab to define responses to the client when exceptions occur.

Field

Description

Exception Conditions

add row 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.

About Service JSR94 rules