Documentation Center

DocumentObj 2.5 DeleteByIshLngRef

Deletes a particular language of an Content Manager 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.
plLngRefLongInThe language level identifier.
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.
ActionDelete will fail...Result
Delete language
  • 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.

Delete last language of the version
  • 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 and version is deleted.

Delete last language of a map with the single version
  • If the map is referenced by another map
  • If the map is the main map of a publication
  • 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
The complete map is deleted including the last version and logical object.
Note that:
  • 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.