{"type":"doc","content":[{"type":"paragraph"},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"jira","parameters":{"macroParams":{"server":{"value":"OpenMRS Issues"},"serverId":{"value":"45c5771b-fa4b-3e43-b34a-c19dc45ccc95"},"key":{"value":"FM2-1"}},"macroMetadata":{"macroId":{"value":"bc6090f8-fe52-4dc3-bd8a-edb48f27c458"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/plugins/servlet/confluence/placeholder/macro?definition=e2ppcmE6a2V5PUZNMi0xfQ==&locale=en_US"}}],"title":"Jira Legacy"}}}}]},{"type":"paragraph","content":[{"text":"The Lab Order workflow between ","type":"text"},{"text":"OpenELIS","type":"text","marks":[{"type":"link","attrs":{"href":"http://openelisglobal.org/"}}]},{"text":" and OpenMRS will use the ","type":"text"},{"text":"FHIR Workflow Module","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/workflow-module.html"}}]},{"text":" and suggested ","type":"text"},{"text":"Communication Patterns","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/workflow-communications.html#12.6.2.1"}}]},{"text":" to implement the ordering of lab tests from OpenMRS to OpenELIS and the returning the results to OpenMRS.","type":"text"}]},{"type":"paragraph","content":[{"text":"The current communication workflow uses HL7 V2.5.1 messages as documented here: (","type":"text"},{"text":"https://github.com/openelisglobal/openelisglobal-core/wiki/Result-Reporting","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openelisglobal/openelisglobal-core/wiki/Result-Reporting"}}]},{"text":"). This functionality is implemented in ","type":"text"},{"text":"openmrs-module-labintegration","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/openmrs-module-labintegration"}}]},{"text":", an OpenMRS module made for an implementation of OpenMRS deployed in Haiti called ","type":"text"},{"text":"iSantePlus","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus"}}]},{"text":". ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Communication Overview","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wide"},"content":[{"type":"media","attrs":{"width":1280,"id":"2da17afd-8cb7-4a9b-b97b-829bd083fba1","collection":"contentId-26937569","type":"file","height":861}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Implementation Guide","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"iSantéPlus","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install iSantePlus using one of the following approaches:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker: ","type":"text"},{"text":"https://github.com/IsantePlus/isanteplus-docker","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/isanteplus-docker"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apache Tomcat WAR: ","type":"text"},{"text":"SOP iSantePlus Installation.docx","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/download/attachments/26937569/SOP%20iSantePlus%20Installation.docx?version=1&modificationDate=1590617709000&cacheVersion=1&api=v2"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25466982"}}]},{"text":" the ","type":"text"},{"text":"OpenMRS FHIR module","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/openmrs/openmrs-module-fhir2"}}]},{"text":" using the following omod file: ","type":"text"},{"text":"openmrs-module-fhir2.omod","type":"text","marks":[{"type":"link","attrs":{"href":"https://drive.google.com/file/d/1SSlVrChKQ6i0zVbUgzR7Blx_czjiJhcG/view?usp=sharing"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/25466982"}}]},{"text":" the ","type":"text"},{"text":"iSantePlus Lab on FHIR module","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/pmanko/openmrs-module-isanteplus-labonfhir"}}]},{"text":" using the following omod file: ","type":"text"},{"text":"labonfhir-1.0.0-SNAPSHOT.omod","type":"text","marks":[{"type":"link","attrs":{"href":"https://drive.google.com/file/d/1SSlVrChKQ6i0zVbUgzR7Blx_czjiJhcG/view?usp=sharing"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart iSantePlus","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start up the OpenELIS Update Task in `System Administration` → `Advanced Administration` → `Scheduler` → `Manage Scheduler`","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1280,"id":"57c8874f-42ce-4a85-88c8-e5ecb2daa1dc","collection":"contentId-26937569","type":"file","height":892}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"OpenELIS Global 2.x","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install OpenELIS Global 2.x using the instructions at: ","type":"text"},{"text":"http://docs.openelis-global.org/en/latest/install/","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.openelis-global.org/en/latest/install/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to the \"results reporting\" configuration: ","type":"text"},{"text":"https://IPforyourserver:8443/OpenELIS-Global/ResultReportingConfiguration.do","type":"text","marks":[{"type":"link","attrs":{"href":"https://IPforyourserver:8443/OpenELIS-Global/ResultReportingConfiguration.do"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Move the radio button for Result Reporting to \"Enable\" and enter in the URL for the OpenMRS connection like in the example below. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Please note, the Test URL button may not respond to the FHIR module, so please disregard any errors if you click it. ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click Save at the bottom of the page. ","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1256,"id":"4a86b969-79e3-41c6-9bef-18a5ad3a89d6","collection":"contentId-26937569","type":"file","height":184}}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Required FHIR Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Task","type":"text"}]},{"type":"paragraph","content":[{"text":"> more info","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26937546"}}]}]},{"type":"paragraph","content":[{"text":"The Task resource is created along with the corresponding ServiceRequest resource when a clinician creates a TestOrder and decides to send it to OpenELIS.","type":"text"}]},{"type":"paragraph","content":[{"text":"This resource is used to track the status of the lab order request from initiation to completion, and as a container for all other resources related to the given order.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Task:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"{\n \"resourceType\": \"Task\",\n \"id\": \"88ffa7fb-0419-4097-8b45-24f0d843c5ea\",\n \"identifier\": [\n {\n \"system\": \"http://isanteplus.org/ext/task/identifier\",\n \"value\": \"88ffa7fb-0419-4097-8b45-24f0d843c5ea\"\n }\n ],\n \"basedOn\": [\n {\n \"reference\": \"ServiceRequest/ebf83ba0-9d3c-497f-9aa0-d839ec506202\",\n \"type\": \"ServiceRequest\"\n },\n {\n \"reference\": \"ServiceRequest/73e96ecb-a78d-41c8-a55f-d9b90f759e5f\",\n \"type\": \"ServiceRequest\"\n }\n ],\n \"status\": \"requested\",\n \"intent\": \"order\",\n \"for\": {\n \"reference\": \"Patient/e14e9bda-d273-4c74-8509-5732a4ebaf19\",\n \"type\": \"Patient\"\n },\n \"encounter\": {\n \"reference\": \"Encounter/7f5aabd9-6375-47c8-a8d6-30f219b6e2f1\",\n \"type\": \"Encounter\"\n },\n \"authoredOn\": \"2020-04-28T17:33:19+00:00\",\n \"owner\": {\n \"reference\": \"Practitioner/f9badd80-ab76-11e2-9e96-0800200c9a66\",\n \"type\": \"Practitioner\"\n }\n}","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"ServiceRequest","type":"text"}]},{"type":"paragraph","content":[{"text":"> more info","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26937551"}}]}]},{"type":"paragraph","content":[{"text":"The ServiceRequest resource represents the TestOrder placed in OpenMRS. It is referenced from the Task with the Task.basedOn element, and sent to OpenELIS with the Task to initiate the processing of the order. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Service Request:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"{\n \"resourceType\": \"ServiceRequest\",\n \"id\": \"73e96ecb-a78d-41c8-a55f-d9b90f759e5f\",\n \"status\": \"active\",\n \"intent\": \"order\",\n \"code\": {\n \"coding\": [\n {\n \"code\": \"790AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"\n },\n {\n \"system\": \"http://loinc.org\",\n \"code\": \"14682-9\"\n },\n {\n \"system\": \"urn:oid:2.16.840.1.113883.3.7201\",\n \"code\": \"790\"\n }\n ]\n },\n \"subject\": {\n \"reference\": \"Patient/e14e9bda-d273-4c74-8509-5732a4ebaf19\",\n \"type\": \"Patient\"\n },\n \"encounter\": {\n \"reference\": \"Encounter/7f5aabd9-6375-47c8-a8d6-30f219b6e2f1\",\n \"type\": \"Encounter\"\n }\n}","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"DiagnosticReport","type":"text"}]},{"type":"paragraph","content":[{"text":"> more info","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26935846"}}]}]},{"type":"paragraph","content":[{"text":"The DiagnosticReport resource is the container for the results of an Order, and holds these results in the DiagnosticReport.result element as references to Observation resources. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Diagnostic Report","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"{\n \"resourceType\": \"DiagnosticReport\",\n \"id\": \"93\",\n \"meta\": {\n \"versionId\": \"1\",\n \"lastUpdated\": \"2020-04-28T17:33:36.163+00:00\",\n \"source\": \"#55t4lpDZF4q3TCZ0\"\n },\n \"text\": {\n \"status\": \"generated\",\n \"div\": \"

Untitled Diagnostic Report

Status

FINAL

\"\n },\n \"identifier\": [\n {\n \"system\": \"https://isanteplusdemo.com/openmrs/ws/fhir2/\",\n \"value\": \"ebf83ba0-9d3c-497f-9aa0-d839ec506202\"\n }\n ],\n \"status\": \"final\",\n \"code\": {\n \"coding\": [\n {\n \"code\": \"1008AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"\n },\n {\n \"system\": \"http://loinc.org\",\n \"code\": \"22748-8\"\n },\n {\n \"system\": \"urn:oid:2.16.840.1.113883.3.7201\",\n \"code\": \"1008\"\n }\n ]\n },\n \"subject\": {\n \"reference\": \"Patient/2\"\n },\n \"result\": [\n {\n \"reference\": \"Observation/92\",\n \"type\": \"Observation\"\n }\n ]\n}","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Observation","type":"text"}]},{"type":"paragraph","content":[{"text":"> more info","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26935806"}}]}]},{"type":"paragraph","content":[{"text":"The Observation resource contains the results of the Lab Order request.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Observation:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"{\n \"resourceType\": \"Observation\",\n \"id\": \"92\",\n \"meta\": {\n \"versionId\": \"1\",\n \"lastUpdated\": \"2020-04-28T17:33:36.124+00:00\",\n \"source\": \"#xAVz0uUE6c3l42Za\"\n },\n \"identifier\": [\n {\n \"system\": \"https://isanteplusdemo.com/openmrs/ws/fhir2/\",\n \"value\": \"ebf83ba0-9d3c-497f-9aa0-d839ec506202\"\n }\n ],\n \"status\": \"final\",\n \"code\": {\n \"coding\": [\n {\n \"code\": \"1008AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\"\n },\n {\n \"system\": \"http://loinc.org\",\n \"code\": \"22748-8\"\n },\n {\n \"system\": \"urn:oid:2.16.840.1.113883.3.7201\",\n \"code\": \"1008\"\n }\n ]\n },\n \"subject\": {\n \"reference\": \"Patient/2\"\n },\n \"valueQuantity\": {\n \"value\": 55,\n \"unit\": \"UI/L\"\n }\n}","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Patient","type":"text"}]},{"type":"paragraph","content":[{"text":"> more info","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26935802"}}]}]},{"type":"paragraph","content":[{"text":"The Patient resource contains vital information for OpenELIS to fullfill the lab order request, and is referenced by the Task.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example Patient:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"{\n \"resourceType\": \"Patient\",\n \"id\": \"e14e9bda-d273-4c74-8509-5732a4ebaf19\",\n \"identifier\": [\n {\n \"id\": \"5981a256-d60c-44b1-beae-9bdd2cf572f8\",\n \"use\": \"official\",\n \"system\": \"iSantePlus ID\",\n \"value\": \"10012R\"\n },\n {\n \"id\": \"75a67d54-6fff-44d1-9c3e-2116c967b475\",\n \"use\": \"usual\",\n \"system\": \"Code National\",\n \"value\": \"100000\"\n },\n {\n \"id\": \"29447d21-3cd6-42a9-9ab2-79ebfa710a01\",\n \"use\": \"usual\",\n \"system\": \"ECID\",\n \"value\": \"04d759e0-5d02-11e8-b899-0242ac12000b\"\n }\n ],\n \"active\": true,\n \"name\": [\n {\n \"id\": \"511275de-e301-44a3-95d2-28d0d3b35387\",\n \"family\": \"Mankowski\",\n \"given\": [\n \"Piotr\"\n ]\n }\n ],\n \"gender\": \"male\",\n \"birthDate\": \"1987-01-01\",\n \"deceasedBoolean\": false,\n \"address\": [\n {\n \"id\": \"d4f7c809-3d01-4032-b64d-4c22e8eccbbc\",\n \"use\": \"home\",\n \"country\": \"Haiti\"\n }\n ]\n}","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deliverables (Lab)","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Demo - continuity of care pilot - ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public Communication - OpenMRS Talk/Design Forum/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Documentation - functional and technical reqs (HIE doc, implementation guide, Wiki page contents)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Present at OpenMRS & OpenHIE ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Relevant FHIR Docs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using Tasks in a RESTful Context: ","type":"text"},{"text":"https://www.hl7.org/fhir/task.html#12.1.2.1","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/task.html#12.1.2.1"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Workflow Module: ","type":"text"},{"text":"https://www.hl7.org/fhir/workflow-module.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/workflow-module.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Diagnostic Module: ","type":"text"},{"text":"https://www.hl7.org/fhir/diagnostics-module.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/diagnostics-module.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example: Workflow states for a lab order for a blood test: ","type":"text"},{"text":"https://www.hl7.org/fhir/workflow-communications.html#12.6.2.1","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/workflow-communications.html#12.6.2.1"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Option G: POST of Task to fulfiller's system:","type":"text"},{"text":" https://www.hl7.org/fhir/workflow-management.html#optiong","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.hl7.org/fhir/workflow-management.html#optiong"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Relevant Talk Posts","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The handling and mapping of lab order status for the lab workflow","type":"text","marks":[{"type":"link","attrs":{"href":"https://talk.openmrs.org/t/the-handling-and-mapping-of-lab-order-status-for-the-lab-workflow/26348"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Relevant Github Links","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SaveEncounterAfterAdvice.java","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/openmrs-module-labintegration/blob/master/api/src/main/java/org/openmrs/module/labintegration/api/event/SaveEncounterAfterAdvice.java"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"LabIntegrationServiceImpl.java","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/openmrs-module-labintegration/blob/master/api/src/main/java/org/openmrs/module/labintegration/api/impl/LabIntegrationServiceImpl.java"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OpenElisOrderSender.java","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/openmrs-module-labintegration/blob/master/api/src/main/java/org/openmrs/module/labintegration/api/hl7/openelis/OpenElisOrderSender.java"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PR #14 - FHIR Support for Lab Orders","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/IsantePlus/openmrs-module-labintegration/pull/14"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Demo Video iSantePlus to OpenMRS","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"widget","parameters":{"macroParams":{"overlay":{"value":"youtube"},"_template":{"value":"com/atlassian/confluence/extra/widgetconnector/templates/youtube.vm"},"width":{"value":"400px"},"url":{"value":"http://youtube.com/watch?v=MReLJoiDcwc"},"height":{"value":"300px"}},"macroMetadata":{"macroId":{"value":"c592e0c1-165a-4a5a-ac18-b6c4eae930a4"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/plugins/servlet/widgetconnector/placeholder?thumb=https://img.youtube.com/vi/MReLJoiDcwc/mqdefault.jpg&overlay=youtube&width=400&height=300"}}],"title":"Widget Connector"}}}},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"}],"version":1}