Retrieves the exception subtype from the exception object.
Returns a String that contains the exception subtype for the current exception. For more information on valid exception subtypes, see the Notes section.
This function block is based on the collaborationException.getSubType() method. For more information, see getSubType().
For exceptions whose exception type does not adequately identify the cause of the exception, the exception subtype can provide more information. The following exception types most commonly use exception subtypes:
The collaboration runtime environment catches Java exceptions and wraps them in a collaboration exception with an associated type of Java exception. A collaboration can use the Get Subtype function block on the collaboration exception to retrieve the original type of the Java exception (that is, the class name of the captured Java exception). However, this is not typically necessary.
The ServiceCallException exception type occurs if any failure results from a service call. To develop more robust collaborations, you can use the exception subtype to determine the cause of the service-call failure. The valid exception subtypes include:
AppTimeOut | A connector was unable to complete communication with its application. |
AppLogOnFailure | A connector was unable to log in to the application. |
AppRetrieveByContentFailed | A Retrieve by non-key values, performed on the application, was not able to find any match. |
AppMultipleHits
| An application found and retrieved more than one entity in response to a Retrieve request. |
AppBusObjDoesNotExist | A Retrieve operation was performed on the application, but the entity that the business object represents does not exist in the application database. |
AppRequestNotYetSent | In the case of a parallel connector agent, the request was queued up in the agent master but never got dispatched to the application; therefore, you can resend the request. For more information, see Unsent service call requests. |
ServiceCallTransportException | There was an error in the transport, and it cannot be determined with certainty whether the request reached the application. For more information, see Handling runtime transport-related exceptions. |
AppUnknown | Any type of error that is not one of the other subtypes. If this exception subtype is present, the application operation requested in the service call might be finished or not finished. |