Mapping of FHIR Encounter resource to the OMOP VISIT_OCCURRENCE Table

This document details the design and decisions for implementing mapping of FHIR Encounter resource to the OMOP VISIT_OCCURRENCE Table.

The following references were used to inform this implementation.

References for Encounter

General Mapping Resources	This is the fhir-to-omop documentation for general FHIR and OMOP information.
FHIR Encounter (STU3)	FHIR Documentation for the Encounter resource. The following version have been considered. Encounter (Current Build) Encounter (R4) Encounter (STU3)
VISIT_OCCURRENCE	This is the OMOP documentation for the VISIT_OCCURRENCE table.

Mapping Details

Mapping of FHIR Encounter resources to OMOP VISIT_OCCURRENCE records is relatively straight forward. Mapping is done in the OmopVisitOccurrenceBuilder class. The OmopPersonBuilder constructs PERSON Data Value Objects (DVOs) using the EncounterParser class to parse FHIR Patient resources

Testing Results

The mapping of FHIR Encounter resources to OMOP VISIT_OCCURRENCE records is passing for all Data Quality Dashboard (DQD) tests. However, many of the values have been hard coded as can be seen in the OmopVisitOccurrenceBuilder class.

Currently Passing Tests

Previously Failing Tests

The conformance and conpleteness tests shown below were initailly failing and have now been remediated.