Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. The scale points include a text rating (e.g., "Not at all", "Slightly", etc.). The E-RS (EXACT-Respiratory Symptoms)* USER MANUAL (Version 4.0) May 2015 that is provided upon user's receiving copyright permission provides the numeric scoring of the responses for the questions. Based on this being copyrighted, the numeric scores cannot be provided in this supplement. Upon receiving permission, sponsors may apply these numeric responses in their SDTM and ADaM datasets.  For this EXACT supplement, QSORRES and QSSTRESC is populated with the text description while the numeric rating is represented as missing in QSSTRESN.

  2. The time period of evaluation for the EXACT is populated in the QSEVINTX field. The evaluation interval for the EXACT is the past 7 days (QSEVLINT = "EVERY EVENING") as represented on the CRF.

  3. The EXACT instrument includes CRF does not include subtotals or a totl score on th CRF, but the copyright holder provides software to calculate these derived items. They may be provides as part of a total score (and other scores as needed.  If so, change "that is" to "that are") that is considered as captured data on the CRF and is not considered as derived in the example below.

    1. If operationally defined by the sponsor, it is the sponsor's responsibility to set the --DRVFL flag based on their eCRF process to derive subtotals and total scores. An investigator-derived score written on a CRF will be considered a captured score and not flagged. When subtotal and total scores are derived by the sponsor, the derived flag (--DRVFL) is set to Y. However, when the subtotal and total scores are received from a central provider or vendor, the value would go into --ORRES and --DRVFL would be null (see SDTMIG Section 4.1.8.1, Origin Metadata for Variables).

  4. This language is currently under review. Evaluator information is only to be included when the information is collected directly on the CRF. Questionnaires will no longer be using QSEVAL/QSEVALID; however RSEVAL/RSEVALID and FTEVAL/FTEVALID will continue to be used on Clinical Classifications and Functional Tests. Language for Clinical Classifications and Functional tests follows; language for questionnaires is currently under review. Remove this point if it does not apply.

    For Clinical Classifications and Functional Tests (only when collected on the CRF):  The evaluator is stored in RSEVAL (FTEVAL). For EXACT, the evaluator is defined as the (the appropriate term from controlled terminology). Alternatively, if only evaluator name or initials could be collected: For EXACT, sponsors should follow their internal data management procedures on representing the name or initials of the evaluator. CDISC Controlled Terminology is available for Evaluator (e.g., --EVAL = "HEALTH CARE PROFESSIONAL") and Medical Evaluator (e.g., --EVALID = "RATER 1"). To reiterate, only include this point if the evaluator/administrator is collected directly on the CRF.

  5. VISITNUM is null at the time of publication of this document until CDISC develops guidance on how to consistently model timing information for daily diary instruments.
    1. The QSDTC variable contains the date/time the EXACT was completed by the subject and is used for the timing of this measure.
  6. Terminology

    1. QSCAT, QSTESTCD, and QSTEST (and other variables such as QSORRESU as needed) values are included in CDISC Controlled Terminology.

    2. A full list of value sets for the qualifier, timing, resultand unit fields is provided in Section 4, SDTM Mapping Strategy. (Note: Only the result field is always used. Include qualifier, timing, and unit fields as needed and remove this note.)

3.2 Example for the EXACT QS Domain Model

The EXACT example below shows the terminology used to implement the instrument in the QS domain. This example shows the data for 1 subject collected at the baseline visit for the EXACT instrument. The example uses CDISC Controlled Terminology for QSTESTCD, QSTEST, and QSCAT. All original results are represented with preferred terminology in QSORRES. This result is then transformed into the standard numeric score in QSSTRESN and a character representation of the standard numeric score in QSSTRESC.

Info

Note: There are several optional space-saving options that can be included in the paragraph as appropriate or needed. Historically, we needed these to save space in Word/PDF documents. As we move to all wiki/html, these are likely not needed, but we are waiting to remove these options until we're sure:

  • "This example is based on a questionnaire with an evaluation interval of xxx." allows the QSEVLINT (or QSEVINTX) column to be removed from the example. Note that it was not used for the IDS-SR instrument used in the example below as it is not the same for all items.
  • "This example is based on a questionnaire with an evaluation interval of the past week. QSLOBXFL is NULL based on VISITNUM = 2." saves space if there are a large number of columns.  If this statement is used, leave off the QSEVLINT, QSLOBXFL and VISITNUM columns in the example.
  • "QSSTRESN is null as there are no standardized numeric results for this instrument."  This statement is used when there are no standardized numeric values.  The QSSTRESN column is then removed from the below example.
Info

Update the data in the table below to the current instrument. Include row descriptions as needed to highlight idiosyncrasies or items otherwise of note in this particular instrument. If there are only a few row descriptions, information should be included in the text prior to the example instead of in separate row headers.

Info

We are unable to make the example consistently show blue in the Wiki. All examples are updated for each QRS instrument so we ask that you please review the example below.

...

Nameqs

...

The following is for illustrative purposes and would not really be included for the IDS-SR instrument in this template. It provides an example of what would need to be included if the instrument required supplemental qualifiers (see Section 5 Supplemental Qualifier Name Codes):

Text that would remain unchanged has been left in black:

The evaluation interval text value for data collection needs to be populated in SUPPQS as follows. The standard terminology for QNAM and QLABEL are listed below.

...

Namesuppqs

...

4 SDTM Mapping Strategy

This section is used for reference regarding the CRF data capture and to understand the alignment of the instrument to the SDTM QS domain. It also provides guidance on how the result variables (QSORRES, QSSTRESC, and QSSTRESN) should be populated.

Info

Include mappings for all sets of result values. For ease of use of this template, the complete set of response values for the example in Section 3.2 is not included.

If the instrument has been entered into QRS Maker (all instruments should be), then the complete set of response values can be copied from QRS Maker and pasted into this supplement.

Some example mappings are below.

...

For QRS instruments with subcategories:

When subcategories are used on an instrument, a table with the following introduction information should appear before the mappings for results.

QSSCAT alignment with QSTESTCD

As stated in Section 3.1 assumptions, items on the EXACT are grouped into subcategories. The table below includes the subcategory names along with the applicable item numbers for each category. The values of the subcategories are used to populate QSSCAT and are annotated on the CRF.

...

If all items have the same original result values, with the same standardized character and numeric values, then only include one table showing the values of QSORRES/QSSTRESC/QSSTRESN and put "All QSTESTCDs" (title case "All", and in quotes) above the table:

"All QSTESTCDs"

...

Similarly, if some, but not all, QSTESTCDs share the same original result and standardized values, then the QSTESTCD and corresponding QSTEST values are put in a list above the table rather than providing a separate table for each QSTESTCD/QSTEST.

...

If there are responses that correspond to non-consecutive items or 1-7 consecutive items, include the test codes and test names above the table with the responses as follows:

QSTESTCD = "test code 1" QSTEST = "test name 1"

QSTESTCD = "test code 4" QSTEST = "test name 4"

QSTESTCD = "test code 5" QSTEST = "test name 5"

QSTESTCD = "test code 6" QSTEST = "test name 6"

QSTESTCD = "test code 7" QSTEST = "test name 7"

QSTESTCD = "test code 8" QSTEST = "test name 8"

QSTESTCD = "test code 15" QSTEST = "test name 15"

QSTESTCD = "test code 22" QSTEST = "test name 22"

QSTESTCD = "test code 27" QSTEST = "test name 27"

QSTESTCD = "test code 29" QSTEST = "test name 29"

  1. VISITNUM is null at the time of publication of this document until CDISC develops guidance on how to consistently model timing information for daily diary instruments.
    1. The QSDTC variable contains the date/time the EXACT was completed by the subject and is used for the timing of this measure.
  2. Terminology

    1. QSCAT, QSTESTCD, and QSTEST values are included in CDISC Controlled Terminology.

    2. A full list of value sets for the result fields is provided in Section 4, SDTM Mapping Strategy.

3.2 Example for the EXACT QS Domain Model

The EXACT example below shows the terminology used to implement the instrument in the QS domain. This example shows the data for 1 subject collected at the baseline visit for the EXACT instrument. The example uses CDISC Controlled Terminology for QSTESTCD, QSTEST, and QSCAT. All original results are represented with preferred terminology in QSORRES. This result is then transformed into the standard numeric score in QSSTRESN and a character representation of the standard numeric score in QSSTRESC.


Info

Note: There are several optional space-saving options that can be included in the paragraph as appropriate or needed. Historically, we needed these to save space in Word/PDF documents. As we move to all wiki/html, these are likely not needed, but we are waiting to remove these options until we're sure:

  • "This example is based on a questionnaire with an evaluation interval of xxx." allows the QSEVLINT (or QSEVINTX) column to be removed from the example. Note that it was not used for the IDS-SR instrument used in the example below as it is not the same for all items.
  • "This example is based on a questionnaire with an evaluation interval of the past week. QSLOBXFL is NULL based on VISITNUM = 2." saves space if there are a large number of columns.  If this statement is used, leave off the QSEVLINT, QSLOBXFL and VISITNUM columns in the example.
  • "QSSTRESN is null as there are no standardized numeric results for this instrument."  This statement is used when there are no standardized numeric values.  The QSSTRESN column is then removed from the below example.


Info

We are unable to make the example consistently show blue in the Wiki. All examples are updated for each QRS instrument so we ask that you please review the example below.


The table represents the items from the EXACT form.

Dataset wrap
Nameqs


Rowcaps


Rows 13-14:Questions 11 and 12 are presented for illustrative purposes only. When the instrument is conducted, only one will be represented based on the CRF instructions. In this example, Question 12 would not appear in the actual dataset and has result values of "XXX".
Rows 15-16:Questions 13 and 14 are presented for illustrative purposes only. When the instrument is conducted, only one will be represented based on the CRF instructions. In this example, Question 14 would not appear in the actual dataset and has result values of "XXX".
Row 33:The total score does not have an evaluation interval value represented, since there is a mixture of evaluation interval values with questions 13 and 14 that differ from the remaining questions on the CRF.



Dataset2




4 SDTM Mapping Strategy

This section is used for reference regarding the CRF data capture and to understand the alignment of the instrument to the SDTM QS domain. It also provides guidance on how the result variables (QSORRES, QSSTRESC, and QSSTRESN) should be populated.

...

Omit the QSSTRESN column when it is not applicable to the dataset.

QSTESTCD = "test code" QSTEST = "test name"

...

For responses that are for 8 or more consecutive items, an override label should be used in QRS Maker to show the items that are included as follows:

QSTESTCD = "first test code in sequence" QSTEST = "first test name in sequence" through

QSTESTCD = "last test code in sequence" QSTEST = "last test name in sequence"

...

5 Supplemental Qualifier Name Codes

Info

The instrument used as an example in this template did not require supplemental qualifiers, but this section has been included to provide guidance on those instruments which do require supplemental qualifiers. (Many instruments do not require it.) Text that always will be in the section when it is included has been left black.

Additional rows will be required in the suppqs.xpt dataset for each supplemental qualifier needed.

Remove Section 5 if it does not apply to the new instrument.

The following table contains additional standard name codes for use in the Supplement Qualifiers for Questionnaires (SUPPQS) special purpose dataset.

...

Namesuppqs

...










End of Document