Handle ART Duplicate

[chrisly-bear]

Problem

The VisibleImpact database may have more than one patient_id associated with an ART number. When this happens a MultiplePatientsException is thrown in the lib/utils/VisibleImpactUtils.dart/_getPatientIdVisibleImpact method (which matches ART numbers to patient_ids on VisibleImpact). This means that it is not possible to

• fetch viral loads
• upload participant characteristics
• upload notification preferences
• change PE's phone number (which is just a re-upload of all notification preferences for all participants)

Solution

Try to find the right participant by matching birth_date, sex, mobile_phone (the variables are also returned by the GET /patient endpoint of the VisibleImpact API). If the conflict can still not be resolved this way inform the user via notification (flushbar and/or required action) so that they can take further action such as informing the study supervisor or the data clerk to update the entry on the database.

Optional: Show an interface to the user where they are presented with the list of duplicates and can then select the right one to resolve the conflict.

Resources

• VisibleImpact API documentation

[Tlotliso-Wiinc]

• Solution: display errror message, and show on SwitchToolBox that there is a discrepancy.

[Tlotliso-Wiinc]

Also only match by birth_date and gender.