Difference between revisions of "Templates for Patient Documents"

From OpenEMR Project Wiki
Line 2: Line 2:


==Overview==
==Overview==
This feature is new as of OpenEMR release 4.2.0.  It provides the ability to upload Templates in an Open Document format (OpenOffice or LibreOffice. Not sure about MSWord, just try), or as plain text or perhaps for other formats. Use them as boilerplate for creating documents that can then be uploaded to the patient documents area in the usual way or downloaded to the "Local" computer.
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 boilerplate 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)
:* {PatientName}  (FirstName Middle Lastname)
Line 9: Line 11:
:* {PatientDOB}  (yyy-mm-dd)
:* {PatientDOB}  (yyy-mm-dd)
:* {DOS}          (Date of service in the format of yyyy-mm-dd)
:* {DOS}          (Date of service in the format of yyyy-mm-dd)
:* {ReferringDOC}(Name of referrer doctor)
:* {ReferringDOC}(Name of Referring Provider)
:* {ChiefComplaint}
:* {ChiefComplaint}
:* {Allergies}
:* {Allergies}
Line 20: Line 22:
:* {PatientPhone}  (output in this form: (000)000-0000)
:* {PatientPhone}  (output in this form: (000)000-0000)


Remember to give the file the extension of the program it is made with. This helps to open the file when ready to correct before printing with your favorite editing software. (For Open office it should be "file.odt")
If the user wishes to '''expand''' this list of keywords, he must '''change''' the [https://github.com/sunsetsystems/openemr/commits/doctemplates codes].
 
Remember to give the file the extension of the program it is made with. This helps to open the file when ready to correct before printing with your favorite editing software. (For Open office it should be "file.odt").


==Installing a Template==
==Installing a Template==
The first step is to create a Template on your local computer with one of the mentioned word processors.
The first step is to create a Template on your local computer with one of the mentioned word processors.
A sample file, [http://www.open-emr.org/wiki/index.php/File:Woc.zip 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).
The Template may contain any of these keywords (the fields within {...}, pertaining to information entered in the Patient Summary or from the encounter).


'''N.B.''':  If the user wishes to expand the list of keywords, he must change the [https://github.com/sunsetsystems/openemr/commits/doctemplates codes].
Next step is to upload the Template with the keywords and give the Template a well recognizable name.  
 
Next step is to upload the Template made with the keywords and give the Template a well recognizable name.  


Navigate from the Left Navigation side bar to Miscellaneous, then to Document Templates.
Navigate from the Left Navigation side bar to Miscellaneous, then to Document Templates.
[[File:6doctem.png|center]]
[[File:4dtem.png|center]]






[[File:5doctem.png|center]]
[[File:6dtem.png|center]]




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


'''Sample Templates in tar.gz format:'''
To create a document for a certain patient, be certain to enter some information that will show as in the active encounter.  
 
The Donations file is a more to the point document with only essentials.
 
The HIPAA file contains more keywords.
 
Download this [http://www.open-emr.org/wiki/index.php/File:2templates.tar.gz file] and extract to access the 2 sample templates.
 
==Using a Template==
In the documents area, a drop-list has been added where you may select and download a document.


To create a document for a certain patient, be sure to enter some information that will show as in the active encounter.  
The Template always has to be connected to a specific patient.


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 menu and click Fetch.


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


[[File:3doctem.png|center]]
[[File:3dtem.png|center]]


   
   


The downloaded document will have its keywords replaced with actual data from the currently selected patient, referring doctor provider, encounter, etc.  This is an [[Media:1hip.pdf|illustration]].
The downloaded document will have its keywords replaced with actual data from the currently selected patient, referring doctor provider, encounter, etc.  This is an [[Media:Woc_Boleyn.pdf|illustration]].


''If the fields are correctly populated, the Document should show the information without {...}.''
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.
 
'''There you are:''' The file will be opened in OpenOffice writer (another great FreeWare product) 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 send as e-mail attachment, printed, or saved for later use or for uploading the finalized file as a patient document in the usual way.


==Problems==
==Problems==
One gotcha 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.  
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.
: '''Advice:''' keep a list of the Parser Fields as plain text in another plain text file and Copy and Paste to insert them into the document.
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==
==Forum Discussion==


Discussion can be found [http://sourceforge.net/p/openemr/discussion/202506/thread/89134be4/?limit=25#e21d here]  
Discussion can be found [http://sourceforge.net/p/openemr/discussion/202506/thread/89134be4/?limit=25#e21d here].
 


[[Category:User Guide 4.2.0]][[Category:User Guide]]
[[Category:User Guide 4.2.0]][[Category:User Guide]]

Revision as of 15:46, 21 January 2016

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 boilerplate 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.

Remember to give the file the extension of the program it is made with. This helps to open the file when ready to correct before printing with your favorite editing software. (For Open office it should be "file.odt").

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 upload the Template with the keywords and give the Template a well recognizable name.

Navigate from the Left Navigation side bar to Miscellaneous, then to Document Templates.

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 menu and click Fetch.


3dtem.png


The downloaded document will have its keywords replaced with actual data from the currently selected patient, referring doctor 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.