RIXML Documentation

PersonGroupMember

RIXML 2.5 Element

Level OneRequired

Container for individual product author specification within a PersonGroup. Requires primaryIndicator attribute for Level One compliance, with optional sequence attribute for ordering multiple authors.

Used to define the members of a group, for example, the author(s) of the product. The PersonGroupMember highlights primary persons, and describes the display order of multiple persons.

Usage

Required when PersonGroup is present, with minimum one occurrence but can contain multiple instances. Must include primaryIndicator attribute, sequence attribute is optional for ordering.

Business Context

Enables detailed author specification and prioritization for research products, supporting proper attribution and expertise identification in research distribution systems.

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

Where It Fits

Canonical Path

Children

Definition

Type
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 PersonGroup, when more than one are specified.

optionalSince 2.1
roleRoleEnum

The role of the group relative to this research item. This is especially useful if only the group is specified without any members or if all members share the same role -- as in a group of document authors or meeting attendees.

optionalSince 2.1

Children

If the role attribute has value PublisherDefined, then the publisher indicates the role in this element.

optionalSince 2.1
PersonPersonType1..1
requiredSince 2.1

Example

<PersonGroupMember>
  <Person> ... </Person>
</PersonGroupMember>

Version History

Unchanged since introduction in RIXML 2.1

Business Rules

MUST

Group names should appear in the Name element within PersonGroup, while individual names should appear in PersonGroupMember.Person element, with groups and people tagged separately

author-categorizationgroup-individual-separation
MUST

For Level One compliance, PersonGroupMember primaryIndicator attribute is required despite being optional in the full schema

validationlevel-one-compliancerequired-attribute
SHOULD

Primary authors are persons or groups who primarily drafted the report, while other contributors can be included but should not be marked as primary, and non-contributing team members should not be included

author-attributionprimary-designation
SHOULD

In compilation reports, no single person should be marked as primary author, and editors or compilers should not be listed as authors

validationauthorship-rule

Design Decisions

The primaryIndicator attribute is required for PersonGroupMember elements in Level One even though optional in the full schema

To ensure proper identification of primary authors within a person group for Level One compliance

RIXML Level One Addendum v2.5, p.7

Semantic Relationships

Contrasts With1 relationship

Group names should be tagged in PersonGroup.Name while individual names should be tagged in PersonGroupMember.Person, maintaining separation between groups and individuals

RIXML Research Data Dictionary v2.5.1, p.15Which Analysts to include in the RIXML File

Broadens1 relationship

The PersonGroup role attribute is particularly valuable when all members share the same role or when only the group is specified without individual members

RIXML Research Data Dictionary v2.5.1, p.28primaryIndicator (Optional, YesNoEnum)

Qualifies1 relationship

PersonGroupMember primaryIndicator identifies which individual member has primary status within a group, allowing multiple primary members per group

RIXML Research Data Dictionary v2.5.1, p.29Elements and Attributes:

Constrains2 relationships

For Level One compliance, when PersonGroup is present, it must contain at least one PersonGroupMember element

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

PersonMUST

The PersonGroupMember element must contain exactly one Person element

RIXML Level One Addendum v2.5, p.8Research.Product.Source.Organization.PersonGroupMember.Person

Requires1 relationship

Though the primaryIndicator attribute is optional in the full schema, Level One compliance requires it for PersonGroupMember

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