External Request Processing Route

The route receives an order-select or an order-sign CDS hook and submits a request to an external Coverage Requirement Discovery (CRD) service. The corresponding route component converts the resulting data into a JSON-formatted CDS card with a list of coverage terms.

Route Structure

Da Vinci 3-4 External Request Processing Route

Route Components Description

Component Name Component Type Description
order-select RESTful Web Service Inbound Receives a request in the form of an order-select CDS hook.
order-sign RESTful Web Service Inbound Receives a request in the form of an order-sign CDS hook.
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.
Get code Groovy Extracts the medication code from the hook.
Request to outer Service REST Client Sends a request to an external Coverage Requirement Discovery (CRD) service (emulated by the Da Vinci 3 CRD emulation route) and passes the medication code as a query parameter.
Response 200? Router Checks to see if the requested data has been successfully retrieved from the FHIR Server.
Convert to CDS Cards Groovy Converts the data into CDS Cards.
503 Service Unavailable RESTful Web Service Outbound Sends back a message that an error has occurred while performing a call to an external service to get the requested data.
Response RESTful Web Service Outbound Returns a set of JSON-formatted CDS cards with the requested information.
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 3-4 CRD and MRP profile, on the profile's Environment tab, in the EmrResourceUrl environment property, enter the URL through which the profile can access your EMR system.

In your EMR configuration, provide the following endpoints:

  • For the RESTful service URL, use the following: http\://stqasuse15\:9064/rest
  • For initialization of the order-select request (defaulted or manually selected order details), use the following: http\://stqasuse15\:9064/rest/cds-services/order-select
  • For initialization of the order-sign request (request for orders for medications, procedures, labs and other orders), use the following: http\://stqasuse15\:9064/rest/cds-services/order-sign
  • For initialization the request with supported FHIR resources, use the following: http\://stqasuse15\:9064/rest/measure-mrp/$data-requirements
  • For initialization the request with information on the medication prescribed, use the following: http\://stqasuse15\:9064/rest/measure-mrp/$submit-data