DocumentObj 2.5 TryGetMetadata
Tries to retrieve logical, version, language and resolution metadata information for one object.
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 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. |
| 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 the metadata of the objects. |
Requirements are:
- The user must have read access for the folder holding the object.
Some scenarios on what to expect as result depends on the used supplied parameters and the
Requested Metadata XML:
- When
psLanguageis provided, one logical-version-language object is returned even if only metadata of the logical level is requested. - When the lowest specified level is the version level...
- one logical-version object is returned even if only metadata of the logical level is requested
- an exception is thrown when metadata of the language level is requested
- When only logical level information is needed
- exactly one
ishobjectelement is returned - an exception is thrown when metadata of the language or version level is requested
- exactly one
Note that:
- All logical identifiers within Content Manager are in uppercase.
- When the
Requested Metadata XMLcontains fields of the language level, the language must be supplied.