3.1.4.1.3.12 ExceptionHandlingScopeType

The ExceptionHandlingScopeType complex type specifies a CSOM action that attempts to execute an ordered list of CSOM actions specified by a TryScope element.

If an unhandled exception does not occur, all of the CSOM actions in the list are executed. In addition, the ordered list of CSOM actions specified in the FinallyScope element, if present, is executed.

If an unhandled exception occurs while executing an action specified in a TryScope element, the protocol server MUST catch the exception and MUST NOT execute the remaining CSOM actions specified in the TryScope element. In addition, the ordered list of CSOM actions specified in the CatchScope element, if present, is executed, and then the ordered list of CSOM actions specified in the FinallyScope element, if present, is executed.

If this CSOM action executes successfully, even if the protocol server catches the exception while executing actions inside TryScope element, the protocol server MUST append the CSOM action identifier of this CSOM action and an ExceptionHandlingScopeResponse JSON value, as specified in section 3.1.4.1.8.2.1.2, to the JSON response structure, as specified in section 3.1.4.1.8.2, after executing the CSOM actions specified inside this CSOM action.

If this CSOM action fails and the exception is not handled by an outer ExceptionHandlingScopeSimpleType, as specified in section 3.1.4.1.3.11, or ExceptionHandlingScopeType, as specified in section 3.1.4.1.3.12, the protocol server MUST set the exception information in the ErrorInfo member of the Response Header JSON Value, as specified in section 3.1.4.1.8.1.5.