This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "201809 Argonaut Questionnaire"

From HL7Wiki
Jump to navigation Jump to search
 
(23 intermediate revisions by 3 users not shown)
Line 4: Line 4:
  
 
'''Argonaut [https://chat.fhir.org/#narrow/stream/20-argonaut Zulip chat stream] for this track.'''
 
'''Argonaut [https://chat.fhir.org/#narrow/stream/20-argonaut Zulip chat stream] for this track.'''
 +
 +
'''Learn about Argonaut Questionnaire activities at the connectathon by reviewing these [https://docs.google.com/presentation/d/1ktxmiar4zbCCWbkmRTJlQtaW09_Z7Hz3kV4WJcyjAgQ/edit?usp=sharing Track Orientation Slides]
 +
 +
'''[https://docs.google.com/presentation/d/1ktxmiar4zbCCWbkmRTJlQtaW09_Z7Hz3kV4WJcyjAgQ/edit Argonaut Track Orientation Slides]
  
 
==Submitting WG/Project/Implementer Group==
 
==Submitting WG/Project/Implementer Group==
Line 12: Line 16:
  
 
==Justification==
 
==Justification==
To pilot the Argonaut Questionnaire Implementation Guide
+
To pilot the [https://argonautproject.github.io/questionnaire/ Argonaut Questionnaire Implementation Guide]
 +
 
 +
The goal of the Argonaut Questionnaire Project is to develop guidance to support interchange of:
 +
 
 +
# Simple forms based on FHIR Version 3.0.1 and specifically the Questionnaire and QuestionnaireResponse resources. This implementation guide provides implementers with FHIR RESTful APIs and guidance to create, use and share between organizations standard assessment forms and the assessment responses.
 +
# Adaptive Questionnaires(1) such as [http://www.healthmeasures.net/explore-measurement-systems/promis PROMIS] forms using a stateless model. This implementation guide provides the basic framework for using Questionnaire and QuestionnaireResponse to preserve the state of the Questionnaire as the client retrieves questions from a remote adaptive questionnaire service.
  
The goal of the Argonaut Questionnaire Project is to develop guidance to support interchange of simple forms based on FHIR Version 3.0.1 and specifically the Questionnaire and QuestionnaireResponse resources. This implementation guide provides implementers with FHIR RESTful APIs and guidance to create, use and share between organizations standard assessment forms and the assessment responses.
+
(1) Adaptive computerized questionnaire administration, where a selection of items is presented on the computer, and based on the answers on those items, the computer selects following items optimized for the testee's estimated ability or trait (https://en.wikipedia.org/wiki/Questionnaire)
  
 
==Proposed Track Lead==
 
==Proposed Track Lead==
Line 30: Line 39:
  
 
<!-- List of the individuals and/or organizations that have indicated a desire to attend the connectathon and implement this track -->
 
<!-- List of the individuals and/or organizations that have indicated a desire to attend the connectathon and implement this track -->
TBD<your name here!>
+
 
 +
* Meditech
 +
* Epic
 +
* All Scripts
 +
* Partners
 +
* ...
  
 
==Roles==
 
==Roles==
 
<!-- Roles are sets of functionality (generally defined by a Conformance resource) that a single system can take on -->
 
<!-- Roles are sets of functionality (generally defined by a Conformance resource) that a single system can take on -->
See the [https://github.com/argonautproject/questionnaire Argonaut Questionnaire Implementation Guide] for
 
  
====Provider EHR ====
+
# '''Adaptive Questionnaire Service''': A System that is capable of providing questions in response to requests and contains logic for determination of the next question and calculation of the score for an Adaptive Questionnaire. For this Implementation Guide, this service is treated as a “Black Box”
 +
# '''“Assessment-Bank“'''(1): A form repository for the collection of the assessments. It is accessible to both the providers and form editors as a FHIR Questionnaire endpoint.
 +
# (Optionally) '''“Answer-Bank“'''(2): A repository for the collection of the completed assessments (‘answers’). It is accessible to the providers as a FHIR QuestionnaireResponse endpoint. It may be internal or external to the Provider EHR.
 +
#'''Form-filler''': The software application interacting with the user to get answers for a questionnaire. This is also known as the Client and may be a:
 +
#* Patients apps that launch standalone  ( i.e, a third party SMART on FHIR app )
 +
#* Patient apps that launch from a portal
 +
#* Provider apps that launch standalone
 +
#* Provider apps that launch from a portal
 +
#'''Provider EHR'''(3): The System that is capable of retrieving, rendering and displaying the assessment to a subject or a provider to fill out.
  
The System that is capable of retrieving, rendering and displaying the assessment to a subject or a provider to fill out.
 
  
====Assessment Bank====
+
See the [https://argonautproject.github.io/questionnaire/#actors Argonaut Questionnaire Implementation Guide] for more details and descriptions of the Roles and Actors
  
A form repository for the collection of the assessments. It is accessible to both the providers and form editors as a FHIR Questionnaire endpoint.
+
(1) This is called the ‘Form Manager’ in the [http://build.fhir.org/ig/HL7/sdc/ Structured Data Capture Initiative (SDC)] ↩
  
====Answer Bank====
+
(2) This is called the ‘Form Receiver/Archiver’ in the [http://build.fhir.org/ig/HL7/sdc/ Structured Data Capture Initiative (SDC)] ↩
  
A repository for the collection of the completed assessments (‘answers’). It is accessible to the providers as a FHIR QuestionnaireResponse endpoint.
+
(3) This is called the ‘Form Filler’ and/or ‘Form Response Handler’ in the [http://build.fhir.org/ig/HL7/sdc/ Structured Data Capture Initiative (SDC)] ↩
  
 
==Scenarios==
 
==Scenarios==
  
See the [https://github.com/argonautproject/questionnaire Argonaut Questionnaire Implementation Guide] for the initial use cases.
+
See the [https://github.com/argonautproject/questionnaire Argonaut Questionnaire Implementation Guide] for the detailed deccription of API and workflow for these  use cases.
  
 
=== Static Forms ===
 
=== Static Forms ===
  
 +
[[Image:Static-workflow.png|800px]]
  
 
# [https://argonautproject.github.io/questionnaire/static.html#form-author-editor-creates-or-updates-assessment Form Author Editor Creates Or Updates Assessment]  
 
# [https://argonautproject.github.io/questionnaire/static.html#form-author-editor-creates-or-updates-assessment Form Author Editor Creates Or Updates Assessment]  
Line 64: Line 85:
  
 
====Computer Adaptive Forms====
 
====Computer Adaptive Forms====
 +
 +
 +
[[Image:Adaptive-workflow.jpg|800px]]
 +
 +
# [https://argonautproject.github.io/questionnaire/adaptive.html#adaptive-questionnaire-discovery Adaptive Questionnaire Discovery]
 +
# [https://argonautproject.github.io/questionnaire/adaptive.html#initiate-adaptive-questionnaire Initiate Adaptive Questionnaire]
 +
# [https://argonautproject.github.io/questionnaire/adaptive.html#get-next-question Get Next Question]
 +
# [https://argonautproject.github.io/questionnaire/adaptive.html#adaptive-questionnaire-is-complete Adaptive Questionnaire is Complete]
 +
# [https://argonautproject.github.io/questionnaire/adaptive.html#questionnaireresponse-and-scoring QuestionnaireResponse and Scoring]
 +
 +
<br />
  
 
==Test Implementations==
 
==Test Implementations==
Line 69: Line 101:
  
  
[https://www.getpostman.com/collections/117791eaad9b5242c5e6 Run in Postman]
+
====Static files:====
 +
 
 +
'''Questionnaires for testing:'''
 +
 
 +
''NOTE:  These are for educational and testing purpose only - See the copyright information and do not share or distribute without expressed permission from the User ''
 +
 
 +
#[The Alcohol Use Disorder Identification Test (AUDIT) Form:  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-audit]
 +
#[Ages and Stages Questionnaire (ASQ-3: Sample 16 Month Questionnaire  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-asq3]
 +
#[Drug Abuse Screening Test (DAST-10:)  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-dast]
 +
#[Housing Instability Questionnaire:  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-housing]
 +
#[Patient Health Questionnaire-9 (PHQ-9):  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-phq9]
 +
#[Argonaut Questionnaire Sampler:  http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-sampler]
 +
 
 +
''' Reference Implementations:'''
 +
 
 +
#[https://app.getpostman.com/run-collection/117791eaad9b5242c5e6 Run in Postman]
 +
#test rendering tool: [http://gettingstarte-cjfwz-env.us-west-2.elasticbeanstalk.com/ Argonaut Project Questionnaire Test Renderer]
 +
 
 +
====Adaptive Questionnaire====
  
 +
''' Reference Simulation'''
  
 
[http://gettingstarte-cjfwz-env.us-west-2.elasticbeanstalk.com/ Argonaut Project Questionnaire Test Renderer]
 
[http://gettingstarte-cjfwz-env.us-west-2.elasticbeanstalk.com/ Argonaut Project Questionnaire Test Renderer]

Latest revision as of 21:14, 27 September 2018


Argonaut Questionnaire

Argonaut Zulip chat stream for this track.

Learn about Argonaut Questionnaire activities at the connectathon by reviewing these Track Orientation Slides

Argonaut Track Orientation Slides

Submitting WG/Project/Implementer Group

ArgonautProject logo black.png

Justification

To pilot the Argonaut Questionnaire Implementation Guide

The goal of the Argonaut Questionnaire Project is to develop guidance to support interchange of:

  1. Simple forms based on FHIR Version 3.0.1 and specifically the Questionnaire and QuestionnaireResponse resources. This implementation guide provides implementers with FHIR RESTful APIs and guidance to create, use and share between organizations standard assessment forms and the assessment responses.
  2. Adaptive Questionnaires(1) such as PROMIS forms using a stateless model. This implementation guide provides the basic framework for using Questionnaire and QuestionnaireResponse to preserve the state of the Questionnaire as the client retrieves questions from a remote adaptive questionnaire service.

(1) Adaptive computerized questionnaire administration, where a selection of items is presented on the computer, and based on the answers on those items, the computer selects following items optimized for the testee's estimated ability or trait (https://en.wikipedia.org/wiki/Questionnaire)

Proposed Track Lead

Eric Haas

Brett Marquard

FHIR version

STU3

Expected participants

  • Meditech
  • Epic
  • All Scripts
  • Partners
  • ...

Roles

  1. Adaptive Questionnaire Service: A System that is capable of providing questions in response to requests and contains logic for determination of the next question and calculation of the score for an Adaptive Questionnaire. For this Implementation Guide, this service is treated as a “Black Box”
  2. “Assessment-Bank“(1): A form repository for the collection of the assessments. It is accessible to both the providers and form editors as a FHIR Questionnaire endpoint.
  3. (Optionally) “Answer-Bank“(2): A repository for the collection of the completed assessments (‘answers’). It is accessible to the providers as a FHIR QuestionnaireResponse endpoint. It may be internal or external to the Provider EHR.
  4. Form-filler: The software application interacting with the user to get answers for a questionnaire. This is also known as the Client and may be a:
    • Patients apps that launch standalone ( i.e, a third party SMART on FHIR app )
    • Patient apps that launch from a portal
    • Provider apps that launch standalone
    • Provider apps that launch from a portal
  5. Provider EHR(3): The System that is capable of retrieving, rendering and displaying the assessment to a subject or a provider to fill out.


See the Argonaut Questionnaire Implementation Guide for more details and descriptions of the Roles and Actors

(1) This is called the ‘Form Manager’ in the Structured Data Capture Initiative (SDC)

(2) This is called the ‘Form Receiver/Archiver’ in the Structured Data Capture Initiative (SDC)

(3) This is called the ‘Form Filler’ and/or ‘Form Response Handler’ in the Structured Data Capture Initiative (SDC)

Scenarios

See the Argonaut Questionnaire Implementation Guide for the detailed deccription of API and workflow for these use cases.

Static Forms

Static-workflow.png

  1. Form Author Editor Creates Or Updates Assessment
  2. Form Author Editor Uploads The Assessments To The Assessment Bank
  3. Provider EHRSs Retrieve Standard Assessments From The Assessment Bank
  4. The Provider EHR Renders And Displays The Standard Assessment To The End User
  5. The End User Completes The Assessment
  6. The Provider EHR Posts Responses to the Answer Bank
  7. The Provider EHR Retrieves The Assessment Responses from the Answer Bank

Computer Adaptive Forms

Adaptive-workflow.jpg

  1. Adaptive Questionnaire Discovery
  2. Initiate Adaptive Questionnaire
  3. Get Next Question
  4. Adaptive Questionnaire is Complete
  5. QuestionnaireResponse and Scoring


Test Implementations

Static files:

Questionnaires for testing:

NOTE: These are for educational and testing purpose only - See the copyright information and do not share or distribute without expressed permission from the User

  1. [The Alcohol Use Disorder Identification Test (AUDIT) Form: http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-audit]
  2. [Ages and Stages Questionnaire (ASQ-3: Sample 16 Month Questionnaire http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-asq3]
  3. [Drug Abuse Screening Test (DAST-10:) http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-dast]
  4. [Housing Instability Questionnaire: http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-housing]
  5. [Patient Health Questionnaire-9 (PHQ-9): http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-phq9]
  6. [Argonaut Questionnaire Sampler: http://sqlonfhir-stu3.azurewebsites.net/fhir/Questionnaire/questionnaire-example-sampler]

Reference Implementations:

  1. Run in Postman
  2. test rendering tool: Argonaut Project Questionnaire Test Renderer

Adaptive Questionnaire

Reference Simulation

Argonaut Project Questionnaire Test Renderer