IssuerName
RIXML 2.5 Element
Specifies name for the issuer with required nameType attribute from IssuerNameTypeEnum enumeration. Must contain at least one instance to provide issuer name information.
This is the name of the issuer related to the IssuerID.idValue.
Usage
Required element within Issuer, must appear at least once but can have multiple instances. Requires nameType attribute and contains NameValue child element.
Business Context
Provides human-readable issuer identification essential for research categorization, user interfaces, and professional communication about specific companies or entities.
Specification Guide
Overview
IssuerName specifies the human-readable name of an issuing entity that corresponds to one or more IssuerID codes. It sits within Issuer and supplies the textual identification that appears in user interfaces, reports, and downstream research-distribution systems while the IssuerID codes provide the machine-readable cross-references. The element supports multiple parallel name variants — legal, local, display, parent and trading — through its required name-type attribute (drawn from IssuerNameTypeEnum in versions 2.x and from OrganizationNameTypeEnum in the v3 draft). This allows a single issuer to be represented appropriately across jurisdictions, languages, and presentation contexts without losing the linkage to its canonical identifiers.
Usage
IssuerName is a required child of Issuer; each Issuer must contain at least one occurrence, and multiple occurrences are permitted to carry different name variants for the same entity (sources: level-one-2.2 p.18, level-one-2.5 p.13, data-dictionary-2.5.1 p.53).
In RIXML 2.x:
- The nameType attribute is required and must be a value from IssuerNameTypeEnum (e.g. Legal, Local, Display, Parent, Trading, PublisherDefined).
- The element must contain exactly one NameValue child holding the actual name string.
- An optional PublisherDefinedValue child may be used to label custom name types when nameType is set to PublisherDefined.
When only a single name is supplied for an issuer, publishers should set nameType to Display unless another type is specifically more appropriate (sources: user-guide-2.1 p.35, user-guide-2.3 p.36, data-dictionary-2.4 p.50, data-dictionary-2.5.1 p.53).
In the RIXML 3.0 draft, the structure is simplified: the issuer name string is carried as the element's text content rather than via a NameValue child, the attribute is renamed issuerNameType and draws from OrganizationNameTypeEnum, and instances live inside an IssuerNameList container [data-dictionary-v3-draft p.53].
Rules
- MUSTEach Issuer must contain at least one IssuerName element, and every IssuerName must carry the nameType attribute set to a value from IssuerNameTypeEnum.[RIXML Level One Addendum v2.2 p.18] [RIXML Level One Addendum v2.3 p.13] [RIXML Level One Addendum v2.3.1 p.13] [RIXML Level One Addendum v2.4 p.13] [RIXML Level One Addendum v2.5 p.13]
- MUSTEach IssuerName must contain exactly one
NameValuechild element holding the actual issuer name string (RIXML 2.x).[RIXML Level One Addendum v2.3.1 p.13] [RIXML Level One Addendum v2.4 p.13] [RIXML Level One Addendum v2.5 p.13] - MUSTWhen nameType is set to
PublisherDefined, aPublisherDefinedValuechild element must be provided to label the custom name type.[RIXML User Guide v2.2 p.36] - SHOULDWhen supplying only one IssuerName for an issuer, the nameType should be set to
Displayunless another type is specifically preferred.[RIXML User Guide v2.1 p.35] [RIXML User Guide v2.2 p.36] [RIXML User Guide v2.3 p.36] [RIXML User Guide v2.3.1 p.36] [RIXML Research Data Dictionary v2.4 p.50] [RIXML Research Data Dictionary v2.5.1 p.53]
Relationships
- child-ofIssuer — IssuerName is a required child of Issuer; at least one instance must appear per Issuer and multiple instances are allowed for different name types.
- qualifiesIssuerID — IssuerName provides the human-readable counterpart to the codes carried by IssuerID within the same Issuer.
- constrained-byIssuerNameTypeEnum — The required nameType attribute must take a value from IssuerNameTypeEnum in RIXML 2.x.
- constrained-byOrganizationNameTypeEnum — In the RIXML 3.0 draft, the renamed
issuerNameTypeattribute draws its values from OrganizationNameTypeEnum rather than from IssuerNameTypeEnum.
Where It Fits
Canonical Path
Definition
| Type | |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
nameTypeIssuerNameTypeEnum |
An issuer can have multiple names. The names can be one or more of the following types: legal, local, display, parent, trading. Use Display if using only one nameType, unless one of the other nameTypes is preferred. required |
Children
PublisherDefinedValuestring0..1 |
If the IssuerName.NameType = PublisherDefined, then the publisher can indicate what type of name has been used. optionalSince 2.1 |
NameValuestring1..1 |
The name that is associated with the IssuerID.idValue above. requiredSince 2.1 |
Example
<IssuerName nameType="Value">
<NameValue> ... </NameValue>
</IssuerName>Version History
Unchanged since introduction in RIXML 2.1
IssuerName is present and stable throughout RIXML 2.x (2.1 through 2.5.1) with the same core structure: a required nameType attribute drawn from IssuerNameTypeEnum, a required NameValue child, and an optional PublisherDefinedValue child for custom name types (sources: user-guide-2.1 p.35, user-guide-2.2 p.36, user-guide-2.3.1 p.36, data-dictionary-2.4 p.50, data-dictionary-2.5.1 p.53).
The RIXML 3.0 draft restructures the element:
- The actual name is carried as the element's string content instead of via a separate NameValue child.
- The attribute is renamed from nameType to issuerNameType and references OrganizationNameTypeEnum rather than IssuerNameTypeEnum.
- Instances are grouped under a new IssuerNameList container within Issuer.
[data-dictionary-v3-draft p.53]
Business Rules
When IssuerName nameType is set to PublisherDefined, the PublisherDefinedValue element must be provided to indicate what type of name has been used
IssuerName element must contain exactly one NameValue element
When using only one nameType for an issuer, Display should be used unless one of the other nameTypes is specifically preferred
Design Decisions
Use Display as the default nameType when using only one nameType
Provides a default naming convention for issuers unless one of the other specific nameTypes is preferred
RIXML Research Data Dictionary v2.5.1, p.53
Semantic Relationships
Constrains2 relationships
The Issuer element must contain at least one IssuerName element
RIXML Level One Addendum v2.5, p.13— Research.Product.Context.IssuerDetails.Issuer.IssuerName
The IssuerName element must contain exactly one NameValue element
RIXML Level One Addendum v2.5, p.13— Research.Product.Context.IssuerDetails.Issuer.IssuerName.NameValue