Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Projects

Page tree
Skip to end of metadata
Go to start of metadata

FM2-5 - Getting issue details... STATUS

DiagnosticReport is a FHIR resource that is part of the Diagnostic Medicine Module. A DiagnosticReport is used to represents 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 web services for the DiagnosticReport Resource supported by the OpenMRS FHIR API

GET

URLDescription
/ws/fhir2/DiagnosticReport/{uuid}Above request will fetch the DiagnosticReport for the given unique uuid.

CREATE

URLDescription
/ws/fhir2/DiagnosticReport


UPDATE 

URLDescription
/ws/fhir2/DiagnosticReport/{uuid}
  • If the DiagnosticReport with the given uuid exists, update the existing attributes according to the representation.