RIXML Documentation

Country

RIXML 2.5 Element

Level OneRequired

Represents nations or sovereign territories referenced in research analysis. The mandatory code attribute uses ISO 3166-1 country codes, while the optional primaryIndicator attribute designates which countries are most relevant to the research content.

Strongly recommended. Indicates the country or countries that are discussed in a research product.

Usage

Include zero to many Country elements within ProductClassifications to specify which nations the research addresses. Set primaryIndicator to Yes for the most important countries discussed. Level One prohibits Rating and Weighting child elements.

Business Context

Essential for geographic tagging and content routing, enabling distribution platforms to filter research by territorial focus and helping clients identify region-specific analysis.

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

Where It Fits

Definition

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

Attributes

The ISO 3166-1 code for the country.

required

Indicates whether the publisher defines this country as an emerging market.

optionalSince 2.1
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 country or countries discussed in the research product. If the product is focused on the Country level (i.e. the ProductFocus tag is set to Country), then at least one Country must be marked as primary.

required
coverageActionCoverageActionEnum

Highlights an action taken by the publisher. Indicates that the publisher is changing the coverage status of a Security. Example: a publisher initiates coverage of Security ABC.

optionalSince 2.1
ratingActionRatingActionEnum

Highlights an action taken by the publisher. Indicates that the publisher is changing their rating on a Security. Example: a publisher downgrades Security ABC.

optionalSince 2.1
weightingActionWeightingActionEnum

Highlights an action taken by the publisher. Indicates that the publisher is changing the weighting of the security type.

optionalSince 2.1

Children

Rating(complex)0..unbounded
optionalSince 2.1
Weighting(complex)0..unbounded
optionalSince 2.1

Example

<Country code="example"
          primaryIndicator="Yes" />

Version History

Unchanged since introduction in RIXML 2.1

Business Rules

MUST

If the product is focused on the Country level (ProductFocus tag is set to Country), then at least one Country must be marked as primary

conditional-requirementvalidation
MUST

Level One does not allow Country elements within ProductClassifications to contain Rating or Weighting elements

level-one-restrictionschema-simplification
SHOULD

For company reports, all elements describing the primary company's characteristics (sector/industry, region, country) must have their primaryIndicator set to Yes

validationconditional-requirement

Design Decisions

At least one Country must be marked as primary when the product is focused at the Country level

When ProductFocus tag is set to Country, there must be at least one primary Country to indicate the main geographic focus of the research product

RIXML Research Data Dictionary v2.5.1, p.61

Semantic Relationships

Constrains3 relationships

At least one country must be marked as primary when product focus is set to Country level

RIXML Research Data Dictionary v2.5.1, p.61primaryIndicator (Required, YesNoEnum)

Country identification must use ISO 3166-1 alpha-2 standard two-letter codes rather than alternative country naming conventions to ensure standardized geographic tagging

RIXML Implementation Guide v2.5.1, p.29Country Codes

Country code attribute must use values from ISO 3166-1 standard

RIXML Level One Addendum v2.5, p.20Research.Product.Context.ProductClassifications.Country

Contrasts With1 relationship

FocusEnum:RegionINFORMATIVE

When focus is Region, the report emphasizes regional analysis rather than individual countries mentioned

RIXML Research Data Dictionary v2.5.1, p.83Region

Blocks Action2 relationships

RatingMUST

Level One specification prohibits Country elements from containing Rating child elements

RIXML Level One Addendum v2.5, p.20Research.Product.Context.ProductClassifications.Country

WeightingMUST

Level One specification prohibits Country elements from containing Weighting child elements

RIXML Level One Addendum v2.5, p.20Research.Product.Context.ProductClassifications.Country