RIXML Documentation

ProductFocus

RIXML 2.5 Element

Level OneRequired

Optional element indicating primary research focus area using focus attribute from FocusEnum and required primaryIndicator. Helps identify main subject matter such as company, sector, or market focus.

Indicates the primary focus of the product. This tag is used in conjunction with the primaryIndicator fields in SectorIndustry, Discipline, Issuer, Region, Country, AssetClass, AssetType, SecurityType, Index to indicate the primary topic of the product. EXAMPLE 1: a report that is an overview of French securities, with a few brief comments about the household durables and insurance industries would have ProductFocus.focus = Country ProductFocus.primaryIndicator = Yes Context.Country.countryCode = FR Context.Country.countryName = France Context.Country.primaryIndicator = Yes Because the product only briefly mentions the household durables and insurance industries, these would both have the Context.sectorIndustry.primaryIndicator set to No. If other countries are mentioned, these additional Context.Country.countryCodes can be listed, with the respective primaryIndicator set to No. EXAMPLE 2: a company report on a bank that briefly discusses how changes in the banking industry may affect aspects of the real estate industry, would have ProductFocus.focus = Issuer ProductFocus.primaryIndicator = Yes Context.SectorIndustry.sectorIndustryCode = 4010 Context. SectorIndustry.Name = Banks Context. SectorIndustry.primaryIndicator = Yes Context.SectorIndustry.sectorIndustryCode = 4040 Context. SectorIndustry.Name = Real Estate Context. SectorIndustry.primaryIndicator = No.

Usage

Optional element within ProductDetails, can appear zero or more times. Must have focus and primaryIndicator attributes when present.

Business Context

Critical for research discovery and organization, enabling investment professionals to quickly identify content relevance to their coverage areas and investment focus.

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

Where It Fits

Canonical Path

Definition

Type
Namespacehttp://www.rixml.org/2017/9/RIXML
Min Occurs1
Max Occurs1
Content ModelText content (string)

Attributes

focusFocusEnum

Focus indicates whether the product discusses any of certain attributes (such as SectorIndustry, Issuer, Country, etc.). A report primarily about one company would have a focus of Issuer, while a country overview would have a focus of Country.

requiredSince 2.1

Used to indicate which of various focus attributes in the product is the primary topic of the product.

required

Children

Contains text content (type: string)

This element's value is its text content. Attributes provide additional context.

Example

<ProductFocus focus="Value"
               primaryIndicator="Yes">ABC-123</ProductFocus>

Version History

Unchanged since introduction in RIXML 2.1

Business Rules

MUST

Compilation reports must use focus of Unfocused and should not add sector/industry tags for each mentioned company

validationconditional-requirement
MUST

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

conditional-requirementvalidation
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

Publishers must specify the focus of each report to provide context for other tags and determine which tags are required

focus-specificationcategorizationconditional-requirement
MUST

Tag values must identify what a report is primarily about rather than merely what it mentions in passing

validationcontent-tagging
MUST

When ProductFocus is used in Level One, the primaryIndicator attribute must be set to Yes

validationlevel-one-restriction
SHOULD

For compilation reports covering multiple companies within one sector, the focus should be Issuer if readers would want to see it when searching for those companies, or SectorIndustry if it provides quick summaries for sector comparison

focus-classificationsearch-optimization
SHOULD

Reports about an industry within a particular country should have focus set to SectorIndustry, not Country

focus-classificationindustry-analysis
SHOULD

Sector/Industry reports must have a focus of SectorIndustry and set the primaryIndicator of the appropriate sector or industry to Yes

validationconditional-requirement
SHOULD

Compilation reports should not include a focus element and must set all primaryIndicator attributes to No

validationconditional-requirement
SHOULD

An industry overview report should have ProductFocus set to SectorIndustry with no company identifiers

content-classificationconditional-requirement
SHOULD

Reports providing updates on multiple companies within an industry should have ProductFocus set to Issuer with all company primaryIndicators set to No

content-classificationconditional-requirement

Design Decisions

primaryIndicator attribute must be set to 'Yes' for ProductFocus in Level One

Level One restricts the cardinality of ProductFocus to one, making all instances primary by definition

RIXML Level One Addendum v2.5, p.21

Compilation reports should use a focus value of Unfocused rather than attempting to identify a primary focus

This acknowledges that compilation reports by nature cover multiple topics without a single primary focus, avoiding misleading categorization

RIXML Research Data Dictionary v2.5.1, p.20

Semantic Relationships

Qualifies3 relationships

The primary indicator setting determines which entities are tagged as primary based on the product focus, enabling distinction between primary discussion topics and entities that are merely mentioned

RIXML Research Data Dictionary v2.5.1, p.17When to set primaryIndicator to "Yes" and when to set it to "No"

SubjectSHOULD

Subject identifies triggering events or topics that led to report creation, requiring critical mass presence in the report to justify inclusion, complementing the product focus classification

RIXML Research Data Dictionary v2.5.1, p.18Subject

ProductMUST

Report focus defines the primary subject matter of the research, enabling precise categorization as issuer-focused, sector-focused, or country-focused research

RIXML Implementation Guide v2.5.1, p.22Identifying report focus is critical

Requires5 relationships

ProductFocus is used in conjunction with primaryIndicator fields in various elements like SectorIndustry to indicate the primary topic of the product

RIXML Research Data Dictionary v2.5.1, p.50ProductFocus

ProductFocus is used in conjunction with primaryIndicator fields in various elements like Issuer to indicate the primary topic of the product

RIXML Research Data Dictionary v2.5.1, p.50ProductFocus

When the product is focused on the Region level with ProductFocus set to Region, then at least one Region must be marked as primary

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

The focusLevel tag is used in conjunction with the ProductFocus tag to determine the focus of a product

RIXML Research Data Dictionary v2.5.1, p.64focusLevel (Required, YesNoEnum)

When ProductFocus is set to Issuer, at least one Issuer element must have its primaryIndicator attribute set to Yes to identify the main subject of the report

RIXML Implementation Guide v2.5.1, p.23EXAMPLE 1:

Constrains3 relationships

The focus of the report determines whether certain tags are required, highly recommended, or optional based on the primary subject matter

RIXML Implementation Guide v2.5.1, p.22Identifying report focus is critical

ProductFocus focus attribute must take values from the FocusEnum enumeration

RIXML Level One Addendum v2.5, p.21Research.Product.Context.ProductDetails.ProductFocus

Level One restricts ProductFocus primaryIndicator to Yes because only one ProductFocus is allowed

RIXML Level One Addendum v2.5, p.21Research.Product.Context.ProductDetails.ProductFocus