Open Immunization Software - Spring 2016

Matching

Open Source Projects

OIS Matching

Technical Documentation

Format for Patient Match Script

Matches to be tested are placed all within one file, one set of matches after the other. One match is formatted on 5 lines with the following labels:

TEST:
EXPECT:
PATIENT A:
PATIENT B:
DESCRIPTION:

Each time the system reads TEST: it expects that a new test case is being described. After each colon a value is to be placed, depending on which field it is. Here is a description of each field:

TEST:
A unique id that you define to identify this test. It can be any set of numbers or letters or symbols

EXPECT:
The result that you expect the test to be. Valid values: Match, Not a Match, Possible Match

PATIENT A: & PATIENT B:
A list of all the fields that make up the patient. A patient fields are comma separated value pairs. Make sure that none of the values have = or , characters. These will cause parsing problems. Here are the fields currently supported:

nameFirst=
nameAlias=
nameMiddle=
nameLast=
nameLastHyph=
nameSuffix=
birthDate=
guardianNameFirst=
guardianNameLast=
guardianNameFirst=
guardianNameLast=
guardianNameMiddle=
guardianNameFirst=
guardianNameLast=
motherMaidenName=
phone=
race=
ethnicity=
addressStreet1=
addressStreet2=
addressCity=
addressState=
addressZip=
gender=
birthStatus=
birthType=
birthOrder=
shotHistory=
mrns=
ssn=
medicaid=
vacName=
vacDate=
vacCode=
vacMfr=

DESCRIPTION:
A human readable description of test. This is optional.

Example

TEST: S-1:ADDRESS_CHANGED:IDEAL-IDEAL
EXPECT: Match
PATIENT A: addressState=MI,nameSuffix=,phone=(810)433-3532,birthOrder=,nameFirst=Pablo,nameMiddle=,addressCity=Grand Rapids,nameAlias=,mrns=5-U51,ssn=494523553,medicaid=572090468,addressStreet1=48 Leslie Pl,nameLastHyph=Wise,addressStreet2=,nameLast=Todd,shotHistory=,motherMaidenName=Todd,guardianNameLast=Wise,gender=M,birthDate=20071216,birthType=,guardianNameFirst=Alkira,birthStatus=,addressZip=49555,
PATIENT B: addressState=MI,nameSuffix=,phone=(810)433-3532,birthOrder=,nameFirst=Pablo,nameMiddle=,addressCity=Fort Gratiot,nameAlias=,mrns=7-M59,ssn=494523553,medicaid=572090468,addressStreet1=265 Boise Ave,nameLastHyph=Wise,addressStreet2=,nameLast=Todd,shotHistory=,motherMaidenName=Todd,guardianNameLast=Wise,gender=M,birthDate=20071216,birthType=,guardianNameFirst=Alkira,birthStatus=,addressZip=48059,