OpenHIE Entity Matching Service

Purpose

The purpose of the entity matching service is to enable matching in a single list of patients, health workers, facilities or other entities or to find potential matches between two lists of entities.

Potential matching use cases might include:

Ensuring the the entity doesn't exist when entering a new instance of the entity
Duplicate checking during bulk imports.
Analysis of potential duplicates in an existing data set.
Mapping one data set of entities to their corresponding value in another data set.

Potential Implementations

Tight coupling - Software library incorporated into the component
Medium
Loose -

High Level Overview of Mapping Service Components

FHIR Reference

Sample URL:

https://testmap.ohie.org/registry/fhir/Location/$match

Sample Request:

<Parameters xmlns="http://hl7.org/fhir">
	<parameter>
		<name value="location"/>
		<resource>
			<Location xmlns="http://hl7.org/fhir">
				<contained>
					<Location xmlns="http://hl7.org/fhir">
						<id value="1"/>
						<identifier>
							<value value="a.bc.1.sample"/>
						</identifier>
						<name value="simple health"/>
					</Location>
				</contained>
				<identifier>
					<value value="117"/>
				</identifier>
				<name value="simple clinic"/>
				<position>
					<longitude value="10"/>
					<latitude value="100"/>
				</position>
				<partOf>
					<reference value="#1"/>
				</partOf>
			</Location>
		</resource>
	</parameter>
	<parameter>
		<name value="count"/>
		<valueInteger value="5"/>
	</parameter>
</Parameters>

Sample Response:

<Bundle xmlns="http://hl7.org/fhir">
	<entry>
		<resource>
			<Location xmlns="http://hl7.org/fhir">
				<id value="1000010"/>
				<contained>
					<Location xmlns="http://hl7.org/fhir">
						<id value="con31"/>
						<identifier>
							<value value="A.BC.1.SAMPLE"/>
						</identifier>
						<name value="SAMPLE HEALTH"/>
					</Location>
				</contained>
				<extension url="http://ohie.org/fhir/StructureDefinition/datim-mechid">
					<valueString value="1111"/>
				</extension>
				<identifier>
					<value value="117"/>
				</identifier>
				<name value="SIMPLE CLINIC"/>
				<position>
					<longitude value="10.0"/>
					<latitude value="100.0"/>
				</position>
				<partOf>
					<reference value="#con31"/>
				</partOf>
			</Location>
		</resource>
		<search>
			<score value="0.99762179871785583440413347489084117114543914794921875"/>
		</search>
	</entry>
</Bundle>