Information for Reviewers
Text in black is part of the template used to create this document and is not under review. Please review the blue text; this text represents the changes made to the template that are specific to this QRS instrument.
Revision History
Date | Version |
---|---|
2022-10-28 | 1.0 Draft |
© 2022 Clinical Data Interchange Standards Consortium, Inc. All rights reserved.
1 Introduction
This document describes the CDISC implementation of the Functional Assessment of Cancer Therapy-Hepatobiliary instrument.
CDISC did not modify this questionnaires, ratings, and scales (QRS) instrument to meet Clinical Data Acquisition Standards Harmonization (CDASH) case report form (CRF) standards.
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 specific implementation details for this instrument are meant to be used in conjunction with the SDTMIG. All CDISC QRS documentation packages can be found on the CDISC website at: https://www.cdisc.org/standards/foundational/qrs.
The CDISC Intellectual Property Policy can be found on the CDISC website at: https://www.cdisc.org/about/bylaws.
1.1 Representations and Warranties, Limitations of Liability, and Disclaimers
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 assessments or implement 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.
2 Copyright Status
David Cella, PhD. owns the copyright for the FACT-HEP V4 instrument and has granted CDISC permission to include this supplement 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.
The CDISC documentation of this instrument consists of: (1) controlled terminology, (2) standard database structure with examples, and (3) CRF(s) annotated with the CDISC SDTMIG variables with submission values.
Information for Reviewers
The CRF is attached at the top of the Wiki. When you click the paperclip image, you will find the file for the annotated CRF.
Note: CDISC Controlled Terminology is maintained by National Cancer Institute (NCI) Enterprise Vocabulary Services (EVS). The most recent version should be accessed through the CDISC website at: https://www.cdisc.org/standards/terminology/controlled-terminology.
CDISC has developed this documentation at no cost to the copyright holder or any additional cost to users of the instrument beyond the normal license fees charged by the copyright holder.
CDISC acknowledges Dr. David Cella and FACIT.org, for the approval to include the FACT-HEP V4 in the CDISC data standards.
Reference for the FACT-HEP V4:
- Copyright 1987, 1997 David Cella, Ph.D.
- These materials discuss and/or include FACIT Measurement System, which is owned exclusively by Dr. David Cella. No part of the FACIT Measurement System may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of Dr. David Cella and payment of any applicable fees. Copyright Dr. David Cella. All rights reserved.
Notes on the use of quotation marks:
- Use for text values of a Likert scale: e.g., ...with response options ranging from “never” to “daily."
- Actual numbers of the scale (e.g., 0-3) do not appear in quotation marks while the definitions of these anchors (e.g., 5 = “I always fall asleep”) do.
- Enclose values for variables within quotation marks (e.g., QSTESTCD = "IPA0102")
3 The QS Domain Model
3.1 Assumptions for the QS Domain Model
All assumptions and business rules described in the SDTMIG QS domain are applicable to this supplement. Additional assumptions specific to the FACT-HEP V4 are listed below.
The FACT-HEP V4 is a multiple-choice health-related quality of life questionnaire about problems associated with hepatobiliary cancer. It consists of 45 items rated on a 5-point scale.
All items rated on a 5-point scale include a numeric rating (0-4) and a definition of what is represented by the rating (e.g., 0 = "Not at all", 4 = "Very much"). For the FACT-HEP V4, QSORRES is populated with the text description; the numeric rating is represented in the standardized character and numeric result variables QSSTRESC and QSSTRESN.
FAC01514 may be rated on a 5-point scale or the subject may prefer not to answer. When the checkbox is marked that the subject prefers not to rate the item, this is noted with QSSTAT = "NOT DONE" and QSREASND = "PREFER NOT TO ANSWER". QSORRES, QSSTRESC, and QSSTRESN are all missing.
The time period of evaluation for the FACT-HEP V4 is populated in the QSEVLINT field in ISO 8601 format when the evaluation interval can be precisely described as duration. The evaluation interval for the FACT-HEP V4 is the past 7 days (QSEVLINT = "-P7D").
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".
Records are created in qs.xpt for every item on the instrument:
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.
The FACT-HEP V4 instrument includes subscale scores for each subcategory in addition to trial outcome index, FACT-G, and total scores per FACIT.org's scoring materials and 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 FACIT.org.
Subscores and total scores are represented in QSORRES.
- If scores are received or derived by the sponsor, it is recommended that they are submitted to SDTM and verified in ADaM whenever feasible.
- Terminology
QSCAT, QSTESTCD, and QSTEST values are included in CDISC Controlled Terminology.
A full list of value sets for the result field is provided in Section 4, SDTM Mapping Strategy.
3.2 Example for the QRS FACT-HEP V4 QS Domain Model
The FACT-HEP V4 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 FACT-HEP V4 instrument. The example uses CDISC Controlled Terminology for QSTESTCD, QSTEST, and QSCAT. All original results, matching the CRF item response text, are represented in QSORRES. This result is then represented as a standard numeric score in QSSTRESN and as a standard character representation in QSSTRESC.
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 only 1 or 2 row descriptions are needed, then the information should be included as a paragraph instead.
For the not done visit that is now being included in all QRS supplements, when no reason is collected, information should be included, either in the paragraph before, or as a row description as follows:
Rows 49-60: | Show the subject was not evaluated on this instrument at visit 2. Since the visit was missed, the reason for not completing the visit was not collected, no date is assumed for when the visit would have occurred. |
---|
When the reason is collected for a not done visit, information or a row description should be added as follows:
Rows 49-60: | Show the subject was not evaluated on this instrument at visit 2. Since the reason for not completing the visit was collected, the date is included in --DTC for when the visit was planned. |
---|
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 FACT-HEP V4 instrument.
Dataset Wrapper Debug Message
Please add a row column to your dataset.
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.
STUDYID | RDOMAIN | USUBJID | IDVAR | IDVARVAL | QNAM | QLABEL | QVAL | QORIG |
---|---|---|---|---|---|---|---|---|
STUDYX | QS | P0001 | QSSEQ | Sequence 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 |
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.
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 QRS Short_Name 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.
QSSCAT | QSTESTCD |
---|---|
EMOTIONAL/INFORMATIONAL SUPPORT | QSSS0101 - QSSS0108 |
TANGIBLE SUPPORT | QSSS0109 - QSSS0112 |
AFFECTIONATE SUPPORT | QSSS0113 - QSSS0115 |
POSITIVE SOCIAL INTERACTION | QSSS0116 - QSSS0118 |
ADDITIONAL ITEM | QSSS0119 |
For public domain instrument's published QRS responses
If this is a public domain instrument that has an individual item with published QRS responses, include the following sentence above the—TESTCDs listed with their responses.
The controlled response terminology for the tests below is named --TESTCDOR for the variable RSORRES and --TESTCDSTR for the variables RSSTRESN and RSSTTRESC.
- If this is a public domain instrument with published QRS responses, include the following sentence above the—TESTCDs listed with their responses.
- The controlled response terminology for the tests below is named --TESTCDTXXXOR for the variable RSORRES and --TESTCDTXXXTSTR for the variables RSSTRESN and RSSTTRESC.
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"
QSORRES | QSSTRESC | QSSTRESN |
---|---|---|
Original result 1 | 0 | 0 |
Original result 2 | 1 | 1 |
Original result 3 | 2 | 2 |
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.
For public domain instrument's published QRS responses
If this is a public domain instrument with published QRS responses, include the following sentence above the—TESTCDs listed with their responses. This approach used the CDISC QRS CT instrument's SYNONYM as part of the codelist name.
The controlled response terminology for the tests below is named SYNONYMSET1OR for the variable RSORRES and SYNONYMSET1STR for the variables RSSTRESN and RSSTTRESC.
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"
QSORRES | QSSTRESC | QSSTRESN |
---|---|---|
I never take longer than 30 minutes to fall asleep | 0 | 0 |
I take at least 30 minutes to fall asleep, less than half the time | 1 | 1 |
I take at least 30 minutes to fall asleep, more than half the time | 2 | 2 |
I take more than 60 minutes to fall asleep, more than half the time | 3 | 3 |
Omit the QSSTRESN column when it is not applicable to the dataset.
QSTESTCD = "test code" QSTEST = "test name"
QSORRES | QSSTRESC |
---|---|
yes | Y |
no | N |
For public domain instrument's published QRS responses
If this is a public domain instrument with published QRS responses, include the following sentence above the—TESTCDs listed with their responses.
- The controlled response terminology for the tests below is named --TESTCDTXXXOR for the variable RSORRES and --TESTCDTXXXTSTR for the variables RSSTRESN and RSSTTRESC.
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"
QSORRES | QSSTRESC | QSSTRESN |
---|---|---|
I have not experienced the physical sensation of feeling weighted down and without physical energy | 0 | 0 |
I have occasionally experienced periods of feeling physically weighted down and without physical energy, but without a negative effect on work, school, or activity level | 1 | 1 |
I feel physically weighted down (without physical energy) more than half the time | 2 | 2 |
I feel physically weighted down (without physical energy) most of the time, several hours per day, several days per week | 3 | 3 |
5 Supplemental Qualifier Name Codes
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.
QNAM | QLABEL | QVAL |
---|---|---|
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 ( e.g., SUBJECT VISIT) |
End of Document