---
title: Mapping Supplemental Qualifiers
slug: ryze/mapping-supplemental-qualifiers
description: Learn how to effortlessly map Supplemental Qualifier (SQ) assets using the Special Dataset Type in ryze with this comprehensive guide. Discover how key variables are automatically mapped, while certain variables like QVAL, QORIG, and QEVAL require manual 
createdAt: 2023-09-29T11:00:37.209Z
---

## Special Dataset Type

Supplemental Qualifier (SQ) assets may be mapped automatically using the Special Dataset Type in ryze. For example, if the Name of the SQ dataset is in the format “SUPPAE”, then the key variables (such as, STUDYID, RDOMAIN, USUBJID etc)  are automatically mapped to the AE Dataset.

To use the automatic mapping configuration, you must set the following:

- Set the Supplemental Qualifier name to SUPP\~\~ (For example, for an AE dataset, set the SQ dataset name to SUPPAE)
- Select the Special Dataset Type mapping at dataset level

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/LKDoWJ9xMr8x6SbChk2M3_image1.png)

Key variables are mapped automatically. However, you must configure mappings for the following Variables in a Supplemental Qualifier dataset:

- **QVAL&#xA0;**
  - Value
- **QORIG**
- **QEVAL**

These variables are not automatically mapped in a linked SUPP– dataset.

**QVAL&#x20;**- Must be mapped to a data value. This Variable must contain a referenced Value asset that is mapped to another source asset such as a collected value from a CRF.



![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/v2EE6YjVTXoo7u0Dlyj7P_image4.png)

**QORIG&#x20;**- Must be mapped, for example, to a source CRF or Derived.

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/LHJkJ-ouY7sVa9DVdIvrz_image2.png)

**QEVAL&#x20;**- must be mapped to the source Evaluator for example, INVESTIGATOR

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/paM7GOnvM9apFxtuEmLcy_image3.png)

## Running Test Conversions with Supplemental Qualifiers

When testing mappings for Supplemental Qualifiers, you should run the conversion task on the parent dataset. For example, to test mappings in SUPPAE, run the conversion task for the AE dataset.





