OrganizationName
RIXML 2.5 Element
Display name for the publishing organization suitable for screen presentation. Requires nameType attribute set to 'Display' and contains short string identifier for the publisher.
The name of the organization. An organization can have multiple names as enumerated in the Name Types. At least one name is required for the content to be valid. Display name is the preferred name if only one name is provided.
Usage
Required element within Organization, appearing exactly once. Must have nameType='Display' attribute and contain concise publisher name suitable for user interface display.
Business Context
Provides human-readable publisher identification for research consumer interfaces, enabling clear source attribution in research browsing and selection workflows.
Specification Guide
Overview
OrganizationName holds the textual name of an organization involved in research production, classified by a required nameType attribute drawn from OrganizationNameTypeEnum (Legal, Local, Display, or Parent). It is the primary human-readable identifier for publishers and other organizations carried inside the source package of a Research document, working alongside OrganizationID to establish complete organizational identity (sources: data-dictionary-2.4 p.26, data-dictionary-2.5.1 p.26).
Usage
OrganizationName is a required child of Organization in the full schema, with multiple occurrences allowed so that the same organization can be carried under different name types — for example a Legal name for regulatory contexts and a Display name for user interfaces (sources: user-guide-2.2 p.17, data-dictionary-2.5.1 p.26). When only a single name is supplied, the Display OrganizationNameTypeEnum value should be used unless another type is specifically more appropriate (sources: user-guide-2.1 p.17, data-dictionary-2.4 p.26).
From version 2.5 onward, an optional language attribute (ISO 639-2/T) may be used to indicate the language of the name value; when present it overrides the language setting carried on the enclosing Research element, enabling multilingual representation of the organization's identity (sources: release-notes-2.5 p.15, data-dictionary-2.5.1 p.26).
For Level One compliance, usage is tightened: Organization must contain exactly one OrganizationName whose nameType is set to Display, with a short string suitable for screen display alongside other publisher names (e.g. "Credit Suisse", "UBS", "Bear Stearns") (sources: level-one-2.2 p.12, level-one-2.3 p.7, level-one-2.3.1 p.7, level-one-2.4 p.25, level-one-2.5 p.7).
In the v3 draft, OrganizationName is repositioned as a required child of an OrganizationNameList container, but otherwise retains the same content model, required nameType, and optional language attribute [data-dictionary-v3-draft p.37].
Rules
- MUSTAt least one OrganizationName must be provided for an Organization to be valid content in the full schema.[RIXML User Guide v2.1 p.17] [RIXML User Guide v2.2 p.17] [RIXML Interactions Data Dictionary v2.0 p.17]
- MUSTThe nameType attribute is required and must take a value from OrganizationNameTypeEnum (Legal, Local, Display, or Parent).[RIXML Research Data Dictionary v2.4 p.26] [RIXML Research Data Dictionary v2.5.1 p.26] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.37]↗
- SHOULDWhen only one OrganizationName is provided for an organization, its nameType should be set to
Displayunless another type is specifically preferred.[RIXML User Guide v2.1 p.17] [RIXML Research Data Dictionary v2.4 p.26] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.37]↗ - MUSTFor Level One compliance, Organization must contain exactly one OrganizationName with nameType set to
Displayand a short string suitable for screen display.[RIXML Level One Addendum v2.2 p.12] [RIXML Level One Addendum v2.3 p.7] [RIXML Level One Addendum v2.3.1 p.7] [RIXML Level One Addendum v2.4 p.25] [RIXML Level One Addendum v2.5 p.7] - MAYFrom version 2.5, the optional
languageattribute on OrganizationName uses an ISO 639-2/T code and, when present, overrides thelanguageattribute of the enclosing Research element for that name value.[RIXML Release Notes v2.5 p.15] [RIXML Research Data Dictionary v2.5.1 p.26]
Relationships
- child-ofOrganization — OrganizationName is a required child of Organization in the full schema, with multiple instances allowed to carry different name types or languages.
- constrainsOrganization — For Level One compliance, Organization is constrained to exactly one OrganizationName child.
- uses-enumOrganizationNameTypeEnum — The required nameType attribute draws its value from OrganizationNameTypeEnum, distinguishing Legal, Local, Display, and Parent names.
- default-valueOrganizationNameTypeEnum.Display — The
Displayvalue of OrganizationNameTypeEnum is the recommended default for nameType when only one OrganizationName is provided. - complementsOrganizationID — OrganizationName works in conjunction with OrganizationID inside Organization to provide both human-readable identification and machine-readable identifiers for the publisher.
- inherits-fromResearch — When the optional
languageattribute is omitted, OrganizationName inherits the language from the enclosing Research element; when present, it overrides that setting.
Where It Fits
Canonical Path
Definition
| Type | |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
| Content Model | Text content (string) |
Attributes
nameTypeOrganizationNameTypeEnum |
The name can be one of the following types - legal, local, display, or parent. Use Display if using only one nameType, unless one of the other nameTypes is preferred. requiredSince 2.1 |
Indicates the language of the name value given. Overrides the language attribute on the Research element. optional |
Children
Contains text content (type: string)
This element's value is its text content. Attributes provide additional context.
Example
<OrganizationName nameType="Value">ABC-123</OrganizationName>Version History
Unchanged since introduction in RIXML 2.1
2.0 – 2.4: OrganizationName is established as a required, repeatable child of Organization with a required nameType attribute drawn from OrganizationNameTypeEnum (Legal, Local, Display, Parent). At least one instance is required for content validity, with Display recommended when only one name is provided (sources: data-dictionary-interactions-2.0 p.17, user-guide-2.1 p.17, data-dictionary-2.4 p.26).
Level One profile (2.2 – 2.5): Successive Level One specifications tighten cardinality and value: exactly one OrganizationName inside Organization, with nameType set to Display and a short, screen-friendly value (sources: level-one-2.2 p.12, level-one-2.3 p.7, level-one-2.3.1 p.7, level-one-2.4 p.25, level-one-2.5 p.7).
2.5: An optional language attribute (ISO 639-2/T) is added, allowing multiple OrganizationName instances under the same Organization to carry the organization's name in different languages. When specified, language overrides the language set on Research (sources: release-notes-2.5 p.15, data-dictionary-2.5.1 p.26).
3.0 (draft): The content model is restructured so that OrganizationName becomes a required child of an OrganizationNameList container rather than appearing directly under Organization. The required nameType and optional language attributes are preserved [data-dictionary-v3-draft p.37].
Business Rules
For Level One compliance, Organization must contain exactly one OrganizationName element with nameType set to Display
The primary publisher must include an OrganizationName element with nameType set to Display
Language attributes on OrganizationName elements override the language setting on the parent Research element
When using only one OrganizationName nameType, Display should be used unless another nameType is specifically preferred
Design Decisions
The nameType attribute must be set to 'Display' for OrganizationName elements in Level One
To ensure the organization name is suitable for display on computer screens alongside other publisher names
RIXML Level One Addendum v2.5, p.7
Added optional language attribute to OrganizationName element to support multiple language translations
Improves globalization support for larger publishers operating in multiple countries with different native languages, allowing organization names in various languages
RIXML Release Notes v2.5, p.15
Made nameType a required attribute with specific guidance on default usage
To ensure proper categorization of organization names while providing clear guidance that Display type should be used as default when only one nameType is specified
RIXML Research Data Dictionary v2.5.1, p.26
Semantic Relationships
Overrides2 relationships
The language attribute on OrganizationName supersedes the language setting from the top-level Research element when specified
RIXML Research Data Dictionary v2.5.1, p.26— Elements and Attributes:
The organization name language attribute overrides the default language specified at the Research element level
RIXML Release Notes v2.5, p.15— Toward improved globalization
Constrains1 relationship
For Level One compliance, the Organization element must contain exactly one OrganizationName element
RIXML Level One Addendum v2.5, p.7— Research.Product.Source.Organization.OrganizationName
Requires2 relationships
For Level One compliance, the OrganizationName nameType attribute must be set to Display
RIXML Level One Addendum v2.5, p.7— Research.Product.Source.Organization.OrganizationName
Level One requires the primary publisher to have OrganizationName with nameType Display
RIXML Level One Addendum v2.5, p.26— Identifying the Publisher