CoveringEntities
RIXML 2.5 Element
A container element that specifies the entities providing coverage, allowing choice among Organization, PersonGroup, PersonGroupMember, or Person elements with multiple instances permitted
Usage
Required child element of CoveragePairing, used to identify who is providing coverage through flexible selection of organizational or individual entities
Business Context
Enables flexible specification of coverage providers from individual analysts to entire organizations, supporting various research production models and organizational structures
Specification Guide
Overview
CoveringEntities is a container element that identifies the parties providing research coverage within a CoveragePairing. It holds any combination of Organization, PersonGroup, PersonGroupMember, or Person children, allowing coverage to be attributed at any level — from an individual analyst to a research team to an entire firm.
Usage
CoveringEntities appears as a required child of CoveragePairing in the Coverage Updates sidecar schema, paired with CoveredEntities to express who covers what. The content model is a choice that permits multiple instances of any of Organization, PersonGroup, PersonGroupMember, or Person, so mixed-granularity assignments (for example, a lead analyst alongside the team they belong to) can be represented in a single pairing. Each covering entity listed is understood to provide coverage for every entity declared in the sibling CoveredEntities.
Rules
- MUSTEach CoveragePairing must contain exactly one CoveringEntities element identifying the providers of coverage.[RIXML Research Data Dictionary v2.5.1 p.137] [RIXML Research Data Dictionary v2.4 p.133]
- MUSTCoveringEntities must contain at least one of Organization, PersonGroup, PersonGroupMember, or Person; multiples of any combination are permitted.[RIXML Research Data Dictionary v2.5.1 p.137] [RIXML Research Data Dictionary v2.4 p.133]
Relationships
- child-ofCoveragePairing — CoveringEntities is a required child of CoveragePairing and, together with CoveredEntities, establishes that each covering entity provides research coverage for every covered entity in the pairing.
- containsOrganization — May contain one or more Organization children when coverage is attributed at the firm or departmental level.
- containsPersonGroup — May contain one or more PersonGroup children when coverage is attributed to a research team.
- containsPersonGroupMember — May contain one or more PersonGroupMember children to attribute coverage to specific members of a defined group.
- containsPerson — May contain one or more Person children when coverage is attributed to individual analysts.
- paired-withCoveredEntities — Acts as the counterpart to CoveredEntities within a CoveragePairing; the two together define the directional coverage relationship.
Where It Fits
Canonical Path
Definition
| Type | CoveringEntitiesType |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
No attributes defined for this element
Children
OrganizationOrganizationType1..1 |
requiredSince 2.5 |
PersonGroup(complex)1..1 |
requiredSince 2.5 |
PersonGroupMember(complex)1..1 |
requiredSince 2.5 |
PersonPersonType1..1 |
requiredSince 2.5 |
Example
<CoveringEntities>
<Organization> ... </Organization>
<PersonGroup> ... </PersonGroup>
<PersonGroupMember> ... </PersonGroupMember>
<Person> ... </Person>
</CoveringEntities>Version History
Unchanged since introduction in RIXML 2.5
CoveringEntities is documented in the Coverage Updates sidecar schema in RIXML 2.4 (data-dictionary-2.4, p.133) and carries forward unchanged in 2.5 (data-dictionary-2.5.1, p.137), with the same choice content model of Organization, PersonGroup, PersonGroupMember, and Person.
Semantic Relationships
Requires1 relationship
Coverage pairings establish the relationship where each covering entity provides research coverage for all specified covered entities
RIXML Research Data Dictionary v2.5.1, p.137— CoveragePairing