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

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.encounter

DiagnosticReport.encounter

Obs.person

DiagnosticReport.subject

Obs.dateCreated

DiagnosticReport.issued

Obs.groupMembers

DiagnosticReport.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

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}

 

Related Github Links