Adding Patient Portal Document Templates to OpenEMR Patient Documents

(Jerry P) #1

Okay, I can’t decide so, maybe the community will chime in and let me know if this is a worthwhile endeavor.
Edit: 08/10/2019
Will be including this in v5.0.3 and may bring back to v5.0.2 in first patch.

For those whom may not know, the patient portal has a feature name Patient Documents which is based on text and/or html template documents that may be populated by both tag substitutions and editing document directly by patient. These templates may be imported via Portal Dashboard for individual or all portal patients.
The purpose here being to allow patients to review, sign and/or change documents such as consents, invoices from Posting(EOB), insurance changes and whatever one can dream up. Even an intake form for those that sign up using portals self register feature. I’ll show example later.
Anyway, i’ve added a hook into Demographics Patient Documents that is exposed when a document category is selected like so:

From here one may select to open an individual template or the module but, either way, all current template/document history for the patient will be exposed. i.e.

or in the case of selecting OpenEMR’s canned hipaa consent from pull down:

From here several options can be used:

  • First is to populate template and in this case mostly just get patient to sign:

  • From here one may choose to simply save in which case the document is saved where further edits may be done in portal or here.
  • Chart the document to the category selected from Documents on form open in which case the document is flattened and store appropriately.


    Note that a user/provider signature is available as well if tagged in template.
  • Important to note that in the OpenEMR module a patient is not required to be a portal user but for those that are this is another way to handshake documents with patient that may be important to both clinic or patient. eg. The clinic could pre populate a template document, save and then document is exposed to patient on their portal to complete and send for review and acceptance.

This just seems handy to me.
Some notes on signature:
The new signer module now includes option to send a signature request to a tablet device running the remote signer application which is started via @mdsupport terrific login application hook :
yielding for ipad:

and active:

Note if there is a signature on file it will show and clicking/touching On File signature will populate canvas where a new authorisation will be time stamped and requesting form is populated with signature.
The remote signing feature is automatic where if a remote device is available then signing happens on it otherwise signer pad is popped up on local devices document.

Lastly I may include in this PR a new feature for LBV where i’ve added two new datatypes to editor namely;

I gotta say, I love the encounter preview dialog from layout editor. Just saying:)

Anyway. There is more to all this but hopefully you’ll get the idea if worthwhile having.

eSign and Reports
Templates for Patient Documents: Site ID is missing from session data!
(Stephen Waite) #2

hi @sjpadgett, being able to hook up patient documents to the patient portal you developed is wonderful. Thanks for the detailed post and for your collaboration with @mdsupport :slight_smile:

(Jerry P) #3

These features have examples setup('til midnight pacific) at

Check out the LBF signing form example setup in encounter. It’s groovy :wink: