RIXML Documentation

Organization

RIXML 2.5 Element

Level OneRequired

Identifies the primary publishing organization for the research product. Requires type attribute from OrganizationTypeEnum and primaryIndicator set to 'Yes'. Level One excludes ContactInfo child elements.

Describes an organization related to the research item. Multiple organizations may be related to one research item. These organizations can be subsidiaries of the same parent or different organizations (as in a joint venture) working together on a publication or event. However, there can only be one primary publisher organization, which is captured by the primaryIndicator, when contained by the Source element.

Usage

Required element within Source, appearing exactly once. Must have type and primaryIndicator='Yes' attributes. Contains OrganizationID, OrganizationName, and optional PersonGroup elements.

Business Context

Essential for publisher identification and categorization, enabling research consumers to filter and organize content by institutional source and organizational characteristics.

Source:level-one-2.5
Schema:RIXML-Common-2_5.xsd:913

Where It Fits

Canonical Path

Research/Product/Source/Organization

Definition

TypeOrganizationType
Namespacehttp://www.rixml.org/2017/9/RIXML
Min Occurs1
Max Occurs1

Attributes

sequenceinteger

Used to indicate any meaningful ordering of the Products contained in this Research item. Particularly useful in publishing compendium products made up of multiple sub-products. Ordering is ascending.

optionalSince 2.1

Indicates the primary organization relative to others that may be specified. When multiple organizations (subsidiaries of the same organization or different organizations) come together on a product, one must be listed as primary (generally the parent organization or the name of the joint venture).

required
typeOrganizationTypeEnum

The type of the organization.

requiredSince 2.1

Children

LogoURLanyURI0..1

Indicates the URL location of the logo of the organization.

optionalSince 2.1

For the cases in which the type attribute has the value PublisherDefined, the PublisherDefinedValue element is used to hold the organization's own description of the type.

optionalSince 2.1
OrganizationIDstring0..unbounded
optionalSince 2.1
OrganizationNamestring1..unbounded
requiredSince 2.1
PersonGroup(complex)0..unbounded
optionalSince 2.1
ContactInfoContactInfoType0..unbounded
optionalSince 2.1
Descriptionstring0..1

Optional description of the organization. Used to include any additional information about the organization.

optionalSince 2.1
Expertise(complex)0..1
optionalSince 2.4

Example

<Organization primaryIndicator="Yes"
               type="SellSideFirm">
  <OrganizationName> ... </OrganizationName>
</Organization>

Version History

2.1
+Introduced
2.4
+Added children: Expertise

Business Rules

MUST

When multiple organizations collaborate on a product, exactly one must be designated as the primary publisher using primaryIndicator

validationconditional-requirement
MUST

For Level One compliance, Organization primaryIndicator attribute must be present and set to Yes

validationlevel-one-compliancerequired-attribute
MUST

Level One compliance excludes ContactInfo elements as children of Organization

validationlevel-one-complianceexclusion

Design Decisions

The primaryIndicator attribute must be present and set to 'Yes' for Organization elements in Level One

To ensure proper identification of the primary publisher organization

RIXML Level One Addendum v2.5, p.6

Only a single primary publisher organization is allowed in Level One Source element

Level One does not support complex inter-organizational collaboration projects to reduce implementation complexity

RIXML Level One Addendum v2.5, p.25

Semantic Relationships

Constrains7 relationships

When multiple organizations collaborate on a product, exactly one must be designated as primary, typically the parent organization or joint venture name

RIXML Research Data Dictionary v2.5.1, p.25Organization

The personID must be unique within the scope of a given publisher organization to ensure accurate person identification

RIXML Research Data Dictionary v2.5.1, p.31personID (Required, String)

The type attribute of Organization elements must use values from the OrganizationTypeEnum enumeration to ensure consistent categorization of publishing firms

RIXML Implementation Guide v2.5.1, p.25EXAMPLE:

Only one organization can be marked as primary publisher when contained within the Source element

RIXML Implementation Guide v2.5.1, p.34The corresponding information in the Data Dictionary looks like this:

SourceMUST

For Level One compliance, the Source element must contain exactly one Organization element

RIXML Level One Addendum v2.5, p.6Research.Product.Source

For Level One compliance, the Organization element must contain exactly one OrganizationID element

RIXML Level One Addendum v2.5, p.7Research.Product.Source.Organization.OrganizationID

For Level One compliance, the Organization element must contain exactly one OrganizationName element

RIXML Level One Addendum v2.5, p.7Research.Product.Source.Organization.OrganizationName

Requires3 relationships

ProductMUST

Content producers must write once and send everywhere, maintaining a single process for transmitting research content to all aggregation vendors and clients

RIXML Implementation Guide v2.5.1, p.22Content producers must be able to write once, send everywhere

For Level One compliance, the Organization primaryIndicator attribute must be present and set to Yes

RIXML Level One Addendum v2.5, p.6Research.Product.Source.Organization

When the type attribute has a value of PublisherDefined, the PublisherDefinedValue element is necessary to hold the off-list entry

RIXML Level One Addendum v2.5, p.7Research.Product.Source.Organization.PublisherDefinedValue