PatientView Route

The route receives a POST request that carries a patient-view CDS hook. The route then

  • extracts the hook, and retrieves the patient's first and last names, and the Provider's FHIR server URL, as well as other patient-related information.
  • builds a FHIR Bundle for the patient (Internal REST Route) based on the patient's first and last names.
  • uploads the created bundle to the Provider's FHIR server by retrieving the Provider's FHIR server URL from the received CDS hook.

As a result, the Provider receives a set of JSON-formatted CDS cards with patient-related information, such as general patient information, observations, allergies, and other data.

Route Structure

Da Vinci 2 Payer Provider Xe Generic PatientView Route

Route Components Description

Component Name Component Type Description
patient-view RESTful Web Service Inbound Receives a request for patient's data in the form of a patient-view CDS hook. The request contains Patient's ID, first name, and last name of the required patient, and the FHIR Server URL to upload the patient data to.
HTTP Router Checks the request type.
405 Method Not Allowed RESTful Web Service Outbound Sends back an error message that the request type used is not allowed.
JSON Value Extractor JSON Value Extractor Extracts the patient's ID, the first and the last names, and the Provider's FHIR server URL from the incoming request.
400 Bad Request RESTful Web Service Outbound Sends back an error message that the request body cannot be processed.
REST Call REST Client Triggers the 500 Internal Server Error to send out an internal server error HTTP response when there are processing errors.
Response 200? Router Checks to see if the requested data has been successfully retrieved from the Payer's FHIR Server.
Create new POST Bundle for Cerner_1 Groovy Transforms the patient's data into a FHIR Bundle.
404 Not Found RESTful Web Service Outbound Sends back an error message that the patient data is not found.
Upload to Provider Subroute The Upload to Provider subroute uploads the requested data to the Provider's FHIR Server.
501 Not Implemented RESTful Web Service Outbound Sends back a message that an error has occurred while uploading the data to the Provider's FHIR Server.
Convert JSON Groovy Transforms the incoming data into CDS cards.
Response RESTful Web Service Outbound Returns a set of JSON-formatted CDS cards with patient-related information to the Provider.
Any Error Error Channel Inbound Triggers the 500 Internal Server Error to send out an internal server error HTTP response when there are processing errors.
500 Internal Server Error RESTful Web Service Outbound Sends out an internal server error message.
Errors File System Inbound Saves all the processing error reports to the file system.

EMR Integration

To integrate your custom EMR with the Da Vinci 2 Payer Provider Ex Generic profile, in your EMR configuration, provide the following endpoints:

Note For <host> and <port> use the actual host and port where the profile is running.

  • For the RESTful service URL, use the following: http\://<host>\:<port>/rest
  • For initialization of the patient-view request (request for the patient data), use the following: http\://<host>\:<port>/rest/cds-services/patient-view