OpenEMR Questionnaire - Introduction

From OpenEMR Project Wiki
Revision as of 18:46, 28 July 2023 by Harley Tuck (talk | contribs) (creating initial page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Introduction

The ‘Questionnaires’ capability for OpenEMR has many aspects. Because of that breadth of scope this tutorial will be limited to importing questionnaires and the basic use of the Questionnaire form, in encounter forms and the patient portal. This is not a tutorial on how to create and use the different implementations of questionnaires that the Questionnaire form can handle, only how to use the form.

The questionnaire was first added to OpenEMR in v 7.0.0; these docs and all pictures are made using the OpenEMR 7.0.1 public demo.


The Questionnaire functionality is provided by the 'New Questionnaire' form which is installed by default starting from OpenEMR ver 7.0.0 with significant new features added for 7.0.1. The form is listed in Forms Admiistration (from main menu: Admin/ Forms/ Forms Administration). It is found in the encounter menu category 'Questionnaire' and can be activated or inactivated or its position in the encounter menu changed, just as any other form.


Be sure to check the [OpenEMR Questionnaire - Conclusion|Conclusion] for other Questionnaire resources, particularly the dev SJP's definitive posts in the forum and multiple contributions from the user community.


Overview of this set of wiki pages:

0. Introduction to the OpenEMR Questionnaire – this document; the preliminary introduction to the Questionnaire form and notes on how to obtain a sample questionnaire R4 JSON file to practice with.

1. Import Questionnaire - how to get the form into OpenEMR

2. Use in Encounters - opening a questionnaire in an encounter summary form and where the answers appear in reports

3. Use in Portal - having a patient fill out a questionnaire in the portal and how to processes it

4. Conclusion - reference materials for the 'New Questionnaire' form, its capabilities and use


Section 0. How to get a sample questionnaire file

Since this is not a tutorial on how to build questionnaires from scratch you’ll need a sample questionnaire to work with. If you already have one proceed with section 1. ‘Import Questionnaire’. If not, the steps below will show you, without details or explanation, how to obtain a simple, non- scoring R4- type questionnaire JSON file which is suitable for use in this tutorial.


1. Browse to

https://lhcformbuilder.nlm.nih.gov/previous/
and click 'Accept' to accept their terms of use (not pictured)


2. Click 'Import' at top left (arrow)

NewQ0q02FormBlder.png


3. Click 'Import a LOINC form'

NewQ0q02ImportFromFile.png











4. Enter any partial name or code number or even just one letter or number


NewQ0q03SelectForm.png










5. Select any suitable form from the resulting list


6. Click 'Import' (oval above)

- the form populates the form builder interface (next picture)


7. Click 'Export' at top left (arrow)

NewQ0q04ImportForm.png














8. See popup: click ‘Export to file’ (next pic)

NewQ0q05ExportToFile.png














9. Select the export format: choose ‘FHIR questionnaire R4’

then click ‘Continue’ (oval below)

NewQ0q06SelFormat.png







It downloads to your browser’s default download directory or folder where it can stay ready for use in this tutorial.



Next page: 1. Import Questionnaire