RIXML Documentation

KeywordClassifications

RIXML 2.5 Element

Level OneRequired

Serves as a container element for organizing free-text search terms associated with research content. Acts purely as a structural wrapper without carrying semantic meaning itself.

Usage

Include at most one KeywordClassifications element within ProductClassifications when research content needs keyword-based searchability. Must contain at least one child Keyword element if present.

Business Context

Enables full-text search capabilities and content discovery within research management systems, helping analysts and clients locate relevant materials using natural language terms.

Source:level-one-2.5
Schema:RIXML-Common-2_5.xsd:1485

Specification Guide

Overview

KeywordClassifications is a container element that groups free-text Keyword tags associated with a research product. It carries no semantic content of its own — it exists purely as an organisational wrapper that bundles one or more keyword terms within the classifications portion of a research product's context. By providing an open, free-text companion to the structured classification elements (such as AssetClasses, SectorIndustries, Regions and Disciplines), it enables publisher-defined search terms and tags that improve discoverability in distribution and search systems.

Usage

KeywordClassifications appears at most once as an optional child of ProductClassifications, on the path Research.Product.Context.ProductClassifications.KeywordClassifications (sources: level-one-2.2 p.26, level-one-2.5 p.20). When present, it must contain at least one Keyword child element; multiple keywords are permitted and encouraged for comprehensive tagging (sources: data-dictionary-2.4 p.46, data-dictionary-2.5.1 p.49). Use it when the publisher wishes to attach natural-language search terms that complement — rather than replace — the structured taxonomy elements. Keywords should generally be expressed in the same language as the parent Research element's language attribute [data-dictionary-2.5.1 p.49]. If no keywords are needed, omit the container entirely rather than including it empty.

Rules

  • MUSTWhen KeywordClassifications is present within ProductClassifications, it must contain at least one Keyword child element.[RIXML Level One Addendum v2.2 p.26] [RIXML Level One Addendum v2.3 p.21] [RIXML Level One Addendum v2.3.1 p.21] [RIXML Level One Addendum v2.4 p.20] [RIXML Level One Addendum v2.5 p.21] [RIXML Research Data Dictionary v2.4 p.46] [RIXML Research Data Dictionary v2.5.1 p.49]
  • MUSTAt most one KeywordClassifications element may appear within a single ProductClassifications.[RIXML Level One Addendum v2.3.1 p.20] [RIXML Level One Addendum v2.5 p.20]
  • SHOULDKeywords carried within KeywordClassifications should be expressed in the same language as the language attribute of the parent Research element.[RIXML Research Data Dictionary v2.5.1 p.49]

Relationships

Where It Fits

Canonical Path

Children

Definition

Type
Namespacehttp://www.rixml.org/2017/9/RIXML
Min Occurs1
Max Occurs1

Attributes

No attributes defined for this element

Children

Keywordstring1..unbounded
requiredSince 2.1

Example

<KeywordClassifications>
  <Keyword> ... </Keyword>
</KeywordClassifications>

Version History

Unchanged since introduction in RIXML 2.1

KeywordClassifications is present in RIXML 2.x from at least version 2.1 onward and retains the same structure — an optional container within ProductClassifications requiring one or more Keyword children — through 2.2, 2.3, 2.3.1, 2.4 and 2.5 (sources: user-guide-2.1 p.32, level-one-2.2 p.26, level-one-2.5 p.20). No substantive changes to its content model are recorded across the 2.x line. The RIXML 3.0 draft replaces KeywordClassifications with a new ExpectedSearchTermList element as part of a broader rework of search-term metadata to improve findability [data-dictionary-v3-draft p.77]. Implementers targeting 3.0 should migrate keyword tagging to the new construct.

Business Rules

MUST

The KeywordClassifications element must include at least one Keyword element when present

validationconditional-requirement

Semantic Relationships

Requires1 relationship

KeywordMUST

KeywordClassifications element must contain at least one Keyword child element

RIXML Level One Addendum v2.5, p.21Research.Product.Context.ProductClassifications.KeywordClassifications.Keyword