{"type":"doc","content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"In DiagnosticReport FHIR resource contains field called \"","type":"text"},{"text":"serviceCategory","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.hl7.org/FHIR/2015May/diagnosticreport-definitions.html#DiagnosticReport.serviceCategory"}}]},{"text":"\". This filed has zero to one relationship and can take one of values presented in ","type":"text"},{"text":"Codes for Diagnostic Service sections","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.hl7.org/FHIR/2015May/valueset-diagnostic-service-sections.html"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"When the \"serviceCategory\" field is not presented in FHIR resource instance, those requests are handled by Default Service section.","type":"text"}]},{"type":"paragraph","content":[{"text":"FHIR module is using Handlers to support each type of serviceCategory sections. You can build your own handler and register for handler a particular type of DiagnosticReport.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"type":"external","url":"https://docs.google.com/drawings/d/1vOl6UycHN5pPfHFC7KzpBzrr0RwhFzwDqeoTJStut04/pub?w=1442&h=846"}}]},{"type":"paragraph","content":[{"text":"Above diagram show the handler hierarchy for the DiagnosticReport.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a handler for particular Diagnostic Service Section with implementing DiagnosticReportHandler interface","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Register handler using Spring injection by ModuleApplicationContext.xml","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RESTfulDiagnosticReportResourceProvider listen to the HTTP requests and invoke appropriate method in DiagnosticReportServiceImpl according to the requested parameters","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Then DiagnosticReportServiceImpl will select the register handler which can fulfill that request and forward it to the DiagnosticReportUtil","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DiagnosticReportUtil trigger the handler and send back the response","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"How to Create a DiagnosticReportHandler","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Requirements","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A DiagnosticReportHandler must implement the DiagnosticReportHandler interface","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"DiagnosticReportHandler","type":"text"},{"text":" may extend the AbtractHandler which contains common set of functionalities","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"DiagnosticReportHandler","type":"text"},{"text":" must be registered by Spring with a key","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Laboratory Handler","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Found in the org.openmrs.module.fhir.api.diagnosticreport.handler package","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extends org.openmrs.module.fhir.api.diagnosticreport.handler","type":"text"}]}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"LaboratoryHandler.java","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"package org.openmrs.module.fhir.api.diagnosticreport.handler;\npublic class LaboratoryHandler extends AbstractHandler implements DiagnosticReportHandler {\n private static final String ServiceCategory = \"LAB\";\n public LaboratoryHandler() {\n super();\n }\n public String getServiceCategory() {\n return ServiceCategory;\n }\n public DiagnosticReport getFHIRDiagnosticReportById(String id) {\n // Implement code here\n }\n public List getFHIRDiagnosticReportBySubjectName(String name) {\n // Implement code here\n }\n public DiagnosticReport saveFHIRDiagnosticReport(DiagnosticReport diagnosticReport) {\n // Implement code here\n }\n public DiagnosticReport updateFHIRDiagnosticReport(DiagnosticReport diagnosticReport, String theId) {\n // Implement code here\n }\n public void retireFHIRDiagnosticReport(String id) {\n // Implement code here\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Register LaboratoryHandler","type":"text"}]},{"type":"paragraph","content":[{"text":"Register handler in FHIR module ModuleApplicationContext.xml configuration (locate in ","type":"text"},{"text":"/api/src/main/resources/moduleApplicationContext.xml","type":"text","marks":[{"type":"em"}]},{"text":").","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"moduleApplicationContext.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n org.openmrs.module.fhir.api.DiagnosticReportService\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n DefaultDiagnosticReportHandler\n \n \n \n LaboratoryHandler\n \n \n \n \n \n \n \n \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"hardBreak"},{"text":"List of Handlers","type":"text"}]},{"type":"paragraph","content":[{"text":"Following is a list of currently implemented handlers for Different type of Diagnostic Service sections;","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Laboratory DiagnosticReport Handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26935863"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Radiology DiagnosticReport Handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://openmrs.atlassian.net/wiki/spaces/docs/pages/26935865"}}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}],"version":1}

Browser not supported