All content on this Wiki is non-binding and any individual opinions expressed should not be considered indicative of the policies or positions of CDISC or any other organization.
Page tree
Skip to end of metadata
Go to start of metadata

NEW

News and updates

  • 2021-06-28: Initial version

General

Questionnaires, Ratings, and Scales (QRS) are very common in clinical trial protocols. CDISC has published many supplements to provide users on how to structure the QRS data in a standard format using SDTM. Users can view the normative information regarding relevant CDISC Controlled Terminology (CT) codelists & terms, and how they map and apply in SDTM datasets. CDISC Library provides users a machine-readable version of this normative information, such as the exact CT term to use in the SDTM --CAT variable, an item's --TEST and --TESTCD, one-to-one pairing of --TEST and --TESTCD, ordering of items, and lastly, response codelists & terms for each applicable item.

For full details about QRS Supplements to SDTMIG, visit https://www.cdisc.org/foundational/qrs.

Metadata for these QRS loaded are listed below, with short name (--CAT) in parentheses:

  • 6 Minute Walk Test (SIX MINUTE WALK)
  • Clinical Global Impression (CGI)
  • Patient Global Impression (PGI)

A separate maintenance release after 2021-06-28 will include:

  • Combat Exposure Scale (CES)
  • Eastern Cooperative Oncology Group Performance Status (ECOG)

In this short video is a walkthrough of how to access QRS metadata using the Data Standards Browser and download an Excel export.

posting-clib-dsb-qrs.mp4

These are generic API query templates for requesting QRS metadata:

/mdr/products/QrsInstrument
/mdr/qrs/instruments/{instrument}/versions/{version}
/mdr/qrs/instruments/{instrument}/versions/{version}/responseGroups
/mdr/qrs/instruments/{instrument}/versions/{version}/responseGroups/{responseGroup}
/mdr/qrs/instruments/{instrument}/versions/{version}/items
/mdr/qrs/instruments/{instrument}/versions/{version}/items/{item}
/mdr/root/qrs/instruments/{instrument}

Line #1: Gets a list of all QRS instruments loaded into CDISC Library.

Line #2: Gets the full set of metadata for a given QRS instrument and version. This includes all items. Response metadata is included for each applicable item.

Line #3: Gets a list of hypermedia links to all response groups for a given QRS instrument and version.

Line #4: Gets metadata for a response group in a given QRS instrument and version.

Line #5: Gets a list of hypermedia links to all items for a given QRS instrument and version.

Line #6: Gets metadata for an item in a given QRS instrument and version. Response metadata is included where applicable .

Line #7: Gets a list of versions given a QRS instrument.

For full API documentation, visit https://www.cdisc.org/cdisc-library/api-documentation .

CDISC Library supports CT codetable export for QRS metadata. Refer to FAQ below.

FAQ

 Why do you provide CT c-codes in the outputs?

C-code refers to the concept identifier assigned by NCI EVS. For example, C135738 is the c-code assigned to term CGI, which is a member of the QSCAT codelist. CT submission values and other textual attributes may change from publication to publication. Moreover, the use of root codelists and terms in the API response provide users maximum flexibility for choosing an appropriate CT package, i.e., by following the hypermedia links. to the desirable quarterly CT publication.

 Does CDISC Library contain QRS responses?

Yes. Response codelists and terms are new additions to the SDTM CT package, starting in Q2 2021 publication. This set of CT will be integrated into applicable QRS instruments.

Note that, not all QRS instruments have response codelists, such as CGI. Therefore, /mdr/qrs/instruments/CGI02/versions/2-1/responseGroups will produce an HTTP 404 error.

Also note that, not all items within a QRS instrument have response codelists. For example, an item's value domain may be just a discrete numerical value (or, a write-in number). SIX MINUTE WALK is a prime example.

 What is response group?

In the CDISC Library API for QRS, users can find endpoints dedicated to response groups. Response groups are unique sets of responses in a given QRS instrument and version. Take CES01 v1.0 for example: This version of CES has 7 items. Each of the first four items has a unique set of responses. The next three items share one common set of responses. Therefore, CES01 v1.0 has a total of 5 response groups.

CDISC Library matches the correct response group to each item.

 Expand to see details...

--TESTCD = " CES0101 " --TEST = " CES01-Ever Combat Patrols/Dangerous Duty "

--ORRES

--STRESC

No1
1-3 times2
4-12 times3
13-50 times4
51+ times5

--TESTCD = " CES0102 " --TEST = " CES01-Were You Ever Under Enemy Fire "

--ORRES

--STRESC

Never1
<1 month2
1-3 months3
4-6 months4
7+ months5

--TESTCD = " CES0103 " --TEST = " CES01-Ever Surrounded by the Enemy "

--ORRES

--STRESC

No1
1-2 times2
3-12 times3
13-25 times4
26+ times5

--TESTCD = " CES0104 " --TEST = " CES01-Soldiers in Unit KIA, Wounded, MIA "

--ORRES

--STRESC

None1
1-25%2
26-50%3
51-75%4
76% or more5

--TESTCD = " CES0105 " --TEST = " CES01-How Often Fire Rounds at Enemy "

--TESTCD = " CES0106 " --TEST = " CES01-See Someone Hit by Rounds "

--TESTCD = " CES0107 " --TEST = " CES01-In Danger of Being Injured/Killed "

--ORRES

--STRESC

Never1
1-2 times2
3-12 times3
13-50 times4
51+ times5

Note that, an HTTP error will be returned when a version of QRS instrument does not contain any response groups.

 Is QRS metadata available in the Data Standards Browser?

Yes. In the Data Standards Browser, users can find QRS instruments arranged by their category, i.e., Clinical Classification (CC), Functional Test (FT), and Questionnaire (QS).

 Can I export a QRS instrument to Excel?

Yes. Users can export a QRS instrument from CDISC Library to Excel. The multi-tabbed layout is designed to show relationships from an instrument, to items, and finally to responses. It also aims to provide linkages between published terms across multiple codelists. This metadata can be helpful for CRF building, data mapping, and other data tasks. For details, users can find a Read Me in an Excel export.

To obtain an Excel export, users can either use the Export button on the Data Standard Browser. Or, specify Excel media type at the top-level QRS endpoint. An example for CGI02 v2.1, in cURL:

curl -X GET \
  https://library.cdisc.org/api/mdr/qrs/instruments/CGI02/versions/2-1 \
  -H 'Accept: application/vnd.ms-excel'
 Are QRS Supplements to ADaMIG (ADQRS) part of CDISC Library?

CDISC will be working with the ADQRS team to formalize the metadata. Further details will be furnished.

  • No labels