Versions Compared

Key

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

...

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.
  2. 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.
  3. Update the information in the Page Properties block below as indicated in the block below.
    1. The supplement version number 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'.
  4. 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.
  5. 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.
  6. Unless otherwise noted, text in black applies to all QRS Supplements and should not be deleted.
  7. 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 questionnaire, change 'questionnaire' to 'clinical classification' or 'functional test' as appropriaterule refer to it as instrument.
  8. Remove all information blocks, except for the one immediately below this called 'Information for Reviewers'.
  9. 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.
  10. 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.

...

These specific implementation details for this questionnaire instrument are meant to be used in conjunction with the SDTMIG. All CDISC 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/foundational/qrs.

...

For copyrighted instruments use the following text:  Name of copyright holder (e.g., Board of Regents of The University of Texas System) owns the copyright for the QRS Short_Name instrument and has granted CDISC permission to include this supplement in the CDISC library of QRS data standards supplements. (For supplements that are to be distributed by the copyright holder, add: Name of copyright holder (e.g., Board of Regents of The University of Texas System) will distribute the CDISC supplement package to sponsors when they are approved to use this instrument.) Hence, CDISC developed QSTESTCD and QSTEST for each item based on the actual text on the questionnaireinstrument. (For public domain instruments, add: )There may be many versions of this instrument. CDISC has chosen to use this version as the data standard.

For public domain instruments use the following text: CDISC believes this instrument is in the public domain. CDISC has included the QRS Short_Name in the CDISC library of QRS data standards supplements. Hence, CDISC developed QSTESTCD and QSTEST for each item based on the actual text on the questionnaire instrument. There may be many versions of this instrument in the public domain or copyrighted. CDISC has chosen to use this version as the data standard.

...

The QRS Short_Name is a multiple-choice questionnaire 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 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.

  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.: The time period of evaluation for the QRS Short_Name is populated in the QSEVLINT field 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").

  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.
  4. 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. Language to be used for this assumption is currently under review.'

    This language is currently under review. Remove this point if it does not apply.:  Some items on the QRS Short_Name may be logically skipped per the instrument instructions.  Responses for logically skipped items should be (1) recorded and/or scored according to the instructions provided in the instrument’s user manual, scoring manual, or other documentation provided by the instrument developer and (2) included in the submission dataset. If such instructions are not available, then records for logically skipped items should be included in the submission dataset with:
    ·       QSSTAT = NOT DONE;
    ·       QSREASND = LOGICALLY SKIPPED ITEM; and
    ·       QSORRES, QSSTRESC, and QSSTRESN all set to null
    When submitting data to US FDA or some other regulatory authority to support regulatory review of a medical product, if the electronic data collection system is not capable of automatically populating records for logically skipped items, these records should be post-populated prior to submission and the sponsor will need to explain this in the corresponding reviewer's guide.
  5. 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.

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

  6. This language is currently under review. Evaluator information is only to be included when the information is collected directly on the CRF. Questionnaires 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 questionnaires 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.

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

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

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

...

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

...