An exception is a fatal processing error in the service, such that
valid data cannot be returned using the normal return value process. The
system can return other, non-fatal activity status information to the
client as part of the return value.
All fields are optional.
Field
|
Description
|
| Condition
|
 Select the condition that causes the
system to return the specified data:
When — The system evaluates the when
condition rule specified by the When Key. If
the condition evaluates to true, the system
returns an exception with the specified data. If the
condition evaluates to false, the system
continues evaluating the next when condition rule in the
list. If all specified when conditions are 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 being
returned to the client.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
|
If the condition value is
When, specify the second key part of the when
condition rule to be evaluated.
If the condition value is Mapping Error, Security
Error or Service Error, leave this field
blank.
|
| Map
From
|
Select how the system maps the output
data from the clipboard data:
Clipboard — The system maps the data
value from the scalar property specified by the Map
From key.Constant — The system returns a fixed
value.XML Stream — The system composes a
stream of XML text formatted by an XML Stream rule.HTML Stream — The system composes a
stream of HTML text formatted by an HTML rule.HTML Frame — The system returns a
stream of HTML data generated by the service activity.
|
| Key
|
Identify a source for the Map
From value:
- If the Map From value is
Clipboard, enter the property name to which the
data is to be mapped.
- If the Map From value is
Constant, enter a literal string. To include
blank spaces in your text string, surround the string with
double quotes.
- If the Map From value is
XML
Stream, enter a Stream Name key part
of the XML Stream rule that is to generate the data. The
system uses the Primary Page Class of the
service as the Applies To key part of the
XML Stream rule.
- If the Map From value is
HTML
Stream, enter the Stream Name key
part of the HTML rule that is to generate the data stream.
The system uses the Primary Page Class of
the service as the Applies To key part.
- If the Map From value is
HTML
Frame, enter the name of the frame specified in the
Show-HTML step of the service activity. Use this to return
data from activities that were originally written for
interactive browser clients and use the Show-HTML
method.
|
Service COM form