Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updating year in header and version section
Info
titlecolor coding

Green = Recent FDA Changes

Pink = Instructional information for developers

Blue = Text can change from supplement to supplement based on the instrument

Black = Standard template language

Info
titleInstructions on how to use this template
  1. Copy QS Template page and move to the Initial development (not ready for review) page. Please DO NOT OVERWRITE the template pages.
    1. If the supplement is based on a measurement system, such as PRO-CTCAE V1.0, FACIT, PROMIS, etc., replace the word instrument with mesurement measurement system throughout the supplement.
  2. The "–" in this template represents the domain implemented for the instrument. This is replaced with the 2-character domain abbreviation of FT, QS, or RS that is used for the instrument.
  3. Change the title of the page as follows:
    1. Remove 'Copy of QRS Supplement Template - '.
    2. Replace 'Name of QRS Instrument' with the full name of the QRS instrument the supplement is being created for.
    3. Change 'QRS Short_Name' to the short name (--CAT) for the current instrument.
  4. Update the information in the Page Properties block below as indicated in the block below.
    1. The supplement version number in the header section will be 'v1' if there has never been a supplement for the instrument before. Otherwise, increment as appropriate.
    2. If the CRF was copyright approved, keep 'Approved'; otherwise change 'Approved' to 'Public Domain'.
  5. Replace 'Title' and 'QRS Short_Name' throughout the document with the title and short name of the instrument that the supplement is being created for.
  6. Replace royal blue text with information pertaining to the instrument the supplement is being created for. Delete royal blue text which does not apply to the new instrument.
  7. Unless otherwise noted, text in black applies to all QRS Supplements and should not be deleted, but should be examined carefully and revised as appropriate based on the specific instrument supplement as needed. Any changes need to be in blue font to stand out for review.
  8. Change QS to RS or FT and 'Questionnaires' to 'Disease Response and Clin Classification' or 'Functional Tests' as appropriate. Also when discussing the instrument as a general rule refer to it as instrument.
  9. Remove all information blocks, except for the one immediately below this called 'Information for Reviewers'.
  10. Keep changes in blue for ease throughout internal and public review. Once the supplement has gone thru public review and all comments are resolved, change all text color to black except for hyperlinks.
  11. Arabic numerals (0, 1, 2, 3, etc.)are used to express numbers in most circumstances. Exceptions are the following: 
    • Numbers that begin a sentence, title, subtitle, or heading 
    • Common fractions 

    • Accepted usage such as idiomatic expressions and numbers used as pronouns 

    • Other uses of “one” in running text (e.g., when meaning "a")
    • Ordinals first through ninth
    • Numbers spelled out in quotes or published titles.
Info
titleInformation for Reviewers

Text in black is part of the template used to create this document and is not revised under CDISC internal or public review. Please review the blue text; this text represents the changes made to the template that are specific to this QRS instrument.

Page properties
Title

Name of QRS instrument (QRS Short_Name)

CDISC ReferenceQuestionnaire (or 'Clinical Classification' or 'Functional Test', as appropriate) Supplement to the Study Data Tabulation Model Implementation Guide for Human Clinical Trials
QRS Short Name

QRS Short_Name

QRS Permission StatusApproved (or 'Public Domain, Exempt from Copyright', as appropriate)
TeamStandards team QRS instrument is being developed for (e.g., Major Depressive Disorder Standards Team), if applicable, and CDISC Questionnaires, Ratings, and Scales (QRS) Subteam
Supplement Version1.0 (or higher as appropriate when doing a supplement revision)
StatusDRAFT (or "REVISION DRAFT" or "FINAL", as appropriate). Status will not be considered "Final" until the supplement is ready to be sent for publication.
Dateyyyy-mm-dd (date current version released, regardless of status - this date should always match the date in the Revision History section below and should be updated every time this supplement is edited.)
Notes to Readers
  • This supplement is intended available to be used with other CDISC user guides for specific therapeutic/disease areas and follows the CDISC Study Data Tabulation Model Implementation Guide for Human Clinical Trials.
  • This instrument is a US FDA Qualified Clinical Outcome Assessment (COA) instrument. (COA #XXX, Qualified Clinical Outcome Assessments (COA) | FDA) (Use only for instruments this applies to; update COA #.)
Known IssuesOnly include this row to describe any known issues related to the supplement. If there are no issues, this row can be deleted.

...

Revision History

DateVersion
20232024-mm-dd1.0 Draft

© 2023 Clinical 2024 Clinical Data Interchange Standards Consortium, Inc. All rights reserved. 

Info

For the first version of a supplement, use the above Revision History table and delete this information box.

When a previously published supplement is being revised, a modified "Revision History" table will need to be used. Add a new column at the right called "Summary of Changes" if this is the first revision to the supplement (see table below). Also add a new row under the column headers with the current information, keeping all rows previously added. The bottom row should be for Version 1.0, with subsequent versions added above each of the previous rows.

If you are making changes to a supplement for the first time, put "Initial Final Version" in the Summary of Changes column for Version 1.0. Then add a row above with the new version number (1.1 if the changes are considered minor such as a typo, 2.0 if they are major such as variable changes) and summary of changes.


Revision History

DateVersionSummary of Changes
20232024-mm-ddx.x (e.g., 1.1, 2.0)xxx
2019-mm-dd1.0Initial Final Version

© 2023 2024 Clinical Data Interchange Standards Consortium, Inc. All rights reserved. 

...

For CRFs that are created by CDISC with SME input, use this statement:  There is no known standard case report form (CRF) available for this instrument. CDISC created this CRF to represent the instrument, which CDISC believes is in the public domain. This is not an endorsement of the instrument. The creation of this instrument was based on input from PASI (TA or instrument) subject matter experts. Sponsors may create this instrument’s CRF using their style guidelines, but they need to maintain the wording and order of the questions/items and responses as described on the CRF.  (note that if you use this statement, then QRS is not spelled out for the first time until where noted below.) (the related reference article needs to be included as a footnote on the CDISC created CRF)

For CRFs that are created by CDISC based on articles, use this statement. Include the 1st sentence for articles that don't have a CRF.  If the 1st sentence is NOT included, then spell out "case report form (CRF)" in the 2nd sentence:  There is no known standard case report form (CRF) available for this instrument. CDISC created this CRF to represent the instrument, which CDISC believes is in the public domain. This is not an endorsement of the instrument. The creation of this instrument was based on published articles describing the instrument. Sponsors may create this instrument’s CRF using their style guidelines, but they need to maintain the wording and order of the questions/items and responses as described on the CRF.  (note that if you use this statement, then QRS is not spelled out for the first time until where noted below.)

The representation of data collected for this instrument is based on the Study Data Tabulation Model Implementation Guide (SDTMIG) Questionnaires (QS) domain model, which can be found on the CDISC website at: https://www.cdisc.org/standards/foundational/sdtmig.

These The specific implementation details for this instrument are meant to be used in conjunction with the SDTMIG. All CDISC QRS QRS (spell out "questionnaires, ratings, and scales" if this is a CDISC-created CRF and put QRS in parentheses.) documentation packages can be found on the CDISC website at: https://www.cdisc.org/standards/foundational/qrs.

...

This document is a supplement to the SDTMIG for Human Clinical Trials and is covered under Appendix F of that document, which describes representations, warranties, limitations of liability, and disclaimers. Please see Appendix F of the SDTMIG for a complete version of this material.

CDISC specifies how to structure the data that has been collected in a database, not what should be collected or how to conduct clinical clinical assessments orimplement protocols. CDISC disclaims any liability for your use of this material.

Although the United States Food and Drug Administration (US FDA) has provided input with regard to this supplement, this input does not constitute US FDA endorsement of any particular instrument.  (Include this line only for supplements that the US FDA will be reviewing.  Please DO NOT MODIFY the sentence.)

...

For public domain instruments use the following text: CDISC believes this instrument to be in the public domain, but you should perform your own assessment. CDISC has included the QRS Short_Name in the CDISC inventory of QRS data standards supplements. Hence, CDISC developed QSTESTCD and QSTEST for each item based on the actual text on the instrument.   There may be many versions of this instrument. CDISC has chosen to use this version as the data standard.

...

The QRS Short_Name is a multiple-choice instrument that clinicians may use to assess the severity of depressive symptoms. It consists of 30 items, each rated on a 4-point scale. A total score between 0-84 is also captured.

  1. Include a description of scale an original score or other possible responses (You may need multiple numbered points for this, though the IDS-SR did not.). For scale scores original scores use the following language: The scale points include original scores 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. (Replace this sentence for instruments with text only responses with “QSORRES and QSSTRESC are populated with the text description and QSSTRESN is not represented with a numeric value”.

  2. 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.: 

    1. If numeric use this wording: The time period of evaluation for theQRS Short_Name is populated in the --EVLINTfield in ISO 8601 format when the evaluation interval can be precisely described as duration. The evaluation interval for the QRS Short_Name is the past 7 days (--EVLINT = "-P7D")

    2. If text use this wording: The time period of evaluation for the QRS Short_Name is populated in the --EVINTX field as an evaluation interval text value, since it cannot be precisely described as an ISO 8601 duration. The evaluation interval for the QRS Short_Name is "LIFETIME" (--EVINTX = "LIFETIME").
  3. 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".
  4. Records are created in qs.xpt for every collected instrument 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 = "PREFER NOT TO ANSWER"). If the reason is unknown, then QSSTAT = "NOT DONE" and QSREASND is missing.

    2. Due to the variability of copyright holder and public domain derived the derived subscore and overall score generation processes, records are not included for derived subscores or total overall scores that are not provided.
  5. If the instrument standards currently being developed includes conditionally branched items, insert: Some items on the QRS Short_Name may be conditionally branched 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 conditionally branched 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 conditionally branched item, it is represented as follows:

    When assigned with conditionally branched responses are not documented in the instrument’s instructions or a user manual:

    1. QNAM = “QSCBRFL”, QLABEL = “Conditional Branched Item Indicator “Flag“, QVAL = “Y” (this is a QS supplemental qualifier variable related to the record).
    2. QSORRES, QSSTRESC, and QSSTRESN are set to null (missing).

    When assigned conditionally branched responses are documented in instructions or a user manual:

    1. QNAM = “QSCBRFL”, QLABEL = “Conditional Branched Item Indicator“Flag“, QVAL = “Y” (this is a QS supplemental qualifier variable).
    2. The QSORRES responses are represented as follows:
      1. For severity items, QSORRES = "None".
      2. For interference items, QSORRES = "Not at all".
    3. If numeric response values are assigned, they are represented here: QSSTRESC = 0 and QSSTRESN = 0.

       or If if no numeric responses are assigned: QSSTRESC = NULL and QSSTRESN = NULL.

  6. Include this point if overall score(s) are submitted to SDTM. Update blue  blue text: The QRS Short_Name instrument includes a total score  instrument includes an overall score (and subscores or other scores as needed.  If so, change "that is" to "that are") that is considered as captured data on the instrument and is not considered as derived in the example below.  These scores may These scores may be submitted in SDTM or derived and derived in the Analysis Data Model (ADaM) per scoring instructions from [Insert copyright holder's name or other source.].

    1. Subtotal Subscores and total scores overall scores are represented in--ORRES, --STRESC, and --STRESN.
    2. If scores are received or derived by the subscores or overall scores are received or derived by a central provider or vendor or derived by the sponsor, it is recommended that they are submitted to SDTM and verified in ADaM whenever verified in ADaM. It is the sponsors responsibility to do this verification based on the instrument's user manual or instructions from the copyright owner.  If the scoring is proprietary, then wording should be added to that effect to explain that the score is verified in ADaM when feasible.
  7. Please review the decision on not including –EVAL and --EVALID in the QRS Supplement Best Practices topic “--EVAL/–EVALID not included in QRS domains/datasets”.Now we only represent administrative information if it is explicitly collected on an instrument. No assumptions are made for this data; if it's not on the instrument, it's not in the data.

    The SUPPQUAL variables used are a series of non-standard variables that represent collected administrator information, administration device, etc., and these updated SUPPQUAL variables are included in the WIKI non-standard variable registry (Non-standard Variable Registry). For example:

    1. PPRAID which is "Preprinted Administrator Identifier".
    2. COLAVL which is "Collected Administrator Value".

    The supplement version 1.0 of the FAS-NACC UDS V3.0 instrument shows an implementation example.

    The QRS Short_Name instrument collects administrative information as the preprinted examiner’s initials and the collected response. This is represented in the SUPPQUAL variable QNAM = --PPRAID” with QNAM = “Preprinted Administrator Identifier” and QVAL = “EXAMINER’S INITIALS”. The collected initials response is represented with QNAM = “--COLAID” and QNAM = “Collected Administrator Identifier” and QVAL = “ADM1”.

    This is part of the data example for the SUPPQUAL variables.

    The SUPPRS table represents the preprinted and collected administrative items represented on the CRF. 

     supprs.xpt

    STUDYID

    RDOMAIN

    USUBJID

    IDVAR

    IDVARVAL

    QNAM

    QLABEL

    QVAL

    QORIG

    STUDYX

    RS

    100-10001

    RSCAT

    FAS-NACC UDS V3.0

    RSPPRAID

    Preprinted Administrator Identifier

    EXAMINER'S INITIALS

    CRF

    STUDYX

    RS

    100-10001

    RSCAT

    FAS-NACC UDS V3.0

    RSCOLAID

    Collected Administrator Identifier

    ADM1

    CRF

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

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

  10. Terminology

    1. QSCAT, QSTESTCD, QSTEST, QSORRES, QSSTRESC, and QSSTRESN (and other variables such as QSORRESU as needed; only include QSORRES, QSSTRESC, and QSSTRESN if the responses are published in CT with public domains instruments) 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.)

...