Questionnaires & Assessments
Creating, updating and embedding FHIR Questionnaires for both patients and practitioners is a common use-case for Medplum.
- Medplum app supports creating and updating Questionnaires
- Questionnaire react component can be embedded in patient facing or practitioner facing applications
- QuestionnaireBuilder react component can be embedded in applications as well
- QuestionnaireResponse resources can also be viewed in the Medplum app
- Bot for QuestionnaireResponse is one of the most common automations
- Questionnaire Features and Fixes on Github
Guides
- Upload and Use Questionnaires: try a form in the Medplum App.
- Modeling Questionnaires and Responses: define questions, initial values, and basic conditions.
- Advanced Questionnaire Authoring: add pages, calculations, and expression-based conditions; check supported SDC features.
- Modular and Composite Questionnaires: reuse sections across forms and compose a complete definition before publishing.
- Saving and Resuming Responses: embed a form, save drafts, reopen responses, and submit them for processing.
- Parsing Questionnaire Responses: extract resources or process answers with a Bot.
Key Resources
flowchart BT Q[<table><thead><tr><th>Questionnaire</th></tr></thead><tbody><tr><td>ICA Assessment</td></tr></tbody></table>] subgraph p1 [<i>Patient 1</i>] QR1[<table><thead><tr><th>QuestionnaireResponse</th></tr></thead><tbody><tr><td>Homer Simpsons' Response</td></tr></tbody></table>] Obs11[<table><thead><tr><th>Observation</th></tr></thead><tbody><tr><td>Heart Rate: 150 bpm</td></tr></tbody></table>] -->|basedOn| QR1 Obs12[<table><thead><tr><th>Observation</th></tr></thead><tbody><tr><td>BMI: 300</td></tr></tbody></table>] -->|basedOn| QR1 RA11[<table><thead><tr><th>RiskAssessment</th></tr></thead><tbody><tr><td>Future Fall Risk: 80%</td></tr></tbody></table>] -->|basedOn| QR1 condition1[<table><thead><tr><th>Condition</th></tr></thead><tbody><tr><td>Hypertension</td></tr></tbody></table>] -->|evidence.detail| QR1 end subgraph p2 [<i>Patient 2</i>] QR2[<table><thead><tr><th>QuestionnaireResponse</th></tr></thead><tbody><tr><td>Rick Sanchez's Response</td></tr></tbody></table>] Obs21[<table><thead><tr><th>Observation</th></tr></thead><tbody><tr><td>Heart Rate: 190 bpm</td></tr></tbody></table>] -->|basedOn| QR2 Obs22[<table><thead><tr><th>Observation</th></tr></thead><tbody><tr><td>BMI: 110 </td></tr></tbody></table>] -->|basedOn| QR2 RA21[<table><thead><tr><th>RiskAssessment</th></tr></thead><tbody><tr><td>Future Fall Risk: 20%</td></tr></tbody></table>] -->|basedOn| QR2 condition2[<table><thead><tr><th>Condition</th></tr></thead><tbody><tr><td>Diabetes</td></tr></tbody></table>] -->|evidence.detail| QR2 end QR1 --> Q QR2 --> Q
| Resource | Description |
|---|---|
Questionnaire | Definition of questions/answers. 1 per form. |
QuestionnaireResponse | A patient's responses to each question. 1 per patient, per instance. |
Observation | A structured representation of a point-in-time result measured by an assessment. |
RiskAssessment | A specialized form of an Observation tailored to propensity measurements. |
Condition | Records a long-term diagnosis for a Patient. |
Key Code Systems
| Code System | Description |
|---|---|
| LOINC | Used to tag questions and answers. Also has predefined standard assessments. |
| ICD-10 | Used to annotate Condition resources for billing. |
Other Resources
- Questionnaire Video on Youtube
- Questionnaire Core Extensions - Because of the wide variety of data collection applications, the
Questionnaireresource has the most "core extensions" of any FHIR resource. - Structured Data Capture (SDC) Implementation Guide - A collection of profiles, extensions, and best practices for advanced questionnaire use cases.
- Modular Forms - Reuse sections and questions between questionnaires
- Advanced Rendering - Additional extensions to inform how a questionnaire is displayed.
- List of SDC implementations - Wiki page with a number of Form Builders and Form Fillers that implement some part of the SDC guide