You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

The Related Records (RELREC) special-purpose dataset is used to describe relationships between records for a subject in different datasets and relationships between datasets. RELREC will not be used to represent relationships already represented in Supplemental Qualifier (SUPP--) datasets for nonstandard variables and attributions or the Comments (CO) dataset for unstructured free-text.

Relationships represented in RELREC are collected relationships. The RELREC dataset should be used to represent either:

  • explicit relationships, (e.g., concomitant medications taken as a result of an adverse event) or
  • information of a nature that necessitates using multiple datasets and that may need to be examined together for analysis or proper interpretation.  

Subject records or datasets expressing a relationship are specified using the key variables STUDYID, RDOMAIN (the domain code of the record or dataset in the relationship) with IDVAR (the variable that identifies the related record(s)). Each record in the RELREC special-purpose dataset contains keys that identify a record (or group of records) and an identifier for the relationship which is stored in the RELID variable. The value of RELID is chosen by the applicant and it is recommended that applicants use a standard system or naming convention for RELID (e.g., all letters, all numbers, capitalized).

Relationships Between Records for a Subject

Relationships between records for a subject in different datasets are specified using the key variables STUDYID, RDOMAIN, and USUBJID, along with IDVAR and IDVARVAL (the value of the identifying variable). IDVARVAL will contain the value of the variable described in IDVAR. Single records can be related by using a unique-record-identifier variable such as --SEQ in IDVAR. Groups of records can be related by using grouping variables such as --LNKID or --LNKGRP in IDVAR.  Using --LNKID or --LNKGRP can be a more efficient method of representing relationships in RELREC when relating a single or group of records in one dataset to a group of records in another dataset. Variable RELTYPE will not be used when relating records for a subject and is only used when representing relationships between datasets. The value of RELID will be identical for all related records within USUBJID.

Relationships Between Datasets

Relationships between datasets are represented using a single record for each related dataset that identifies the key(s) of the dataset that can be used to relate the respective records. Relationships between datasets are specified using the key variables STUDYID, RDOMAIN, and IDVAR only. The values of variables USUBJID and IDVARVAL will be null as relationships between specific subject records will not be identified. The variable RELTYPE will identify the type of relationship between the datasets (e.g., a one-to-one or parent-child relationship). The allowable values for RELYPE are ONE and MANY per CDISC Controlled Terminology. This information defines how a merge/join would be written, and what would be the result of the merge/join. The possible combinations are:


NumCombinationDescription
1ONE, ONE

Indicates there is not a hierarchical relationship between the datasets and the records in the datasets. Only 1 record from each dataset will potentially have the same value of the IDVAR within USUBJID.

2ONE, MANY

Indicates there is a hierarchical (parent-child) relationship between the datasets. One record within USUBJID in the dataset identified by RELTYPE = "ONE" will potentially have the same value of the IDVAR with many (1 or more) records in the dataset identified by RELTYPE = "MANY".

3MANY, MANYThis combination is unusual and challenging to manage in a merge/join, and may represent a relationship that was never intended to convey a usable merge/join.

  • No labels