RatingEntity

Overview

RatingEntity identifies the organization that issued a rating, distinguishing between ratings produced by the research publisher itself and those originating from independent rating agencies such as Moody's, S&P or Fitch. It is a required child of Rating and provides the source attribution that allows research consumers to evaluate the credibility, methodology and authority behind a rating assessment. The element carries a required ratingEntity attribute drawn from RatingEntityEnum and supports an optional publisherDefinedValue for naming custom rating sources that are not covered by the standard enumeration.

Usage

Include exactly one RatingEntity within each Rating element (sources: level-one-2.3 p.16, level-one-2.5 p.16). The ratingEntity attribute is required and must take a value from RatingEntityEnum — typical values include Publisher, Moodys, SandP and Fitch [level-one-2.5 p.16]. When the rating source is not represented in the standard enumeration, set ratingEntity to PublisherDefined and supply the custom source name in publisherDefinedValue (sources: user-guide-2.3 p.45, level-one-2.3 p.16). In the v3 draft this becomes a ratingEntityPublisherDefinedValue attribute of type xs:string rather than a child element [data-dictionary-v3-draft p.70]. In the canonical Level One context path, RatingEntity appears at Research.Product.Context.IssuerDetails.Issuer.SecurityDetails.Security.Rating.RatingEntity [level-one-2.5 p.16].

Rules

• MUSTEach Rating element MUST contain exactly one RatingEntity child.[RIXML Level One Addendum v2.3 p.16] [RIXML Level One Addendum v2.3.1 p.15] [RIXML Level One Addendum v2.5 p.16]
• MUSTRatingEntity MUST carry the ratingEntity attribute with a value from RatingEntityEnum.[RIXML Level One Addendum v2.3 p.16] [RIXML Research Data Dictionary v2.4 p.63] [RIXML Research Data Dictionary v2.5.1 p.66]
• SHOULDWhen ratingEntity is set to PublisherDefined, a PublisherDefinedValue (v2.x child element) or ratingEntityPublisherDefinedValue attribute (v3 draft) SHOULD be supplied to name the custom rating source.[RIXML Level One Addendum v2.3 p.16] [RIXML User Guide v2.3 p.45] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.70]↗

Relationships

• child-ofRating — RatingEntity is a required child element of Rating and provides the source attribution for the rating value carried on the parent.
• constrained-byRatingEntityEnum — The required ratingEntity attribute is constrained to values from RatingEntityEnum, which enumerates known rating providers including the publisher and major agencies such as Moody's, S&P and Fitch.
• qualifiesSecurity — Via its parent Rating, RatingEntity qualifies a Security under SecurityDetails by identifying the source of the rating applied to that security.