RIXML Documentation

EntitlementGroup

RIXML 2.5 Element

Level OneRequired

Acts as a structural container for organizing access control specifications that govern research distribution. Groups related entitlement conditions that apply conjunctively to determine content accessibility.

A composite restriction on the use of the product. Each individual entitlement specification inside a single EntitlementGroup applies conjuctively with the others in the group -- i.e. they are AND-ed together. For example, you could limit readership to American press agencies by including a LocationEntitlement (containing a Country element with the U.S. country code) and an AudienceTypeEntitlement (containing the Media audience type code). Each EntitlementGroup applies disjunctively with the other EntitlementGroups -- i.e. they are OR-ed together.

Usage

Include zero to multiple EntitlementGroup elements within ProductDetails when research requires access restrictions. Each group must contain at least one child Entitlement element defining specific access conditions.

Business Context

Supports compliance and business model requirements by enabling fine-grained control over research distribution based on client characteristics, geographic location, and temporal constraints.

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

Where It Fits

Canonical Path

Children

Definition

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

Attributes

No attributes defined for this element

Children

EntitlementEntitlementType1..unbounded
requiredSince 2.1

Example

<EntitlementGroup>
  <Entitlement> ... </Entitlement>
</EntitlementGroup>

Version History

Unchanged since introduction in RIXML 2.1

Business Rules

MUST

Each vendor-specific entitlement code must appear in its own distinct AudienceTypeEntitlement element within separate Entitlement and EntitlementGroup elements

validationstructural-requirement
MUST

Each EntitlementGroup element must contain at least one Entitlement element

validationconditional-requirement

Semantic Relationships

Requires1 relationship

Vendor-specific entitlement codes should each appear within their own distinct AudienceTypeEntitlement element within separate Entitlement and EntitlementGroup elements

RIXML Research Data Dictionary v2.5.1, p.20How to Code Vendor-Specific Entitlement Codes

Constrains1 relationship

EntitlementINFORMATIVE

Individual entitlements within a single EntitlementGroup apply conjunctively (AND-ed together), while multiple EntitlementGroups apply disjunctively (OR-ed together)

RIXML Research Data Dictionary v2.5.1, p.51EntitlementGroup

Triggers Action1 relationship

When a rating is marked as restricted, it affects the distribution entitlements and limits who can access the research publication

RIXML Research Data Dictionary v2.5.1, p.98Restricted