Documentation Center

DocumentObj 2.5 Delete

Deletes a particular version and language of an InfoShare object.


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.
psLogicalIdStringInThe logical identifier of the object.
psVersionStringInThe version of the object. This version number has to be an exact number.
psLanguageStringInThe language of the object.
psResolutionStringInThe resolution of the object. Only used for illustrations: this parameter should be empty for any other object types.
psXMLRequiredCurrentMetadataStringInMetadata XML structure with the metadata that object is required to have set currently. The update of the object is only carried out when the object has exactly the same metadata specification, i.e. the metadata was not changed by someone else.

Requirements are:
  • The user must have write access for the folder in which the object is going to be deleted.
The table describes the behavior depending on your starting situation. [SRQ-3834]
ActionDelete will fail...Result
Delete the map starting from the logical object
  • If the map is referenced by another map
  • If the map is the main map of a publication
  • If one of the languages is used in a released publication output
  • If one of the languages is released (and the user is no Administrator)
  • If one of the languages is checked out
The complete map is deleted including all versions and languages
Delete one version of a map
  • If there is a branch on this version
  • If one of the languages is used in a released publication output
  • If one of the languages is released (and the user is no Administrator)
  • If one of the languages is checked out
The version including all languages is deleted

Note that: if the version is the last in the logical object - logical object also will be deleted.

Delete one language of a map
  • If the object is used in a released publication output
  • If the object is released (and the user is no Administrator)
  • If the object is checked out
This language is deleted.

Note that: if the language is the last in the version - version also will be deleted.

Note that:
  • All logical identifiers within Content Manager are in uppercase.
  • The parameter psXMLRequiredCurrentMetaData can be used to require that the delete only is carried out when the object is still in the same state as the users thinks it is.
  • Deleting logical object that is referenced by the other object (as a link, hyperlink etc.) is not allowed.
  • Deleting logical object that is used as a resource on a publication is not allowed.
  • Deleting logical object that is used as a master on a publication is not allowed.
  • Deleting version object that has a branch started from it is not allowed.
  • Deleting version object is not allowed if one of the language objects is not allowed to be deleted.
  • Deleting language object that is a part of a released publication output is not allowed.
  • When the language object is in a released status type, only administrators can delete the language object.
  • Deleting language object that is checked out is not allowed.