ThesaurusField

Introduction

A ThesaurusField is a complex field which describes a single concept from a thesaurus. It contains as children both the URI and a label for each language configured.

ThesaurusUriField contains the URI of a concept
ThesaurusLabelField contains the breadcrumb of a label in a particular language

Example

The field https://mediahaven.atlassian.net/wiki/spaces/CS/pages/2870018234/Metadata+21.3#LimitedCategories is an example containing a list of thesaurus fields.

"LimitedCategories": {
   "Category": [
      {
          "En": "architecture > building",
          "Nl": "architectuur > gebouw",
          "Uri": "https://mh-dev.mediahaven.com/thesaurus/conceptschemes/mhdevLimitedCategoriesCategory/c/27"
      },
      {
          "En": "types > textile",
          "Nl": "types > textiel",
          "Uri": "https://mh-dev.mediahaven.com/thesaurus/conceptschemes/mhdevLimitedCategoriesCategory/c/50"
      }
  ]
}

Enhancement

When updating metadata with the thesaurus field containing only a single label, the system automatically attempts to find the linked concept and fill out both the URI and other labels. If the concept is not found an error is thrown.

For example the metadata below is enough to automatically enhance it to the metadata above.

"LimitedCategories": {
  "Category": [
    { "En": "building" },
    { "Nl": "textiel"  }
  ]
}

Structure

Field	Extends	Description	Search queries on this field
`ThesaurusField`	`MapField`		N/A
`ThesaurusUriField`	`SimpleField`	URI of the concept	Match with the URI, the preferred and non-preferred labels from all languages, including all ancestors.
`ThesaurusLabelField`	`SimpleField`	One definition for each language	Match with preferred and non-preferred labels from this specific language, including all ancestors.

Indexation

Overhauled in version 24.4 for stronger performance

Before 24.4 a specialised plugin in our search was used.

For each ThesaurusUriField and ThesaurusLabelField a variant field with suffix _index is created. For example for the label Descriptive.LimitedCategories.Category.Uri and variant Descriptive.LimitedCategories.Category.Uri_index is created to contain all expanded terms such as URI, preferred and non-preferred labels, as described in https://mediahaven.atlassian.net/wiki/spaces/CS/pages/edit-v2/2988474369#Structure.

Global

When the thesaurus URI field is marked as global, the global search will also match the object based on the preferred and non-preferred labels from all languages, including all ancestors.