Service JSR94 form - Completing the Exceptions tab

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

Note: Service JSR94 rules are no longer being actively developed, and are being considered for deprecation in upcoming releases. Using Service JSR94 rules does not follow Pega development best practices. Consider other implementation options instead.

Field Description
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.