Tables


EHI Export Format For openemr.openemr

Documentation Explanation

This is the documentation for the ONC (2015) ยง170.315(b)(10) Electronic Health Information export feature in OpenEMR

The Electronic Health Information Export files are all contained inside a zip folder where each zip contains a batch of 1 or more patients. A single patient export will contain only 1 patient in the batch.

Zips are between aproximately 1MB-4GB in size which is configurable at the time of export. Each zip file is structured as follows

ehi-export-<UNIQUEID>.zip

  • /images/ - Contains any images that are used as part of the data export such as the visual pain map form. If a data element stores images in this directory it will be specified in the Table's column comments description.
  • /documents/<pid>/ - Holds the exported patient documents stored in the patient document storage system. Each patient will have their own folder where the folder name is the unique patient identifier (pid) stored in the patient_data.pid column. Document meta information will be found in the documents table stored in the documents.csv file. If the exporter chose to skip documents being exported or there are no patient documents in the system, this folder will not be present in the zip file.
  • README - The readme file that includes the links to this documentation
  • <table_name>.csv - For each table name that patient data was found to be exported for the given batch there will be a corresponding file in comma separated value (CSV) format. The definition of the data and its relationships are described in this documentation site. If a patient does not have data for a specific table there will be no CSV file for that table in the zip file.

The definitions of each of the data elements, their data types and any relevant comments on interpreting the data element can be found by reading the table definition documentation on this page or finding the specific column in the Columns page.

A visual representation of the relationships between the data elements can be found on the Relationships

Every batch zip file is self-contained and can be used to import that batch of patients into another EHR. Zip files will have duplicate data for supporting entity elements such as insurance companies, list_options, users, etc. These supporting table elements will need to have duplicate checks added when importing an entire patient population

XML Representation for each of the EHI table elements that are being exported
Insertion Order - Useful for knowing the order of loading data into a database Deletion Order - Useful for knowing the order of purging data from a database
TABLES 322
COLUMNS 4172

Tables

Table / View Children Parents Columns Comments
gacl_aro_groups_map 0 0 2
product_registration 0 0 8
groups 17 1 3

Represent groups of users in the system

gacl_acl_sections 0 0 5
onsite_messages 0 0 7

Patient secure chat messages to and from clinical staff for real time communication

audit_details 0 0 6
form_eye_mag_prefs 0 0 12
form_eye_mag_orders 0 1 10

This table is used to track eye-related orders, such as eyeglass or contact lens orders.

notification_settings 0 0 7
gacl_axo_groups_map 0 0 2
sct2_description2 0 0 9
form_track_anything 1 3 6

Clinical note form that allows clinicians to provide point in time and longitudinal tracking of any data element they configure

rule_target 0 0 7
gacl_aro_seq 0 0 1
procedure_answers 0 2 6

Answers to questions that are requested to be answered for a given procedure by a procedure provider (lab, or other provider)

payments 0 0 11
insurance_companies 5 1 15

Insurance company

facility 11 0 39

The facility table holds all of the facilities that provide healthcare in the EMR. It contains the primary billing location and other service locations/organizations that are not insurance companies tracked inside the EMR

dated_reminders 0 0 10
icd10_reimbr_dx_9_10 0 0 11
direct_message_log 0 0 11
procedure_order_relationships 0 1 7

Links ServiceRequests to supporting clinical information

categories 1 0 8

Categories that documents can be assigned to

form_vitals_calculation 2 2 11

Main calculation records - one per logical calculation (e.g., average BP)

icd9_sg_code 0 0 7
verify_email 0 0 10
procedure_order_code 1 2 16

Holds individual procedure / labs ordered from the procedure_type table for a given procedure order. It contains also the individual diagnosis code that is related to the ordered procedure

session_tracker 0 0 4
care_team 0 4 10

Contains the care team records for a patient

sct2_description 0 0 9
pro_assessments 0 2 12

Contains Patient Reported Outcome assessment results as delivered via the PROMIS assessment delivery system

layout_options 3 2 21

Holds the layout settings for a specific dynamic field in the system

sct2_concept 0 0 5
modules_settings 0 0 5
lang_definitions 0 0 4
codes_history 0 0 14
sct2_textdefinition 0 0 8
immunization_observation 0 3 12

Individual observations for a specific immunization

gacl_aro_groups_id_seq 0 0 1
form_CAMOS_item 2 4 10

CAMOS patient chart templates for a single item inside a CAMOS subcategory

gacl_aco_seq 0 0 1
form_groups_encounter 1 8 24

Represents the information related to a group of patient’s visit to a healthcare provider. This is different than an appointment as this table tracks the actual service of care for a therapy group

contact_address 0 6 15

Contains information about a specific contact’s address

form_transfer_summary 0 2 2

Records transfer summary of care and is an alternative to recording referrals in the transactions table

phone_numbers 0 0 7
clinical_notes_documents 0 3 5

Links clinical notes to patient documents

ar_session 1 6 17

Accounts Receivable overall payment made towards a patient invoice/claim and is the main table that holds the patient payments ledger

drug_sales 0 6 25

Product/Drug sales to Patients

person_patient_link 0 3 8

Contains the tracking of person records who are also patients in the system

oauth_clients 0 0 25
module_configuration 0 0 9
gacl_aro 0 0 6
login_mfa_registrations 0 0 6
categories_seq 0 0 1
billing 0 7 30

Patient billing records for billing codes - Used for Claims Processing

form_bronchitis 0 3 89

Records symptoms, diagnosis, and recommended treatments for bronchitis in a patient

dsi_source_attributes 0 0 10

Holds information about decission support intervention system source attributes

gacl_axo_sections 0 0 5
onsite_signatures 0 2 16

Patient portal digital signatures used for patient documents and anywhere else a signature is required in the portal

extended_log 0 1 7

Holds the disclosures of EHI made to third parties for a given patient

form_eye_vitals 0 1 27

This table is used for recording vital signs and measurements related to the eye.

lang_languages 0 0 4
eligibility_verification 1 1 8

Insurance Eligibility Verification Tracking

drug_inventory 0 0 13
gacl_aco 0 0 6
erx_narcotics 0 0 6
form_eye_base 0 1 7

Eye form base container record that all other eye forms are connected to

external_encounters 0 1 7

Holds data on encounters that exist outside of this EMR that were in a patient CCDA import

gacl_axo_map 0 0 3
care_team_member 0 8 13

Contains the individual team member of a care team for a patient

employer_data 0 4 16

Contains records of employers associated with patients in the system

comlink_telehealth_appointment_session 0 0 12
form_history_sdoh 1 21 51
history_data 0 2 91

Contains patient eating,sleeping,drinking,drug habits as well as other patient health history information

gacl_acl 0 0 7
api_log 0 0 11
uuid_mapping 0 0 7
therapy_groups_participant_attendance 0 3 4

Track patient attendance to a therapy group session as contained in the Used by the form_group_attendance table

icd9_dx_long_code 0 0 5
amendments 1 5 10

Holds requests to amend health care information typically initiated by the patient or an insurance company

patient_history 0 2 14

Contains previous historical entries of the patient’s care team (providers and facilities) as well as patient previous name information

form_eye_neuro 0 1 81

This table includes numerous fields for recording the results of neurological tests and assessments, such as near and distant vision, motility measurements, comments, and various neurological parameters.

form_observation 0 8 31

Used for recording observations related to patients during medical encounters

gacl_aco_sections 0 0 5
onotes 0 0 6
icd10_reimbr_pcs_9_10 0 0 11
form_questionnaire_assessments 0 6 17

Holds questionnaires results for a patient entered in by a provider as a patient charted form

procedure_order 5 16 37

A procedure order is an encounter form within a patient visit representing an order for one or more procedures and its associated report/results for the procedure. Orders can be for either internal or external procedure providers

patient_tracker_element 0 4 6

Used for tracking individual state changes in the appointment/encounter of a patient

edi_sequences 0 0 1
rule_reminder 0 0 4
modules 0 0 20
insurance_numbers 0 0 8
procedure_providers 2 0 23

This table holds both internal and external laboratories as well as other organizations that provide lab testing, results, and other procedures that can be ordered by a provider

patient_settings 0 0 3
sct2_statedrelationship 0 0 8
sct2_relationship 0 0 9
valueset_oid 0 0 7
amc_misc_data 0 0 7
medex_outgoing 0 0 9
code_types 0 0 18
form_eye_biometrics 0 1 18

This table stores biometric data related to the eye, including axial length, pupil diameter, and other measurements.

erx_rx_log 0 0 8
icd10_pcs_order_code 0 0 7
pnotes 0 7 16

Patient Messages about the healthcare treatment of the patient

rule_filter 0 0 6
form_eye_locking 0 1 9

Used for tracking the editing status of a form and whether it is currently being edited by a user

gacl_aro_groups 0 0 6
form_ankleinjury 0 3 24

Represents a provider’s evaluation of an ankle injury including x-ray information, diagnosis, and recommended treatments

medex_recalls 0 3 8

Tracks Patient Recalls. Recalls are when a patient should be reached out to or contacted for a healthcare followup.

report_itemized 0 0 7
issue_types 1 0 10

Contains the list of issue types that medical health issue can be.

comlink_telehealth_person_settings 0 0 6
log_comment_encrypt 0 0 6
therapy_groups_counselors 0 2 2

Contains the relationships between the counselors in a therapy group and the group

ccda 0 0 17
facility_user_ids 0 0 8
list_options 98 0 16

Contains lists of unique value sets that a record’s property can be. Individual values/options in the list may be linked to a specific codesystem

user_settings 0 0 3
recent_patients 0 0 2
lang_constants 0 0 2
ccda_components 0 0 4
form_reviewofs 0 1 115

Review of Systems observations of the patient. Providers can use this form or the form_ros.

procedure_report 1 3 13

Procedure order overall report container for an ordered procedure result in procedure_order_codes which represents findings, conclusions, and recommendations for the procedure order

ehi_export_job_tasks 1 2 8

Export task for a subset of patients in the export job

documents 5 4 33

Stores all of the digital documents that are connected to a patient.

form_physical_exam 0 3 6

Physical Examination clinical note

notes 0 2 6

Clinical notes and comments for individual patient documents

supported_external_dataloads 0 0 6
procedure_type 2 1 20

This table holds a compendium of possible procedures and labs that can be ordered by the procedure ordering system within OpenEMR

multiple_db 0 0 8
contact_relation 0 5 19

Contains information about the relationship between a contact and another table such as person for relatedpersons

form_gad7 0 4 4

Encounter form that holds patient results for the GAD7 assessment

therapy_groups 6 0 10

Contains all of the therapy groups that exist in the system

openemr_postcalendar_categories 3 0 20

Contains the types / categories a patient scheduled appointment can be

procedure_specimen 0 8 25
audit_master 0 0 11
form_CAMOS 0 4 11

Computer Aided Medical Ordering System notes that are part of a patient’s chart

ccda_sections 0 0 5
sct2_identifier 0 0 6
form_aftercare_plan 0 3 18

Table for chart notes on patient aftercare plans, including Acute Intoxication/Withdrawal, Emotional/Behavioral Conditions and Complications, and Relapse Potential for patients’ care plans.

product_warehouse 0 0 4
form_painmap 0 4 5

Patient pain map form. Pain map image for mapping this form is stored in the EHI zip export at images/painmap.png

icd9_dx_code 0 0 7
oauth_trusted_user 0 0 9
form_clinic_note 0 1 1

Holds patient history, provider examination conducted, patient treatment plan, and follow up status

form_eye_mag_impplan 0 1 11

Stores implementation plans for eye-related activities.

report_results 0 0 3
drug_templates 0 0 8
gacl_acl_seq 0 0 1
modules_hooks_settings 0 0 4
rule_action 0 0 4
patient_tracker 1 4 11

Patient appointment events that occur in the system. Used in the patient flowboard and for patient data reporting

sequences 0 0 1
form_functional_cognitive_status 0 1 12

Holds information about assessments, evaluations, or observations of a patient’s functional and cognitive abilities.

fee_sheet_options 0 0 3
email_queue 0 0 12
gprelations 0 0 4

general purpose relations

questionnaire_response 1 5 20

Holds questionnaire results for a patient

gacl_axo_groups 0 0 6
calendar_external 0 0 4
form_eye_external 0 1 30

This table is used for recording external eye examination findings.

globals 0 0 3
api_token 0 0 8
claims 0 3 13

Insurance Billing Claims - Used for tracking and submission of billing claims to payers

patient_treatment_intervention_preferences 0 5 14

Treatment Intervention Preferences for a patient

onetime_auth 0 0 15
form_vitals_calculation_components 0 1 7

Component values for calculations (e.g., systolic=120, diastolic=80)

gacl_groups_aro_map 0 0 2
ip_tracking 0 0 8
jwt_grant_history 0 0 5

Holds JWT authorization grant ids to prevent replay attacks

shared_attributes 0 4 6

Dynamic patient, encounter, and transaction table properties created via LBF/LBT mechanism

person 0 2 24

Contains records of individuals in the system

form_care_plan 0 3 22

Patient Clinical Care Plans

lists 5 11 36

Patient issues list including allergies, medical problems, medications, medical devices, surgeries, and dental issues. Type of issue is in the type column.

fee_schedule 0 0 8
log 0 0 15
document_templates 0 1 15

Digital document templates that are assigned to patients

form_phq9 0 4 4

Encounter form that holds patient results for the PHQ9 assessment

module_acl_user_settings 0 0 4
amendments_history 0 4 5

Contains clinicinan comments regarding an amendment request

form_eye_hpi 0 1 35

This table stores the history of present illness (HPI) information related to eye conditions.

categories_to_documents 0 2 2

Mapping table connecting documents to categories

immunizations 1 14 31

Patient Immunizations

syndromic_surveillance 0 0 4
prescriptions 1 10 49

Internal and External prescription information

rule_patient_data 0 3 7

Patient Reminders that the Clinical Decision Support system is configured to run for this specific patient.

document_template_profiles 0 0 14
form_note 0 2 2

Work/School note written by a provider for a patient to provide documentation of their medical condition to their work or school

users 92 2 66

Contains actors in the system that are not patients. This includes providers, employees, and external organizations/contacts records as well as system processes. This does not include API actors

form_sdoh 0 4 4

Encounter form that holds results for the Social Determinants of Health Screening Tool

esign_signatures 0 1 9

Holds the digital author signature records for encounters and individual charted forms in the system.

patient_access_onsite 0 1 8

Holds patient portal onsite credentials, username information and login meta information

api_refresh_token 0 0 6

Holds information about api refresh tokens.

icd10_gem_pcs_10_9 0 0 6
form_CAMOS_category 2 3 8

Note categories used in the CAMOS note generator

icd10_gem_dx_10_9 0 0 6
erx_weno_drugs 0 0 27
patient_portal_menu 0 0 5
care_teams 0 0 10
lbt_data 0 2 3

Dynamic Field values that an installation can use to extend the data stored in the transactions table

preference_value_sets 6 0 8

Answer lists for preference codes

form_ros 0 1 142

Review of Systems observations of the patient. Providers can use this form or the form_reviewofs

erx_ttl_touch 0 0 3

Store records last update per patient data process

gacl_aco_map 0 0 3
documents_legal_detail 0 0 17
clinical_plans 0 1 7

The Clinical Quality Measures that are being applied to a specific patient to track. This is used in the clinical reminders system

form_eye_mag_dispense 0 1 55

Stores information related to eye prescriptions and dispensing for both the left (OS) and right (OD) eyes

drugs 2 0 24

Contains information about drugs that are dispensed/prescribed to patients. Also holds product inventory information if providers are internally managing their own drugs/medical supplies

clinical_plans_rules 0 0 2
gacl_phpgacl 0 0 2
payment_gateway_details 0 0 5
uuid_registry 0 0 8
ehi_export_job_task_patients 0 2 2

Patients to be exported in the ehi_export_job_tasks

prices 0 0 4
form_prior_auth 0 2 2

Patient Prior Authorization records

procedure_questions 1 2 11

Information/questions that should be answered for a given procedure as requested by the procedure service provider. Created as part of the procedure compendium import/creation process.

gacl_aro_map 0 0 3
dated_reminders_link 0 0 3
icd9_sg_long_code 0 0 5
ehi_export_job_patients 0 2 2

Patients to be exported in the ehi_export_job

onsite_online 0 0 5
icd10_gem_pcs_9_10 0 0 6
users_secure 0 0 15
insurance_type_codes 1 0 3

Contains a list of different insurance types or categories that an insurance company is related to. This type includes both public and private payer types

version 0 0 7
patient_data 98 9 131

Main patient record that contains patient demographic information

form_misc_billing_options 0 2 34

Contains encounter claims billing options that modifies the claims submitted for this encounter

openemr_postcalendar_events 2 10 39

Holds records for Patient Appointment/Calendar information

insurance_data 1 2 34

Patient Insurance information

openemr_module_vars 0 0 4
contact 3 0 3

Contains records of contacts in the system

form_track_anything_type 2 0 6

Represents the category grouping / track of the data element being tracked via the track_anything form

layout_group_properties 2 0 20

Record of the grouped fields used in dynamic layout based forms (LBF)

form_history_sdoh_health_concerns 0 3 5

Links SDOH assessments to health concern conditions

gacl_groups_axo_map 0 0 2
icd10_dx_order_code 0 0 8
clinical_notes_procedure_results 0 3 5

Links clinical notes to procedure results/lab values

payment_processing_audit 0 0 17
form_eye_refraction 0 1 65

This table is used for recording eye refraction details, including sphere, cylinder, axis, prism, and base measurements.

form_physical_exam_diagnoses 2 0 3

Physical Exam Diagnosis for a physical exam that was conducted

enc_category_map 0 0 2
gacl_aro_sections 0 0 5
x12_remote_tracker 0 0 8
lang_custom 0 0 4
lists_medication 0 8 14

Holds additional data about patient medications.

form_dictation 0 1 9

Patient chart note that holds notes created from a provider’s speech dictation software

onsite_documents 0 4 21

Digital documents that have been assigned to a patient from a document_template that the patient has saved or submitted for review by clinical staff

form_clinical_instructions 0 1 7

Patient clinical instructions chart note

form_eye_antseg 0 1 39

This table is used to store data related to anterior segment eye examinations, which typically include details about the front portion of the eye, such as the cornea, lens, iris, and pupil.

chart_tracker 0 0 4
patient_birthday_alert 0 0 3
form_soap 0 1 11

Holds Subjective, Objective, Assessment, and Plan (SOAP) notes

procedure_result 1 2 16

The table stores the actual results and findings from medical procedures and tests, such as laboratory tests, radiology reports, diagnostic imaging, and other clinical tests.

form_vital_details 0 3 12

Record of a specific vital sign measurement, including its interpretation, and reason of the measurement

rule_action_item 4 2 5

Patient Reminders configuration for Clinical Decision Support individual rule settings

background_services 0 0 9
pharmacies 2 0 6

Contains records of pharmacies that a patient uses, or that providers interact with

x12_partners 0 0 32
form_eye_acuity 0 1 30

This table is related to recording visual acuity measurements for different eye conditions.

batchcom 0 0 7
notification_log 0 0 15
form_encounter 19 1 35

Represents the information related to a patient’s visit to a healthcare provider. This is different than an appointment as this table tracks the actual service of care

ccda_field_mapping 0 0 3
track_events 0 0 8

Telemetry Event Data

form_group_attendance 1 5 8

Group encounter form for tracking the attendance of therapy participants to a group session encounter

onsite_mail 0 0 22

Patient asynchronous messages to and from clinical staff

ar_activity 0 4 22

Accounts Receivable item entries in invoice/claim activity

patient_reminders 0 5 14

Patient Reminders generated from the clinical decision support engine that are sent via a communication medium to the patient

form_treatment_plan 0 4 4

Patient treatment plan form

customlists 0 0 10
icd10_gem_dx_9_10 0 0 6
address 0 0 0

Contains address records in the system

lists_touch 0 0 3
form_eye_ros 0 1 15

This table stores review of systems (ROS) information related to various aspects of the eye and its associated systems.

addresses 1 0 10
form_track_anything_results 0 2 7
automatic_notification 0 0 7
comlink_telehealth_auth 0 0 10
registry 0 0 14
documents_legal_categories 0 0 4
gacl_aco_sections_seq 0 0 1
medex_icons 0 0 6
contact_telecom 0 3 16

Contains information about a specific contact’s telecom method

form_vitals_calculation_form_vitals 0 2 2

Join table between form_vitals_calculation and form_vitals table representing the derivative observation relationship between the calculation and the source records

standardized_tables_track 0 0 6
codes_cpt 0 0 16
ccda_table_mapping 0 0 9
valueset 0 0 7
issue_encounter 0 5 10

Links patient medical issues in the lists table with patient service encounters

form_eye_postseg 0 1 25

This table is used for storing data related to posterior segment eye examinations, which typically involve the back of the eye, including the retina, optic disc, macula, and blood vessels.

transactions 2 1 7

Represents patient referrals, and transactional records for billing, legal, and requests from the patient or their physician

patient_care_experience_preferences 0 5 14
clinical_rules_log 0 0 8
gacl_aro_sections_seq 0 0 1
codes 0 0 16
form_clinical_notes 2 3 18

Patient clinical notes with support for USCDI V1 standardized note types

keys 0 0 3
questionnaire_repository 3 1 18

Holds questionnaires that providers or patients fill out for healthcare information collection and/or assessment.

onsite_portal_activity 0 1 14

Patient portal activity (document submission, and other activities) that requires review before they are accepted into the patient chart

form_eye_mag_wearing 0 1 41

This table is used to record information related to wearing eyeglasses or contact lenses.

clinical_rules 0 0 35
therapy_groups_participants 0 2 6

Connects the patient participants to a therapy group

documents_legal_master 0 0 16

List of Master Docs to be signed

form_CAMOS_subcategory 1 2 9

CAMOS patient chart sub categories inside a single category

voids 0 3 12

Tracks a voided receipt or checkout for a patient

users_facility 0 0 4

joins users or patient_data to facility table

module_acl_group_settings 0 0 4
gacl_axo 0 0 6
form_taskman 0 1 13

This table holds eye related tasks for providing care to the patient.

export_job 0 0 13

fhir export jobs

external_procedures 0 2 9

Holds data on external procedures that exist outside of this EMR that were in a patient CCDA import

openemr_modules 0 0 11
template_users 0 0 5
forms 14 6 14

Patient chart forms that are connected to a patient’s encounter visit. Serves as the base record containing all of the common form encounter properties where each sub-type form has data records contained in a table that is named CONCAT(‘form_’,formdir)

medex_prefs 0 0 16
benefit_eligibility 0 1 18

Holds the eligible patient benefits for a specific insurance as received from an eligibility verification

ehi_export_job 2 1 8

User initiated export of patient electronic health info.

form_vitals 2 3 29

Records of patient vital sign assessment

lbf_data 0 2 3

Dynamic Field values that are part of the following forms: Demographics, Facility Specific User Information, History Form, and custom dynamically generated encounter forms

module_acl_sections 0 0 5
misc_address_book 0 0 9