Templates for Patient Documents

From OpenEMR Project Wiki

Overview

This feature was added to version 4.2.0. It provides the ability to upload Templates in an Open Document format (OpenOffice or LibreOffice) or as plain text. Use them as boilerplates for creating documents that can then be uploaded to the the Patient Summary, Documents tab in the usual way or downloaded to localhost.

Keywords

The .php file has been configured with the following list.

  • {PatientName} (FirstName Middle Lastname)
  • {PatientID} (External ID)
  • {PatientDOB} (yyy-mm-dd)
  • {DOS} (Date of service in the format of yyyy-mm-dd)
  • {ReferringDOC}(Name of Referring Provider)
  • {ChiefComplaint}
  • {Allergies}
  • {ProblemList}
  • {PatientSex}
  • {Address} (street address only i.e. 1224 Oakdale Rd.)
  • {City}
  • {State}
  • {Zip}
  • {PatientPhone} (output in this form: (000)000-0000)

If the user wishes to expand this list of keywords, he must change the codes.

Installing a Template

The first step is to create a Template on your local computer with one of the mentioned word processors.

A sample file, woc.zip, is available as a download. It must be extracted before it can be deployed.

The Template may contain any of these keywords (the fields within {...}, pertaining to information entered in the Patient Summary or from the encounter).

Next step is to name the Template with something memorable.

Remember to give the file the same extension as the word processor. (For Open office it should be "file.odt"). This helps to avoid errors when opening the file for editing before printing.

Navigate from the Left Navigation side bar to Miscellaneous, Document Templates, browse for the file and click Upload.

4dtem.png


6dtem.png

Using a Template

In Documents, a drop-down list has been added where you may select and download an .odt file.

To create a document for a certain patient, be certain to enter some information that will show as in the active encounter.

The Template always has to be connected to a specific patient.

Go to the Patient Summary, Documents tab, click Patient Information, select the Template from the drop-down and click Fetch.


3dtem.png


The downloaded document will have its keywords replaced with actual data from the currently selected patient, referring provider, encounter, etc. This is an illustration.

The file will be opened in the word processor and is ready for some additional corrections, formatting and final editing.

The .odt file can be converted to a .pdf file by clicking the File tab and choosing Export as PDF.

The file can be sent also as e-mail attachment, printed, or saved for later use or for uploading the finalized file in the Documents tab.

Problems

One pitfall is that the word processing application might insert XML tags randomly into the middle of keywords as you type them in (this happens when using a non-plain text word processor). It keeps the parser fields from being recognized as keywords at download time.

Solution: Keep a list of the parser fields as plain text in another plain text file and copy/paste to insert them into the document.

Forum Discussion

Discussion can be found here.