Documentation Center

Annotation 2.5 Find

Describe how to find the metadata information for annotations (and replies).

Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services, making this parameter redundant.
psXMLMetadataFilterStringInAnnotation Metadata Filter XML structure with additional filter on metadata to limit the annotations on which metadata has to be returned.
psXMLRequestedMetadataStringInRequested Annotation Metadata XML structure indicating which metadata has to be retrieved for the annotations
psOutXMLObjListStringInOutThe Annotation ObjectList XML structure containing the metadata of the annotations (and replies)

Note that:
  • All logical identifiers within Content Manager are in uppercase.
  • The order of the returned objects in psOutXMLObjList is random.

Scenarios

Depending on the requested metadata and the filter metadata annotations, with or without replies are returned.

Here are possible scenarios:

ScenarioAnnotation without repliesAnnotation with replies
Find only annotation information.The requested metadata of the annotation is returned (if the annotation matches the filtering).Only the information of the annotation is returned (if the annotation matches the filtering).
Find annotation and reply information, but filter only on the 'annotation' level.The requested metadata of the annotation is returned (if the annotation matches the filtering).The requested information of the annotation and the replies are returned (if the annotation matches the filtering).
Filter on annotation and reply information.The annotation is not returnedbecause, by definition, it cannot match the filtering on the reply information.The requested information of the annotation and the replies are returned (if the annotation and the reply match the filtering).