3.1.4.9 DeleteAnnotation

The DeleteAnnotation operation deletes an Annotation complex type (section 2.2.4.18) from the server (2).

The following is the WSDL port type specification of the DeleteAnnotation WSDL operation.

 <wsdl:operation name="DeleteAnnotation" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input message="tns:DeleteAnnotationSoapIn"/>
   <wsdl:output message="tns:DeleteAnnotationSoapOut"/>
 </wsdl:operation>

The protocol client sends a DeleteAnnotationSoapIn request message (section 3.1.4.9.1.1), and the server (2) responds with a DeleteAnnotationSoapOut response message (section 3.1.4.9.1.2) as follows:

  • The server (2) receives the RepositoryLocation complex type (section 2.2.4.161) of an Annotation.

  • The server (2) MUST delete the Annotation.

Exceptions:

Error code

Description

AnnotationNotEnabled

Annotations are not enabled in the server (2).

AnnotationDeleteNotEnabled

If Annotation Delete is not enabled in the server (2), but this request, which would delete comments, is received, the comments will not be changed on the server (2) and the AnnotationDeleteNotEnabled error code will be returned.

InvalidAnnotation

The annotation does not exist in the server (2).

In case of any other failure, the error code MUST be one of the values specified in section 2.2.2.1.2. A detailed specification of how exceptions are reported by the server (2) is in section 2.2.2.1.