Making GET requests on the SHR adapter module

A GET request is made on the SHR Adapter module for the purpose of retriving data stored in its database as hl7 messages.

The user may specify various mandatory and optional parameters to filter his GET request.

These parameters are -

Parameter name

is mandatory

description

patientId

yes

The ID of the patient whose encounters you wish to retrive

idType

yes

The idType of the provided patient id. Currently, the only supported ID type is 'ECID'

encounterUniqueId

no

The UUID of a specific encounter you wish to retrive

elid

no

The Enterprise Location Identifier (ELID) used to filter results

dateStart

no

A start date to filter encounters

dateEnd

no

A end date to filter encounters

If the user specified an encounterUinqueId (UUID) , the GET request will only return a single encounter, provided that the said encounter compiles with other parameters passed in.

Based on other parameters, one or many encounters may be retrived as a single hl7 message.

The elid, or Enterprise Location Identifier is also used to filter results.

If a user specifies an elid in his get request, then the retrieved message will return all matching encounters whose elid's are NOT equal to the one specified by the user.

A successful GET request will result in a hl7 message. This message will be retrrieved in an XML format.

A sample message that the user may expect to receive can be seen here here.

For sample error messages that a GET request may result in, see here.