Weighting
RIXML 2.5 Element
Provides weighting recommendations for countries, regions, asset types, or other entities. Required weighting attribute uses WeightingEnum values, with optional attributes for timeFrame, priorCurrent status, publisher-defined values, and descriptions.
This is information regarding weightings. These can be about the country, region, asset type, or other entities.
Usage
Used to express portfolio allocation recommendations. Required weighting attribute typically uses OverWeight, UnderWeight, or EqualWeight values. Can reference current or prior weightings for comparison.
Business Context
Essential for portfolio management and asset allocation guidance in research products, helping investment professionals understand recommended positioning relative to benchmarks or strategic allocations.
Specification Guide
Overview
Weighting expresses a portfolio allocation recommendation — typically overweight, underweight, or equal-weight — for an investment entity such as a country, region, asset class, asset type, sector/industry, security type, or index. It carries the research provider's relative positioning guidance versus a benchmark, together with optional temporal context (time frame, prior vs. current) so that recipients can interpret allocation changes over time. The element's value space is governed by the required weighting attribute, which draws from WeightingEnum. Optional attributes refine the recommendation with timing (timeFrame, priorCurrent) and publisher-specific extensions.
Usage
Use Weighting wherever the research conveys a benchmark-relative allocation view. Across v2.x it appears as a repeatable child of allocation-bearing entities including Country, Region, AssetClass, AssetType, SecurityType, SectorIndustry, Security, Issuer, and (from 2.1 onwards) Index [RIXML Release Notes v2.1 p.3].
The weighting attribute is required; typical values include OverWeight, UnderWeight, and EqualWeight from WeightingEnum. Optional attributes provide:
- timeFrame — short-term vs. long-term scope, drawn from TermEnum in v3.
- priorCurrent — flags whether the weighting represents the current recommendation or a prior one, supporting before/after comparisons via PriorCurrentTypeEnum.
- A publisher-defined value attribute and (in v2.4+ and v3) an optional Description child for human-readable context.
Multiple Weighting instances may appear under the same parent to express, for example, both a prior and a current recommendation, or differing short- and long-term views [RIXML Research Data Dictionary v2.4 p.63].
Rules
- MUSTThe weighting attribute is required and must contain a value from WeightingEnum (typically
OverWeight,UnderWeight, orEqualWeight).[RIXML Research Data Dictionary v2.5.1 p.66] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.71]↗ - SHOULDModel portfolio research products (identified by ModelPortfolio) should include security-level Weighting entries communicating allocation versus the benchmark.[RIXML Research Data Dictionary v2.5.1 p.130]
- INFORMATIVEWeighting as a child of Country, Region, Issuer, Security, AssetClass, or AssetType is not required by RIXML Level One compliance — Level One implementations may omit it to reduce complexity, but inclusion does not break the full schema.[RIXML Level One Addendum v2.2 p.25] [RIXML Level One Addendum v2.3.1 p.12] [RIXML Level One Addendum v2.3.1 p.14] [RIXML Level One Addendum v2.3.1 p.15] [RIXML Level One Addendum v2.5 p.20]
- SHOULDIn RIXML 3.0, individual Weighting children are grouped under a
WeightingListcontainer, aligning with the standardised*Listcontainer pattern adopted across other repeating elements such as Rating and ProductCategory.[RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.69]↗ [RIXML All-Member Meeting Winter 2024 p.21]↗
Relationships
- constrainsWeightingEnum — The required weighting attribute draws its value from WeightingEnum (
OverWeight,UnderWeight,EqualWeight, etc.). - qualifiesTermEnum — TermEnum qualifies Weighting via the timeFrame attribute, allowing publishers to indicate whether a recommendation is short-term or long-term in nature.
- qualifiesPriorCurrentTypeEnum — priorCurrent uses PriorCurrentTypeEnum to flag whether a weighting represents the current or a prior recommendation, supporting change tracking.
- contained-byIndex — From RIXML 2.1 onwards, Weighting may appear as a child of Index to express benchmark-relative or index-based positioning.
- contained-byCountry — Weighting may appear under Country to express country-level allocation recommendations (not required in Level One).
- contained-byRegion — Weighting may appear under Region to express regional allocation recommendations (not required in Level One).
- contained-byAssetClass — Weighting may appear under AssetClass to express asset-class allocation recommendations.
- contained-byAssetType — Weighting may appear under AssetType to express asset-type allocation recommendations.
- contained-bySectorIndustry — Weighting may appear under SectorIndustry to express sector- or industry-level allocation recommendations.
- contained-bySecurity — Weighting may appear under Security to express security-level allocation views, particularly within model-portfolio products.
- related-toIssuer — The weightingAction attribute on Issuer signals that the publisher is changing the issuer's weighting; the actual values are carried by Weighting children.
Where It Fits
Canonical Path
Definition
| Type | |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
timeFrameTermEnum |
This is the period for which the rating is relevant, as of the date it was established by the authoring entity. optionalSince 2.1 |
priorCurrentPriorCurrentTypeEnum |
Used to indicate whether the rating is current or prior (current is the default). Prior is only used to give reference for a change from a prior rating. Prior is used to indicate what the prior figure was for the period specified in order to give context to the current figure, not to provide the figure for a prior time period. optionalSince 2.1 |
weightingWeightingEnum |
The actual weighting as issued by the authoring entity. requiredSince 2.1 |
Children
PublisherDefinedValuestring0..1 |
Used when the weighting value is PublisherDefined. optionalSince 2.1 |
Descriptionstring0..1 |
A description of the weighting. May include time horizon. optionalSince 2.1 |
Example
<Weighting weighting="Value" />Version History
Unchanged since introduction in RIXML 2.1
2.0 — Weighting is established as a repeatable child on several allocation-bearing elements (Country, Region, AssetClass, AssetType, SecurityType, SectorIndustry, Security, Issuer) with the required weighting attribute and temporal attributes timeFrame and priorCurrent.
2.1 — Attribute descriptions for timeFrame and weighting were clarified, and Weighting became aggregatable under Index to support index/benchmark-relative positioning [RIXML Release Notes v2.1 p.3].
2.3 / 2.4 — Optional publisher-defined value and Description capabilities were emphasised, allowing free-text qualification of the weighting recommendation (sources: user-guide-2.3 p.45, data-dictionary-2.4 p.63).
2.5 — Continues the same model; widely used in model-portfolio products (source: data-dictionary-2.5.1, pp.66, 130).
3.0 (draft) — Individual Weighting entries are wrapped in a new WeightingList container, harmonising with the broader *List container pattern adopted across RIXML 3.0 (e.g. for Rating, ProductCategory). Attribute typing is made explicit: weighting (WeightingEnum, required), timeFrame (TermEnum), priorCurrent (PriorCurrentTypeEnum), plus weightingPublisherDefinedValue (xs:string) and a Description child (sources: data-dictionary-v3-draft pp.69, 71; meeting-2024-winter p.21).
Level One profiles (2.2 – 2.5) — Level One compliance does not require Weighting children under Country, Region, Issuer, Security, AssetClass, or AssetType; full-schema documents may still include them.
Design Decisions
Weighting elements are not permitted within Country elements in Level One
To reduce complexity compared to the full schema while maintaining core functionality for basic country classification
RIXML Level One Addendum v2.5, p.20
Weighting elements are not permitted within Region elements in Level One
To reduce complexity compared to the full schema while maintaining core functionality for basic region classification
RIXML Level One Addendum v2.5, p.20
Weighting Action should be limited to asset allocation recommendations and should not cover individual security assessments
This maintains the strict definition of asset allocation by focusing on portfolio-level recommendations rather than individual security analysis
RIXML Research Data Dictionary v2.5.1, p.19
Semantic Relationships
Qualifies1 relationship
Prior weighting values are used only to provide reference context for changes from previous weightings, not to report historical period weightings
RIXML Research Data Dictionary v2.5.1, p.66— Elements and Attributes
Requires1 relationship
Model portfolio recommendations must include security weightings compared to benchmark allocations
RIXML Research Data Dictionary v2.5.1, p.130— ModelPortfolio
Blocks Action2 relationships
Level One specification prohibits Country elements from containing Weighting child elements
RIXML Level One Addendum v2.5, p.20— Research.Product.Context.ProductClassifications.Country
Level One specification prohibits Region elements from containing Weighting child elements
RIXML Level One Addendum v2.5, p.20— Research.Product.Context.ProductClassifications.Region