Service dotNet form - Completing the Faults tab

Use the Faults tab to specify data returned to the client application when the service encounters a fatal processing error and must return a SOAP Fault message. You can also use the Faults tab for other conditions that you want to cause SOAP Fault messages to be returned.

Important: Service dotNet rules are no longer being actively developed, and are being considered for deprecation in upcoming releases. Using Service dotNet rules does not follow Pega development best practices. Use Service SOAP rules instead. For more information, see Service SOAP rules.

A fault is a fatal processing error in the service, such that valid data cannot be returned by the normal output parameter process. You can also have the system return other, non-fatal activity status information to the client as the value of a response parameter set on the Response tab.

Field Description
Condition Select the condition that causes the system to return the data you specify:
  • When — The system evaluates the when condition rule specified by the When Key field. If the condition evaluates to true, the system returns an exception with the specified data. If false, the system continues evaluating the next when condition rule in the list. If all specified when condition rules return false, the system returns the normal response data specified on the Parameters tab to the client application. Use this feature to extend the normal set of fatal error conditions that result in exceptions returned to the client.
  • Queue When — The system evaluates the when condition rule specified by the When Key field. If the condition evaluates to true, the system queues the service request and returns a PRPC-specific SOAP fault that includes the queue item ID of the service request. To customize the fault reason string provided in the SOAP fault, select Constant from the Map From field and enter a string like "Object was locked - queued for retry." (The queue item ID is provided in the SOAP fault detail string, so you do not need to explicitly include it in the mapping.) Note that if you configure a Queue When condition, you must specify a request processor in the Request Processor field on the Service tab. For more information, see Pega Community article Configure a service to queue a failed service request for another attempt.
  • Mapping Error — If an error occurs while mapping incoming data from the request message to the clipboard, the system returns an exception with the specified data. If the list of response conditions does not include an entry for mapping errors, the system returns a standard exception to the client application.
  • Security Error — If an error occurs while authenticating the application client credentials, the system returns an exception with the specified data. If the list of response conditions does not include an entry for security errors, the system returns a standard exception to the client application.
  • Service Error — If a valid instance of the service activity cannot be found, the system returns an exception with the specified data. If the list of response conditions does not include an entry for service errors, the system returns a standard exception to the client application.
When Key Optional. If the Condition value is When, specify the key of the when condition rule to be evaluated. Otherwise, leave this blank.
Map From Select how the system finds the output data for the fault message:
  • Clipboard — The system maps the data value from the scalar property specified by the Map From key. This option may only be selected when a 'When' condition is being used.
  • Constant — The system returns a fixed value.
  • XML Stream — The system composes a stream of XML data formatted using an XML Stream rule. This option may only be selected when a 'When' condition is being used.
  • HTML Stream — The system composes a stream of HTML data formatted by an HTML rule. This option may only be selected when a 'When' condition is being used.
  • HTML Frame — The system returns a stream of HTML data generated by the service activity.
  • RequestorID — Send a text value identifying the current requestor session.
Map From Key Identify a source for the Map From selection:
  • If the Map From value is Clipboard, identify the property that is the source of the value. This option is only selectable when a 'When' condition is being used.
  • If you selected Constant, enter a literal text string. To include blank spaces in your text string, surround it with double quotes.
  • For XML Stream, enter the Stream Name of the XML Stream rule that is to generate the data. The Primary Page Class of the service is the class of the XML rule. Enter only the Stream Name key part.
  • For HTML Stream, enter the Stream Name of the HTML rule that is to generate the data stream. The system uses the Primary Page Class of the service as the class of the HTML rule. Enter only the Stream Name key part.
  • If the Map From value is HTML Frame, enter the name of the Frame specified in a Show-HTML step of the service activity. Use this to return data from activities that were originally written for interactive browser clients and so contain the Show-HTML method.
  • For RequestorID, leave this blank.
Fault Detail Key Enter the Stream Name (second key part) of the XML Stream rule that is used to generate the data. The system uses the Primary Page Class of the service as the Applies To class of the XML Stream rule. Enter only the Stream Name key part. This option may only be selected when 'XML Stream' is selected as the MapFrom value.

About Service dotNet rules