== PMI Lookup ==

=== Outline ===
The Patient Master Index Lookup is a web service which - given a patient's s-Number - retrieves basic demographic data from the UHLT's patient master index via a JDBC connection and returns the information in a serialized version of the Onyx Participant Java object (org.obiba.onyx.core.domain.participant.Participant).

Note, this implies the client (or invoker) of this service is written in Java and knows about the Onyx Participant object. So, this is a fairly restrictive web service! A more generalized access method would entail redevelopment using XML as the medium rather than a serialized Java object.

=== Configuration ===
Configuration takes into account possible differing database requirements. During development, this aspect is managed within the maven project structure but eventually - on deployment - gets placed within the webapp/WEB-INF/patient-lookup-ws-data.xml file. This is something administrators should be aware of. This file needs to be edited before a system is workable. It needs to be held within a secure environment.