CoveredEntities

RIXML 2.5 Element

Required

A container element that specifies what is being covered, offering choice among various financial entities including AssetClass, AssetType, SecurityType, Issuer, Security, SectorIndustry, Region, Country, Index, Discipline, and Specialty

Usage

Required child element of CoveragePairing with multiple instances allowed, used to define the scope of coverage through selection of relevant financial entities

Business Context

Provides comprehensive coverage specification capability supporting various research focus areas from individual securities to broad market segments, enabling precise research categorization and distribution

Source:data-dictionary-2.5.1

Schema:RIXML-CoverageUpdates-2_5.xsd:111

Specification Guide

Overview

CoveredEntities is a container element that identifies the investment universe receiving research coverage within a coverage pairing. It appears inside CoveragePairing alongside CoveringEntities to express the relationship "these analysts cover these things," where the contents of CoveredEntities enumerate what is being covered — from individual securities and issuers through to entire asset classes, sectors, regions, or research disciplines.

Usage

CoveredEntities is a required child of CoveragePairing within the coverage-updates sidecar schema (sources: data-dictionary-2.4 p.133, data-dictionary-2.5.1 p.137). It is structured as a choice that permits multiple instances of any combination of the following child elements: - AssetClass - AssetType - SecurityType - Issuer - Security - SectorIndustry - Region - Country - Index - Discipline - Specialty (added in 2.5) Use CoveredEntities to express coverage at whatever level of granularity is appropriate: a single Security for a name-level analyst assignment, a SectorIndustry plus Region combination for sector-regional coverage, or an AssetClass for broad asset-class oversight. The pairing semantics imply that every entity listed in the sibling CoveringEntities covers every entity listed here.

Relationships

child-ofCoveragePairing — CoveredEntities is a required child of CoveragePairing; the pairing establishes that all covering entities provide coverage for each specified covered entity.
paired-withCoveringEntities — Within a CoveragePairing, CoveredEntities is the counterpart to CoveringEntities: the former lists what is covered, the latter lists who provides the coverage.
may-containAssetClass — May contain one or more AssetClass entries to define coverage at the asset-class level.
may-containAssetType — May contain one or more AssetType entries.
may-containSecurityType — May contain one or more SecurityType entries.
may-containIssuer — May contain one or more Issuer entries for issuer-level coverage.
may-containSecurity — May contain one or more Security entries for name-level security coverage.
may-containSectorIndustry — May contain one or more SectorIndustry entries for sector or industry coverage.
may-containRegion — May contain one or more Region entries.
may-containCountry — May contain one or more Country entries.
may-containIndex — May contain one or more Index entries for index-level coverage.
may-containDiscipline — May contain one or more Discipline entries to indicate coverage of a research discipline.
may-containSpecialty — May contain one or more Specialty entries (introduced in RIXML 2.5).

Where It Fits

Canonical Path

CoverageUpdates/CoverageUpdate/CoveragePairing/CoveredEntities

Children

AssetClass AssetType SecurityType Issuer Security SectorIndustry Region Country Index Discipline Specialty

Definition

Type	`CoveredEntitiesType`
Namespace	`http://www.rixml.org/2017/9/RIXML`
Min Occurs	1
Max Occurs	1

Attributes

No attributes defined for this element

Children

AssetClass(complex)1..1

requiredSince 2.5

AssetType(complex)1..1

requiredSince 2.5

SecurityType(complex)1..1

requiredSince 2.5

Issuer(complex)1..1

requiredSince 2.5

SecuritySecurityType1..1

requiredSince 2.5

SectorIndustrySectorIndustryType1..1

requiredSince 2.5

Region(complex)1..1

requiredSince 2.5

Country(complex)1..1

requiredSince 2.5

Index(complex)1..1

requiredSince 2.5

Disciplinestring1..1

requiredSince 2.5

Specialty(complex)1..1

requiredSince 2.5

Example

<CoveredEntities>
  <AssetClass> ... </AssetClass>
  <AssetType> ... </AssetType>
  <SecurityType> ... </SecurityType>
  <Issuer> ... </Issuer>
  <Security> ... </Security>
  <SectorIndustry> ... </SectorIndustry>
  <Region> ... </Region>
  <Country> ... </Country>
  <Index> ... </Index>
  <Discipline> ... </Discipline>
  <Specialty> ... </Specialty>
</CoveredEntities>

Version History

Unchanged since introduction in RIXML 2.5

CoveredEntities is part of the coverage-updates sidecar schema, documented in both RIXML 2.4 and 2.5. In RIXML 2.4 the choice list comprised AssetClass, AssetType, SecurityType, Issuer, Security, SectorIndustry, Region, Country, Index, and Discipline [RIXML Research Data Dictionary v2.4 p.133]. RIXML 2.5 added Specialty to the choice [RIXML Research Data Dictionary v2.5.1 p.137].

Design Decisions

Covered entities should support multiple types including asset classes, issuers, securities, sectors, regions, countries, indices, and disciplines

Accommodates the diverse range of entities that research analysts and organizations may provide coverage for

RIXML Research Data Dictionary v2.5.1, p.137

Semantic Relationships

Requires1 relationship

←CoveragePairingMUST

Coverage pairings establish the relationship where all covering entities provide research coverage for each specified covered entity

RIXML Research Data Dictionary v2.5.1, p.137— CoveragePairing