DiagnosticReport Resource

Owned by Milan Karunarathne
Last updated: May 07, 2021 by Keith DuddyVersion comment
2 min read

Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

DiagnosticReport is a FHIR resource that is part of the Diagnostic Medicine Module. A DiagnosticReport is used to represent the results of diagnostic tests that are performed in a given clinical context. 

DiagnosticReport references Observations holding lab order results through the result element, which conceptually maps well to an OpenMRS Obs Group.

The OpenMRS Obs class allow for grouping Obs as children of other Obs, and can map to a DiagnosticReport. (See  guidance on grouping FHIR Observations)

Supported Elements

  • DiagnosticReport.id - The logical identifier of the Task resource
  • DiagnosticReport.status - The status of the DiagnosticReport. The OpenMRS implementation currently supports preliminary, final, amended, canceled, and unknown states. 
  • DiagnosticReport.code - The LOINC code that describes this report.
  • DiagnosticReport.category - for the purposes of this initial request, this value will always have the value "LAB" using the system " http://terminology.hl7.org/CodeSystem/v2-0074".
  • DiagnosticReport.encounter - a Reference the encounter this diagnostic report is part of.
  • DiagnosticReport.subject - a Reference to the appropriate Patient resource.
  • DiagnosticReport.issued - The date and time this report was made available to Providers.
  • DiagnosticReport.result - A collection of Reference to the Observations that hold the results associated with this diagnostic report. 

OpenMRS ↔ FHIR Mappings

Translator: https://github.com/pmanko/openmrs-module-fhir2/blob/FM2-75-Lab-Gaps/api/src/main/java/org/openmrs/module/fhir2/api/translators/DiagnosticReportTranslator.java

OpenMRS Data Model
FHIR Resource Element
Obs.uuid
DiagnosticReport.id
Obs.status*
DiagnosticReport.status
Obs.concept

DiagnosticReport.code

<static mapping: http://hl7.org/fhir/v2/0074/index.html#v2-0074-LAB>

DiagnosticReport.category

Obs.encounterDiagnosticReport.encounter
Obs.personDiagnosticReport.subject
Obs.dateCreatedDiagnosticReport.issued
Obs.groupMembersDiagnosticReport.result

* Obs.status is not available for OpenMRS platforms < 2.1.0, and there is currently no mapping for DiagnosticReport.status in lower OpenMRS version. The Lab Integration Workflow is targeting OpenMRS 2.0.5, and will not be using this mapping initially.

Targeted OpenMRS Use Cases 

  1. Lab Integration Workflow

Available RESTful Endpoints

Note: placeholder "{release}" below must be replaced by the FHIR Release - currently "R3" and "R4" are implemented. See more on the  FHIR Release support  page.

Method

URL

Description

GET/ws/fhir2/{release}/DiagnosticReport/{uuid}Above request will fetch the DiagnosticReport for the given unique uuid.
POST/ws/fhir2/{release}/DiagnosticReport
PUT/ws/fhir2/{release}/DiagnosticReport/{uuid}