IssuerDetails

Overview

IssuerDetails is a container element within the Context package that groups all information about the companies, governments, or other entities that issue the securities discussed in a research product. It acts as the aggregation point for one or more Issuer children, each of which carries identification, classification, financial, and security-level detail for a single issuing entity. By collecting issuer information in a single, well-defined container, IssuerDetails enables downstream systems to attribute research to specific companies, filter and route content by issuer coverage, and integrate research with portfolio management, compliance, and entitlement systems.

Usage

IssuerDetails is an optional child of Context and appears at most once per Product. When present, it must contain at least one Issuer child; multiple Issuer elements are permitted when the research covers several issuing entities (sources: level-one-2.2 p.17, level-one-2.3 p.12, level-one-2.3.1 p.12, level-one-2.5 p.12, data-dictionary-2.5.1 p.46). Typical usage patterns: - Single-company research — one IssuerDetails containing one Issuer for the covered company. - Multi-company or industry research — one IssuerDetails containing several Issuer elements (e.g. peer comparisons, sector notes, morning calls). - Non-issuer-focused research — IssuerDetails is omitted entirely when the product does not discuss specific issuing entities (e.g. macro or strategy pieces classified primarily via ProductClassifications). Detailed issuer attributes (identifiers, names, financials, ratings, securities) are carried on the Issuer child and its descendants such as IssuerID, IssuerName, IssuerFinancials, and SecurityDetails — not directly on IssuerDetails itself, which carries no attributes of its own.

Rules

• MUSTWhen IssuerDetails is present, it MUST contain at least one Issuer element.[RIXML Level One Addendum v2.2 p.17] [RIXML Level One Addendum v2.3 p.12] [RIXML Level One Addendum v2.3.1 p.12] [RIXML Level One Addendum v2.5 p.12]
• SHOULDIssuerDetails is optional within Context and SHOULD be omitted entirely when the research product does not discuss specific issuing entities, rather than included as an empty container.[RIXML Research Data Dictionary v2.5.1 p.46] [RIXML Level One Addendum v2.5 p.12] [RIXML Level One Addendum v2.3.1 p.12]

Relationships

• child-ofContext — IssuerDetails is an optional child of Context, appearing at most once per Product.
• requiresIssuer — When IssuerDetails is present it must contain one or more Issuer child elements, each describing a single issuing entity.
• complementsProductClassifications — IssuerDetails sits alongside ProductClassifications inside Context; classifications describe the product's subject matter at an abstract level while IssuerDetails enumerates the concrete issuers covered.