PersonDetails
RIXML 2.5 Element
Represents comprehensive information about an individual involved in research production, designed to support multiple language expressions. Contains personal identification fields including FamilyName (required), GivenName, MiddleName, DisplayName (strongly recommended), professional information like JobTitle, Division, JobRole, and biographical data through Biography and BiographyFormatted fields. Also includes FamilyNameSuffix and Credentials for additional name components.
Usage
Used within PersonDetailsAlternativeLanguages containers to provide person information in specific languages. Language attribute defaults to Research element language or English. DisplayName is strongly recommended for proper name presentation.
Business Context
Facilitates international research distribution by enabling person information in multiple languages, supporting global research teams and ensuring proper identification and attribution across different linguistic markets.
Specification Guide
Overview
PersonDetails is a structural container that carries comprehensive name, job, and biographical information for an individual involved in research production, in a single specified language. It groups together personal identification fields (family name, given name, middle name, display name, suffix, credentials), professional identification (job role, job title, division), and biographical narrative, so that analyst and contributor attribution can be expressed consistently and — from RIXML 2.5 onward — localized to multiple languages. The element exists to support proper research attribution, regulatory disclosure of analyst identity, and international distribution where contributor information must be presented in the native language conventions of regional markets.
Usage
PersonDetails appears as a child of Person (and analogously PersonGroupDetails for groups). The primary instance carries the person's information in the document's default language.
From RIXML 2.5, additional language variants are supplied inside a PersonDetailsAlternativeLanguages container, which may hold multiple PersonDetails instances, each tagged with its own language attribute (ISO 639-2/T code). If language is omitted, it defaults to the language declared on the Research element, or English if no document-level default is set [RIXML Release Notes v2.5 p.18].
Typical contents:
- FamilyName — required
- DisplayName — strongly recommended (2.5); required in the v3 draft [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.31]↗
- GivenName, MiddleName, FamilyNameSuffix, Credentials — optional name components
- JobRole, JobTitle, Division — optional professional fields
- Biography (plain text) and/or BiographyFormatted (limited HTML markup) — optional narrative
- PreferredPronouns — proposed for v3 [RIXML All-Member Meeting Winter 2024 p.23]↗
In the v3 draft, PersonDetails is described as a required child of a PersonDetailsList container, with multiple instances permitted [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.31]↗.
Rules
- MUSTPersonDetails must include a
FamilyName.[RIXML Research Data Dictionary v2.5.1 p.29] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.31]↗ - SHOULD
DisplayNameshould be provided within PersonDetails for proper name presentation; in the v3 draft it becomes required.[RIXML Research Data Dictionary v2.5.1 p.29] [RIXML Research Suite Data Dictionary v3.0 (DRAFT) p.31]↗ - MUSTWhen PersonDetails appears inside PersonDetailsAlternativeLanguages, it must carry a
languageattribute using an ISO 639-2/T code; if omitted on the primary instance, the value defaults to the Research element's language attribute, or English if no default exists.[RIXML Release Notes v2.5 p.18] - INFORMATIVEBiographical content in PersonDetails should be supplied as plain text in
Biographyor with limited HTML markup inBiographyFormatted.[RIXML Release Notes v2.5 p.18] [RIXML Research Data Dictionary v2.5.1 p.29]
Relationships
- contained-byPerson — PersonDetails carries the name, job, and biographical content of a Person in the document's default language.
- contained-byPersonDetailsAlternativeLanguages — Additional language variants of PersonDetails are placed inside PersonDetailsAlternativeLanguages, which may hold multiple language-tagged instances.
- typed-byPersonDetailsType — PersonDetails is defined by the complex type PersonDetailsType.
- parallelsPersonGroupDetails — PersonGroupDetails is the group-level analogue of PersonDetails, providing equivalent localizable information for a PersonGroup.
- qualified-by
PreferredPronouns— A proposedPreferredPronounschild of PersonDetails would capture pronoun preferences for analysts in support of diversity and inclusion.
Where It Fits
Canonical Path
Definition
| Type | PersonDetailsType |
| Namespace | http://www.rixml.org/2017/9/RIXML |
| Min Occurs | 1 |
| Max Occurs | 1 |
Attributes
Indicates the language of the Person Details. If not specified, default to value of language attribute of top Research element. If language attribute of Research element is not specified, default to English. Described using the ISO 639-2/T Code. optional |
Children
JobRolestring0..1 |
Indicates the functional role played by the person relative to his/her job in the organization, for example, analyst, strategist, economist, etc. optionalSince 2.5 |
FamilyNamestring1..1 |
Indicates the family name of the person. requiredSince 2.5 |
GivenNamestring0..1 |
Indicates the given name of the person. optionalSince 2.5 |
MiddleNamestring0..1 |
Indicates the middle name of the person. optionalSince 2.5 |
DisplayNamestring0..1 |
Strongly Recommended. Indicates how the publisher or person wants the name to be presented, for example: Dr. John Doe Sr. CPA, CFA. optionalSince 2.5 |
JobTitlestring0..1 |
Indicates the official title of the person within an organization -- e.g. Managing Director, Vice President, etc. optionalSince 2.5 |
Divisionstring0..1 |
Indicates the division that the person officially works for within an organization. optionalSince 2.5 |
FamilyNameSuffixstring0..1 |
An accommodation for family name modifiers traditionally appearing after the person's name -- e.g. Jr., Sr., III.. optionalSince 2.5 |
Credentialsstring0..1 |
An accommodation for credentials traditionally appearing after the person's name -- e.g. C.F.A., Ph.D., Esq.. optionalSince 2.5 |
Biographystring0..1 |
Biographical information about the person. No markup permitted. optionalSince 2.5 |
BiographyFormattedstring0..1 |
Biographical information about the person. Limited markup permitted - HTML code for paragraph, ordered lists and unordered lists with list items, bold, underline, and italics. optionalSince 2.5 |
Example
<PersonDetails>
<FamilyName> ... </FamilyName>
</PersonDetails>Version History
Unchanged since introduction in RIXML 2.5
2.0–2.4 — PersonDetails exists as the standard container for analyst and contributor name and job information beneath Person, in a single language.
2.5 — Enhanced for globalization: a language attribute (ISO 639-2/T) is added, and a new PersonDetailsAlternativeLanguages container is introduced to hold additional language-tagged PersonDetails instances. The element's default language falls back to the Research element's language, or English [RIXML Release Notes v2.5 p.18].
2.5.1 — Documentation clarifies that FamilyName is required and DisplayName is strongly recommended, alongside the established job and biographical fields, including FamilyNameSuffix, Credentials, JobRole, JobTitle, Division, Biography, and BiographyFormatted [RIXML Research Data Dictionary v2.5.1 p.29].
3.0 (draft) — Restructured so PersonDetails is a required child of a PersonDetailsList with multiple instances allowed. DisplayName is promoted to required. A PreferredPronouns element is proposed. The language attribute is retyped against ISO639LanguageType (sources: data-dictionary-v3-draft p.31, meeting-2024-winter p.23).
Business Rules
PersonDetails language attribute should default to the Research element language attribute when not specified, and to English when the Research language is also unspecified
When language attribute is not specified for PersonDetails, it defaults to the language attribute value of the top Research element
When the Research element language attribute is not specified, PersonDetails language defaults to English
Semantic Relationships
Constrained By2 relationships
PersonDetails language defaults to the Research element's language attribute when not explicitly specified
RIXML Research Data Dictionary v2.5.1, p.30— language (Optional, String)
When both PersonDetails language and Research element language are unspecified, the system defaults to English (eng per ISO639-2LanguageType)
RIXML Research Data Dictionary v2.5.1, p.30— language (Optional, String)
Overrides1 relationship
When not specified, person details language defaults to the Research element language, or English if Research language is unspecified
RIXML Release Notes v2.5, p.17— Toward improved globalization
Qualifies1 relationship
Alternative language container provides person name and job information in non-default languages
RIXML Release Notes v2.5, p.18— Toward improved globalization