Documentation Center

Annotation 2.5 Create

Create a new annotation.


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.
psXMLMetadataStringInMetadata XML structure with the metadata for the annotation
psOutAnnotationIdStringOutThe unique identifier of the newly created annotation

Requirements are:

  • The user must have read access to the map or topic on which you make the annotation.
Note that:
  • All logical identifiers within Content Manager are in uppercase.
  • The annotation is linked to a specific revision of a topic via the field FISHREVISIONID.
  • The Logical ID (FISHCONTENTOBJLOGICALID), version number (FISHCONTENTOBJVERSION) and language (FISHCONTENTOBJLANGUAGE) matching that revision are also stored in the database to allow filtering. If these fields are provided via the incoming psXMLMetadata, the code will check that they match with the supplied revision, otherwise the code will retrieve and set the fields automatically.
  • It is not possible to create replies using this method. Use the specific CreateReply method to handle replies.