Versions Compared

Key

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

...

  1. The scale points for the symptoms (i.e., erythema/redness, thickness/induration, desquamation/scaling) include a numeric rating (0-4) and a definition of what is represented by the rating (e.g., 0 = "None"). For the PASI V2, RSORRES is populated with the text description while the numeric rating is represented in the standardized character and numeric result variables RSSTRESC and RSSTRESN.

    1. CDISC created a CRF based on input from subject-matter experts and the Feldman reference article.
    2. The Feldman article uses the symptom terms "erythema", "induration" and "scale". However, the terms "redness", "thickness" and "desquamation" are also used regularly, therefore, both version of the symptom terms are used on the CDISC created CRF and in the terminology for RSTEST.
  2. The scale points for the area include a numeric rating (0-6) and a definition of what is represented by the rating (e.g., 0 = "No Involvement"). For the area, RSORRES is populated with the text description while the numeric rating is represented in the standardized character and numeric result variables RSSTRESC and RSSTRESN.
  3. The PASI V2 instrument includes subscores and a total score that are considered as captured data on the CRF and are not considered as derived in the example below. These scores may be submitted in SDTM or derived in the Analysis Data Model (ADaM) per scoring instructions from the Feldman reference.

    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 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).

    2. If scores are received by the sponsor, it is recommended that they are submitted to SDTM and verified in ADaM.

    Terminology

  4. RSCAT, RSTESTCD, and RSTEST values are included in CDISC Controlled Terminology.

  5. A full list of value sets for the result field is provided in Section 4, SDTM Mapping Strategy.
  6. Include a description of scale score or other possible responses (You may need multiple numbered points for this, tho the IDS-SR did not.). For scale scores use the following language: The scale points include a numeric rating (0-3) and a definition of what is represented by the rating (e.g., 0 = "I never take longer than 30 minutes to fall asleep"). For the QRS Short_Name, QSORRES is populated with the text description while the numeric rating is represented in the standardized character and numeric result variables QSSTRESC and QSSTRESN.

  7. Include a description of the evaluation interval if one exists. This may be numeric (QSEVLINT) or text (QSEVINTX). When the evaluation interval is provided in text and cannot be described in ISO 8601 format, use QSEVINTX instead of "QSEVLINT field in ISO 8601 format" and replace "the past 7 days" with the text (e.g., "DAYTIME'". Refer to SDTMIG Section 2.2.5 Timing Variables for All Classes. The evaluation interval needs to be clearly defined on the CRF. Remove this point if it does not apply.: The time period of evaluation for theQRS Short_Name is populated in the QSEVLINTfield in ISO 8601 format (or QSEVINTX, as appropriate) when the evaluation interval can be precisely described as duration. The evaluation interval for the QRS Short_Name is the past 7 days (QSEVLINT = "-P7D"). Alternatively, if it cannot be described as an ISO 8601 duration:  The time period of evaluation for the QRS Short_Name is populated in the QSEVINTX field as an evaluation interval text value, since it cannot be precisely described as an ISO 8601 duration.
  8. If there are subcategories, include a note that subcategories will be represented in QSSCAT. Also provide a list of the subcategories unless one is already provided in the description preceding the assumptions. Remove this point if it does not apply.  For example:  Items are divided into 5 subcategories represented in QSSCAT: "PHYSICAL WELL-BEING", "SOCIAL/FAMILY WELL-BEING", "EMOTIONAL WELL-BEING", "FUNCTIONAL WELL-BEING", and "ADDITIONAL CONCERNS".
  9. Records are created in qs.xpt for every item on the instrument

    1. For items with no data, QSORRES, QSSTRESC, and QSSTRESN are all missing and QSSTAT = "NOT DONE".  If the reason is known then that reason is represented in QSREASND (e.g., QSREASND = "LOGICALLY SKIPPED ITEM" or QSREASND = "PREFER NOT TO ANSWER"). If the reason is unknown, then QSSTAT = "NOT DONE" and QSREASND is missing.

  10. If the instrument standards currently being developed includes logically skipped items, insert:  Some items on the QRS Short_Name may be logically skipped per the instrument instructions. Only one of the 2 oxygen saturation scales (RSTESTCD = "NEWS102" or "NEWS103") is completed for each subject. The other will be treated as a logically skipped item. In addition, item RSTESTCD = "NEWS104A" is only completed when the response to RSTESTCD = "NEWS104" is the amount of oxygen received (in L/min). A record is created in rs.xpt for all items. When an item is considered a logically skipped item, it is represented as follows:

    1. RSSTAT = "NOT DONE".       

    2. RSREASND = "LOGICALLY SKIPPED ITEM".

    3. RSORRES, RSSTRESC, and RSSTRESN are set to null (missing).

  11. This language is currently under development. For --ORRES items which are otherwise missing...
  12. Include this point if score(s) are submitted to SDTM. Update blue text: The QRS Short_Name instrument includes 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. These scores may be submitted in SDTM or derived in the Analysis Data Model (ADaM) per scoring instructions from [Insert copyright holder's name or other source.].

    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 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).

    2. if scores are received by the sponsor, it is recommended that they are submitted to SDTM and verified in ADaM.
  13. This language is currently under review. Evaluator information is only to be included when the information is collected directly on the CRF. instruments 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 instruments is currently under review. Remove this point if it does not apply.

    For Clinical Classifications and Functional Tests (only when collected on the CRF):  *** This section to be updated.  QSEVAL/ID, FTEVAL/ID, and RSEVAL/ID will no longer be used.  Supplemental qualifiers will represent this information. *** For QRS Short_Name, the evaluator is defined as the (the appropriate term from controlled terminology). Alternatively, if only evaluator name or initials could be collected: For QRS Short_Name, 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.

  14. Include this point if there are comments at the end of the instrument. Remove this point if it does not apply.: Comments located at the end of the QRS Short_Name will be recorded in the Comments domain (CO). All assumptions and business rules described in the SDTMIG CO domain are applicable.

  15. Include this point if there are responses over 200 characters. Remove this point if it does not apply: Some responses to the QRS Short_Name items exceeded the 200-character limit for the QSORRES variable and needed to be reduced to fewer than 200 characters. Section 4, SDTM Mapping Strategy, indicates which item responses were revised in order to fit the 200-character limit.

  16. 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 QRS Short_Name QS Domain Model

The QRS Short_Name 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 QRS Short_Name 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 instrument 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 instrument 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.

...


  1. Records are created in rs.xpt for every item on the instrument

    1. For items with no data, RSORRES, RSSTRESC, and RSSTRESN are all missing and RSSTAT = "NOT DONE".  If the reason is known then that reason is represented in RSREASND (e.g., RSREASND = "REFUSED". If the reason is unknown, then RSSTAT = "NOT DONE" and RSREASND is missing.

  2. Terminology

    1. RSCAT, RSTESTCD, and RSTEST values are included in CDISC Controlled Terminology.

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

3.2 Example for the PASI V2 RS Domain Model

The PASI V2 example below shows the terminology used to implement the instrument in the RS domain. This example shows the data for 1 subject collected at the baseline visit for the PASI V2 instrument. The example uses CDISC Controlled Terminology for RSTESTCD, RSTEST, and RSCAT. All original results are represented with preferred terminology in RSORRES. This result is then transformed into the standard numeric score in RSSTRESN and a character representation of the standard numeric score in RSSTRESC.


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 PASI V2 instrument.

Dataset wrap
Namers


Rowcaps


Rows 13-14:Items 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, Item 12 would not appear in the actual dataset and has result values of "XXX".
Rows 15-16:Items 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, Item 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 items 13 and 14 that differ from the remaining items on the CRF.



Dataset2


RowSTUDYIDDOMAINUSUBJIDRSSEQRSTESTCDRSTESTRSCATRSORRESRSSTRESCRSSTRESNRSSTATRSREASNDRSLOBXFLVISITNUMRSDTCRSEVLINT
1STUDYXRS2324-P00011PASI0201PASI02-Head: Erythema/Redness
IDS-SRI never take longer than 30 minutes to fall asleep00

Y12015-05-15-P7D
2STUDYXRS2324-P00012PASI0202PASI02-Head: Thickness/Induration
IDS-SRI do not wake up at night00

Y12015-05-15-P7D
3STUDYXRS2324-P00013PASI0203PASI02-Head: Desquamation/Scaling
IDS-SRMost of the time, I awaken no more than 30 minutes before I need to get up00

Y12015-05-15-P7D
4STUDYXRS2324-P00014PASI0204PASI02-Head: Area Score
IDS-SRI sleep no longer than 7-8 hours/night, without napping during the day00

Y12015-05-15-P7D
5STUDYXRS2324-P00015PASI0205PASI02-Up Extrem: Erythema/Redness
IDS-SRI feel sad less than half the time11

Y12015-05-15-P7D
6STUDYXRS2324-P00016PASI0206PASI02-Up Extrem: Thickness/Induration
IDS-SRI feel irritable less than half the time11

Y12015-05-15-P7D
7STUDYXRS2324-P00017PASI0207PASI02-Up Extrem: Desquamation/Scaling
IDS-SRI feel anxious (tense) less than half the time11

Y12015-05-15-P7D
8STUDYXRS2324-P00018PASI0208PASI02-Up Extrem: Area Score
IDS-SRMy mood brightens but I do not feel like my normal self when good events occur11

Y12015-05-15-P7D
9STUDYXRS2324-P00019PASI0209PASI02-Trunk: Erythema/Redness
IDS-SRMy mood often relates to the time of day because of environmental events (e.g., being alone, working)11

Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0210PASI02-Trunk: Thickness/Induration
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0211PASI02-Trunk: Desquamation/Scaling
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0212PASI02-Trunk: Area Score
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0213PASI02-Low Extrem: Erythema/Redness
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0214PASI02-Low Extrem: Thickness/Induration
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0215PASI02-Low Extrem: Desquamation/Scaling
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0216PASI02-Low Extrem: Area Score
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0217PASI02-Head: Sum of Symptom Scores
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0218PASI02-Head: Sum X Area
IDS-SRAfternoonAfternoon


Y12015-05-15-P7D
10STUDYXRS2324-P000110PASI0219PASI02-Head: Sum X Area X 0.1
IDS-SRAfternoonAfternoon


Dataset wrap
Nameqs
Rowcaps
Rows 13-14:Items 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, Item 12 would not appear in the actual dataset and has result values of "XXX".
Rows 15-16:Items 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, Item 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 items 13 and 14 that differ from the remaining items on the CRF.
Dataset2
RowSTUDYIDDOMAINUSUBJIDQSSEQQSTESTCDQSTESTQSCATQSORRESQSSTRESCQSSTRESNQSLOBXFLVISITNUMQSDTCQSEVLINT
1STUDYXQS2324-P00011IDSR101IDSR1-Falling AsleepIDS-SRI never take longer than 30 minutes to fall asleep00Y12015-05-15-P7D
210STUDYXQSRS2324-P0001210IDSR102PASI0220IDSR1-Sleep During the NightPASI02-Up Extrem: Sum of Symptom Scores
IDS-SRI do not wake up at night00AfternoonAfternoon


Y12015-05-15-P7D
310STUDYXQSRS2324-P0001310IDSR103PASI0221IDSR1PASI02-Waking Up Too EarlyUp Extrem: Sum X Area
IDS-SRMost of the time, I awaken no more than 30 minutes before I need to get up0AfternoonAfternoon0


Y12015-05-15-P7D
410STUDYXQSRS2324-P0001410IDSR104PASI0222IDSR1-Sleeping Too MuchPASI02-Up Extrem: Sum X Area X 0.2
IDS-SRI sleep no longer than 7-8 hours/night, without napping during the day0AfternoonAfternoon0


Y12015-05-15-P7D
510STUDYXQSRS2324-P0001510IDSR105PASI0223IDSR1-Feeling SadPASI02-Trunk: Sum of Symptom Scores
IDS-SRI feel sad less than half the time11AfternoonAfternoon


Y12015-05-15-P7D
610STUDYXQSRS2324-P0001610IDSR106PASI0224IDSR1- Feeling IrritablePASI02-Trunk: Sum X Area
IDS-SRI feel irritable less than half the time1AfternoonAfternoon1


Y12015-05-15-P7D
710STUDYXQSRS2324-P0001710IDSR107PASI0225IDSR1-Feeling Anxious or TensePASI02-Trunk: Sum X Area X 0.3
IDS-SRI feel anxious (tense) less than half the time11AfternoonAfternoon


Y12015-05-15-P7D
810STUDYXQSRS2324-P0001810IDSR108PASI0226IDSR1-Your Mood to Good/Desired EventsIDS-SRMy mood brightens but I do not feel like my normal self when good events occur1PASI02-Low Extrem: Sum of Symptom Scores
IDS-SRAfternoonAfternoon1


Y12015-05-15-P7D
910STUDYXQSRS2324-P0001910IDSR109PASI0227IDSR1-Mood in Relation to Time of DayPASI02-Low Extrem: Sum X Area
IDS-SRMy mood often relates to the time of day because of environmental events (e.g., being alone, working)11AfternoonAfternoon


Y12015-05-15-P7D
10STUDYXQSRS2324-P000110IDSR109APASI0228IDSR1-Mood Worse Morn/Afternoon/NightPASI02-Low Extrem: Sum X Area X 0.4
IDS-SRAfternoonAfternoon


Y12015-05-15-P7DRows 11-32 removed for ease of use of template. (fyi, this row has merged cells so don't try to overwrite it when using the template; just delete it.)
10STUDYXRS33STUDYXQS2324-P00013310IDSR131PASI0229IDSR1PASI02-ScoreTotal Sum
IDS-SR18Afternoon1818Afternoon


Y12015-05-15-P7D




















Info

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.

Dataset wrap
Namesuppqs


STUDYIDRDOMAINUSUBJIDIDVARIDVARVALQNAMQLABELQVALQORIG
STUDYXQSP0001QSSEQSequence number corresponding to row of qs.xpt that supplemental qualifier is needed for (e.g., 8)Appropriate variable name to provide more information about data in qs.xpt, no more than 8 characters long (e.g., CONTACT).Label for QNAM (e.g., Contact Type)Value of QNAM variable ( e.g., SUBJECT VISIT)CRF



...