DocumentObj 2.5 CheckOut
Checks out an object and locks it for other users.
Objects can only be checked out if:
- The user has write access for the object.
- No one else has checked out the object.
- The object is not part of a released publication.
Parameters
| Name | Type | Direction | Description |
|---|---|---|---|
| psAuthContext | String | InOut | Deprecated 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. |
| psLogicalId | String | In | The logical identifier of the object. |
| psVersion | String | InOut | The version of the object. When no exact version is given, the version number will be returned. |
| psLanguage | String | In | The (working) language of the object. |
| psResolution | String | In | The resolution of the object. Only used for illustrations: this parameter should be empty for any other object types. |
| psXMLRequiredCurrentMetadata | String | In | Metadata 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. |
| psXMLRequestedMetadata | String | In | Requested Metadata XML structure indicating which metadata has to be retrieved for a given object. |
| psOutXMLObjList | String | Out | ObjectList XML structure containing both the object content (base 64 encoded) and the requested metadata. |
Note that:
- The user name of the user who checked out the object is stored in the metadata field
CHECKED-OUT-BY. - If the object is already checked out by someone else, an exception will be thrown that contains the user name of the user that checked out the object.
- All logical identifiers within Content Manager are in uppercase.
- The parameter
psLngis only used to retrieve the object in the desired language. - The result is no longer a byte stream with the requested object but an ObjectList containing both the object and its metadata. Like this metadata can also be returned for objects that are not XML and the returned metadata does not imply DTD modifications.
- Although an object is checked out, metadata changes are on the object are still allowed.