Documentation Center

General changes in behavior within Web services 2.5

This topic gives an overview of the general changes in behavior within Web Services 2.5 .

New value label for ishvaluetype
Prior to Tridion Docs 15.1, the ishvaluetype attribute, which identifies which type of value of a metadata field is being used, had the following possible values:
  • id for the unique numerical identifier of the metadata field
  • element for the unique string identifier of the metadata field
  • value for the value of the metadata field
As from Tridion Docs 15.1, ishvaluetype can have an additional value: label, which designates one of the following:
  • For User Card Reference fields like FAUTHOR or FTRANSLATOR, it designates the display name of the user (typically the full, human-readable name of the person). So for the user object whose metadata field value (returned when ishvaluetype is set to value) is fkahlo, its label might be "Frida Kahlo".
  • For Logical Content Object Reference fields like FMASTERREF or FISHRESOURCES, it designates the title (the Logical Object Title, that is, the FTITLE field) of the object. For example, a map object may have a string identifier (returned when ishvaluetype is set to element) that is set to GUID-980A28AC-C16B-463C-8FF1-9EDCB0E3A16C. (The value, returned when ishvaluetype is set to value, is the same GUID value.) The label of this map might be "Workflow implementation map", that is, the title of the map in Content Manager.
The new label value:
  • can only be used for requested metadata. If you use it when filtering or setting metadata, an exception is thrown.
  • is currently only used for card reference fields linked with users or the logical level of maps, Library Topics, topics, images and templates