An exception is a fatal processing error in the service,
such that valid data cannot be returned using the normal output
parameter process. The system can return other, non-fatal
activity status information to the client as the value of an
output parameter.
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 field. 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
|
Optional. If the Condition value is
When, specify the key 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 text generated by the service
activity.
|
| Map From
Key
|
Identify a specific source for the Map
From selection:
- 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 the 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. - 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 CORBA
form