Difference between revisions of "Use the Carecoordination module"

From OpenEMR Project Wiki
(added page: use ccd module)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Purpose =
= Purpose =
This document shows how to use the CCDA module as found in OpenEMR 4.2.x: creating a CCDA file for an existing patient; creating a new patient by importing a CCDA file and importing CCDA data for an existing patient.
This document shows how to use the CCDA module as found in OpenEMR 4.2.x and higher: creating a CCDA file for an existing patient; creating a new patient by importing a CCDA file and importing CCDA data for an existing patient.


= Introduction/ Caveats =
= Introduction/ Caveats =
Line 19: Line 19:


== Create a CCDA from an existing patient record ==
== Create a CCDA from an existing patient record ==
* For testing, we created a 4 yr old patient to be sure some Clinical Remindedrs would be activated.
* For testing, we created a 4 yr old patient to be sure some Clinical Reminders would be activated.
* Ensure that an encounter exists for any patient whose record is being exported to CCDA<br/>  
* Ensure that an encounter exists for any patient whose record is being exported to CCDA<br/>  
:1. On left Nav Menu:
:1. On left Nav Menu:
Line 25: Line 25:
::''''Modules→CareCoordination'''' (left oval)
::''''Modules→CareCoordination'''' (left oval)


 
[[File:ccda-020t.png|thumb|600px|center|For full sized image click pic and select 'Full resolution' link]]
 
 
[[Image:ccda-020.png|center]]


:2. Click ''''Export'''' tab (top arrow)
:2. Click ''''Export'''' tab (top arrow)
Line 40: Line 37:




[[Image:ccda-021-tocSrch.png|right]]
[[Image:ccda-021-tocSrcht.png|thumb|300px|right|For larger image click pic]]


Alternatively you may click the ''''Search'''' button and search by:
Alternatively you may click the ''''Search'''' button and search by:
Line 67: Line 64:




[[Image:ccda-022-IMO.png|right]]
[[Image:ccda-022-IMOt.png|thumb|300px|right|For larger image click pic]]




Line 97: Line 94:




[[Image:ccda-023-syndsurv.png|right]]
[[Image:ccda-023-syndsurvt.png|thumb|300px|right|For larger image click pic]]
 
 
 
 
 
 




Line 129: Line 132:




[[Image:ccda-024.png|center]]
[[Image:ccda-024t.png|thumb|512px|center|For larger image click pic, then 'Full resolution']]








[[Image:ccda-030.png|right]]
[[Image:ccda-030t.png|thumb|400px|center|For larger image click pic]]


:6. Click "Send To" button (arrow)
:6. Click "Send To" button (arrow)
Line 141: Line 144:


:8. Click ''''SEND'''' button (rectangle)
:8. Click ''''SEND'''' button (rectangle)




Line 158: Line 157:


After OpenEMR processes it you will be able to download the CCDA.zip file according to your OS/ browser method (not pictured).
After OpenEMR processes it you will be able to download the CCDA.zip file according to your OS/ browser method (not pictured).


== Import external CCDA file ==
== Import external CCDA file ==
Line 165: Line 163:


:1. When you receive an external CCDA file place it in a known location e.g., Downloads or some purpose- made directory/ folder (MS Windows 7 system pictured)
:1. When you receive an external CCDA file place it in a known location e.g., Downloads or some purpose- made directory/ folder (MS Windows 7 system pictured)
[[Image:ccda-040.png|right]]


:2. Find and unzip the incoming CCDA.zip file.  
:2. Find and unzip the incoming CCDA.zip file.  
Line 174: Line 169:




[[Image:ccda-040t.png|thumb|400px|center|For larger image click pic, then 'Full resolution']]




Line 182: Line 178:




:3. Navigate to its extraction location




 
[[Image:ccda-050t.png|thumb|400px|center|For larger image click pic, then 'Full resolution']]
 
 
 
[[Image:ccda-050.png|right]]
 
 
 
 
 
 
 
 
 
 
:3. Locate where it was extracted to.




Line 237: Line 219:




[[Image:ccda-060.png|center]]
[[Image:ccda-060t.png|thumb|600px|center|For larger image click pic]]




Line 247: Line 229:




[[Image:ccda-061.png|center]]
[[Image:ccda-061t.png|thumb|600px|center|For larger image click pic]]


:* Icons at right of line allow various treatments of the incoming file.
:* Icons at right of line allow various treatments of the incoming file.
Line 255: Line 237:
:* Click the very left triangle (below) of the patient line for read- only display of all the health information in the CCDA
:* Click the very left triangle (below) of the patient line for read- only display of all the health information in the CCDA


[[Image:ccda-065.png|center]]
[[Image:ccda-065t.png|thumb|600px|center|For larger image click pic, then 'Full resolution']]




Line 262: Line 244:


=== Add as new Patient ===
=== Add as new Patient ===
[[Image:ccda-061a.png|right]]
[[Image:ccda-061at.png|right]]




Line 280: Line 262:


=== View Details ===
=== View Details ===
[[Image:ccda-60Details0.png|right]]
[[Image:ccda-60Details0t.png|right]]
 
Produces a two part printable html display of the CCDA data.
Produces a two part printable html display of the CCDA data.


Line 295: Line 278:




[[Image:ccda-080.png|right]]
[[Image:ccda-080t.png|thumb|350px|center|For larger image click pic]]
The top is CCDA document identifiers/ metadata
The top is CCDA document identifiers/ metadata


Line 315: Line 298:
The bottom is the CCDA data.
The bottom is the CCDA data.


[[Image:ccda-60Details1.png|center]]
[[Image:ccda-60Details1.png|thumb|600px|center|For larger image click pic]]






=== Merge to any patient ===
=== Merge to any patient ===
[[Image:ccda-061b.png|right]]
[[Image:ccda-061bt.png|right]]
This icon appears when the incoming patient does NOT already exist in the system. CCDA data may be merged into the record of any other existing patient.
This icon appears when the incoming patient does NOT already exist in the system. CCDA data may be merged into the record of any other existing patient.


Line 330: Line 313:




[[Image:ccda-061ba.png|right]]
[[Image:ccda-061bat.png|thumb|400px|center|For larger image click pic]]
:1. Click icon and the Merge panel appears
:1. Click icon and the Merge panel appears


Line 351: Line 334:
=== Review and Approve ===
=== Review and Approve ===


[[Image:ccda-066a.png|right]]
[[Image:ccda-066at.png|right]]


This icon appears when the patient already exists in the system.
This icon appears when the patient already exists in the system.
Line 376: Line 359:




[[Image:ccda-066.png|center]]
[[Image:ccda-066t.png|thumb|600px|center|For larger image click pic]]





Revision as of 17:40, 2 March 2018

Purpose

This document shows how to use the CCDA module as found in OpenEMR 4.2.x and higher: creating a CCDA file for an existing patient; creating a new patient by importing a CCDA file and importing CCDA data for an existing patient.

Introduction/ Caveats

This document shows the workflows used in a testing environment so may not exactly duplicate all aspects of clinical use. But they should be close.

This summary shows how to perform three activities:

  • Create a CCDA from an existing patient record
  • Create new patient from CCDA file
  • import existing patient data from CCDA

Refer to the wiki page Z&H's CCDA Module to get the module ready to use. An OpenEMR Administrator's user account is required for these activities.

Many thanks to Z&H Healthcare for contributing the CCDA module and to Brady Miller for most of the original instructions used to create this tutorial.

- HTuck – MI-Squared

Procedures

Create a CCDA from an existing patient record

  • For testing, we created a 4 yr old patient to be sure some Clinical Reminders would be activated.
  • Ensure that an encounter exists for any patient whose record is being exported to CCDA
1. On left Nav Menu:
'Modules→CareCoordination' (left oval)
For full sized image click pic and select 'Full resolution' link
2. Click 'Export' tab (top arrow)
3. Select the type of CCDA to produce (top rectangle)


Transition of Care is default
Patients who have exportable encounters are automatically listed


For larger image click pic

Alternatively you may click the 'Search' button and search by:

  • encounter date range
  • pt name/ id
  • encounter number











For larger image click pic







Export Immunization CCDAs







Syndromic Surveillance CCDA


For larger image click pic















Note: Immunization and Syndromic Surveillance CCDAs were not tested


4. Generate the patient listing with the 'Search' button
5. Select the checkbox at right end of the patient listing (circle)


For larger image click pic, then 'Full resolution'



For larger image click pic
6. Click "Send To" button (arrow)
7. Download panel opens; select 'Download' (oval)
8. Click 'SEND' button (rectangle)





It was occasionally necessary to click the 'Transition of Care' sub-tab to display the 'Send To' button


After OpenEMR processes it you will be able to download the CCDA.zip file according to your OS/ browser method (not pictured).

Import external CCDA file

When you receive a CCDA file you may create a new patient with it or merge the information in it with an existing patient's record.

1. When you receive an external CCDA file place it in a known location e.g., Downloads or some purpose- made directory/ folder (MS Windows 7 system pictured)
2. Find and unzip the incoming CCDA.zip file.



For larger image click pic, then 'Full resolution'





3. Navigate to its extraction location


For larger image click pic, then 'Full resolution'



Buried two directories (folders) deep in the extracted content is a file "CCDA_[number].xml" with a "xml" extension (NOT the xsl one).


It may be convenient to move this xml file to a more accessible location e.g., your desktop or Downloads.





Back to OpenEMR to create a patient from the CCDA xml data.


In real life you wouldn't have the patient in your system yet. If you made the CCDA file from an existing patient, you'll need to delete the patient you used to create the CCDA file.
Also- CCR and CCD files were not available to test but those tabs have the same icons as Transition of Care so presumably their function is similar?


4. In left nav menu: 'Modules → Carecoordination' (left oval below)
5. Click 'Import' tab (arrow)
6. On Import tab select new 'CCDA' subtab (rectangle)
7. Click the upload file icon (right circle)



For larger image click pic


8. Use your browser dialog to locate and select that xml file from step 3 above (not pictured)


A row appears with some patient identifiers from the CCDA file.


For larger image click pic
  • Icons at right of line allow various treatments of the incoming file.


  • Click the very left triangle (below) of the patient line for read- only display of all the health information in the CCDA
For larger image click pic, then 'Full resolution'



Add as new Patient

Ccda-061at.png


Precisely that.

9. Click the head icon (oval at right)
10. Agree to "Add as new patient" (dialog not pictured)


It is done.


Alternatively, the other icons allow you to review or edit the CCDA information before adding the new patient.


View Details

Ccda-60Details0t.png

Produces a two part printable html display of the CCDA data.







For larger image click pic

The top is CCDA document identifiers/ metadata









The bottom is the CCDA data.

For larger image click pic


Merge to any patient

Ccda-061bt.png

This icon appears when the incoming patient does NOT already exist in the system. CCDA data may be merged into the record of any other existing patient.





For larger image click pic
1. Click icon and the Merge panel appears
2. Enter the existing patient's PID in merge panel
3. Select from list of possible matches







Review and Approve

Ccda-066at.png

This icon appears when the patient already exists in the system.

It allows you to review, edit then accept incoming data.







  • Edit an entry and select 'Update' in the dropdown (oval lower right below)
  • 'Import All' button stops edits at their current state preventing further changes (arrow top right)
  • 'Accept' or 'Discard' buttons (rectangle top center) takes the changes into the patient record or rejects the CCDA import.
  • Back arrow (circle top left) lets you navigate back to the main import screen.



For larger image click pic