Audiometric Data CSV API

The following page defines data and fields that may be imported into MIE systems (Enterprise Health, WebChart) for audiometry using the Audiometric Data CSV API.

Audience

The abstract that follows should be presented to decision-makers or stakeholders interested in a general explanation of the Audiometric Data CSV API. DBAs, report writers, or the people charged with extracting data from the legacy system and importing it to EH should refer to the technical details provided in the remaining sections.

Abstract

Enterprise Health stores discrete data for occupational audiogram tests, which can be displayed in multiple ways.

It is valuable to recognize the following terminology as it pertains to MIE systems:

  • chart is an employee’s (patient’s) electronic medical information organized in tabular form. A chart is simply a way to collect different information on one topic, just like a physical patient chart would contain a variety of information on an individual. Audio tests are linked to a chart through a document.
  • document in EH is a way of storing non-discrete information in patient charts. This includes patient photographs, insurance cards, physician or nurse notes, imaging studies, past medical histories, CCDs and CDAs, email correspondence about a patient, injections, and many other forms of data.
  • An encounter documents a visit with a employee, and is also known as a patient visit. An encounter is a template of specific items to be addressed, in part or completely, during an appointment including the subjective, objective, assessment and plan. This is a tool used for recording information collected during an appointment and, in turn, the data collected will be stored and also incorporated in the final desired outcome: the visit report/note, which is a document stored in EH.

CSV refers to the type of file and format of data needed to import information into an EH system. API refers to how the data interacts with the EH system.

Screenshots

TBD

Workflow Considerations

Standard Threshold Shift (STS) Calculation

In the case that the legacy audio data does not contain STS information or is incomplete, it is possible to calculate the shifts after importing.

In addition to having the baselines set (audio.left_baseline, audio.right_baseline), these are the required fields for the calculation:

  • Left 2 kHz (audio.left2)
  • Left 3 kHz (audio.left3)
  • Left 4 kHz (audio.left4)
  • Right 2 kHz (audio.right2)
  • Right 3 kHz (audio.right3)
  • Right 4 kHz (audio.right4)
  • Test Datetime (audio.test_datetime)
  • Patient’s Sex (patients.sex)
  • Patient’s Birth Date (patients.birth_date)

A shift is set when both of the following conditions are met:

  1. The age corrected shift from the baseline is >= 10
  2. AND the average of 2kHz, 3kHz, and 4kHz >= 25

The age corrected shift is the average shift from the most recent baseline at the 2k, 3k, and 4k ranges after the test and baseline have been adjusted for the patient’s age. Adjustments are calculated in the database routine wc_audio_age_adjustment_value.

Specifications

The following sections provide insight for technical personnel working with the provided import specifications. Although the specifications provided include details on each field utilized in the import, the sections below include further discussion on best practices for imported data to provide the best functionality in Enterprise Health.

The Audiometric Data CSV API specifications are available here.

Note: The specification may be downloaded as Excel, CSV, or duplicated as an online spreadsheet under the File menu.

Common issues also documented in the specifications document:

If the Columns X and Y (Left_sts and right_sts) are provided, the audio import will NOT do a STS calculation since it assumes that the provided values are correct. These columns do not have to exist in the import and can be deleted from the file to enable the STS calculation to be done by the system.

When setting Baselines, the baseline test needs to be in the file before the rest of the tests that happened chronologically after it.

Field Requirements

The following fields (indicated in the Data Name column) are noted as required (R) or are recommended as best practice (BP) in the MIE CSV Import Spec for Audiometric Data. Additional details and considerations are provided here.

Required

The following fields are required:

  • Chart Identifier (documents.pat_id) and Chart ID Type (documents.pat_id_type) are used to correctly identify a chart.
  • External ID (documents.ext_doc_id) identifies a record in the original data source (this is often the primary or unique key on the table of the legacy database that is being migrated to the MIE system).
  • Test Date/Time (audio.test_datetime) is required in order to compare tests for an employee (patient).

Best Practice

Although this information is not required, it is considered a best practice to use at least some of these fields to populate information in the header of a document for identification and organizational purposes.

Most OSHA reporting standards include calibration data. It is best practice to include Calibration Date (audio.calibration_date).

Left and right ear measurements for 2, 3, and 4 kHz are utilized for hearing conservation standard threshold shift (STS) calculation. It is considered best practice to include the following:

  • Left 2 kHz (audio.left2)
  • Left 3 kHz (audio.left3)
  • Left 4 kHz (audio.left4)
  • Right 2 kHz (audio.right2)
  • Right 3 kHz (audio.right3)
  • Right 4 kHz (audio.right4)

Optional Fields

The following optional fields are needed to link the document to a patient encounter:

  • Encounter External Identifier (encounters.ext_id)
  • Encounter Interface (encounters.interface)

Including the field encounter order_id will also create an encounter order of the identified in the field.

Examples

The following examples are available:

Validation

Validation between the previous system and the new EH system requires the client to provide a number of test patients. This data can be compared in the previous system and EH using the validation test script.


WebChart Documentation

Last Updated:

Last Build: Thu, 05 Dec 2024 18:17:23 UTC
WikiGDrive Version: 2aacb51f060d0354a678419290943a99bd16aad1