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