HL7 BE Laboratory WG Implementation Guide
1.0.0 - STU
This page is part of the HL7 Belgium FHIR Implementation Guide - Lab related profiles (v1.0.0: Trial Use) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Contents:
This Visualisation Guidance page aims to give guidance about which of the structured elements available in a diagnosticreport SHALL be minimally visualised and in what kind of structure they SHALL be minimally presented to safely understand them.
This is not a guidance page on the actual report, the thumb of rule here concerning the referenced elements is: this is to be visualized IF they are available in the report. Please refer to the other pages in this guide for guidance on how to construct the report. It is up to a human inspection to finally judge the quality of the report that is visualized following the rules on this page.
PLEASE NOTE: This page does NOT aim to give exhaustive guidance how any user friendly presentation should be like when the structured elements are structurally integrated in a patient dossier - that is considered the domain of any consuming system. |
PLEASE NOTE: Whenever a specific element is given infra (e.g. '.identifier') without extra explication, it is implied any sub elements of this element that are available SHALL be displayed. Also, if the element repeats, the repeats SHALL be visualized. |
Considerations concerning a creation of a federal visualisation tool:
Status
Identifier(s) of the reports
One general title
Extra category(ies) applicable to this report
Effective(Time of the specimen collection - is overruled when collection time is given in .specimen element.)
Issue date of this report
General conclusions based on this report
It is fully expected the original prescription may not be exhaustively available in the report. However, if available, the following elements SHALL be visualised
Identifier(s)
Authored on
It is fully expected a patient may not be exhaustively available in the report. However, if available, the following elements SHALL be visualised
Identifier(s)
Name(s)
Birthdate
Telecom
Address
It is fully expected the performer(s) (here it is assumed they are of the Practitioner and/or Organization type) may not be exhaustively available in the report. However, if available, the following elements SHALL be visualised
Identifier(s)
Name(s)
Telecom
Address
It is fully expected the results interpreter(s) (here it is assumed they are of the Practitioner and/or Organization type) may not be exhaustively available in the report. However, if available, the following elements SHALL be visualised. If this is the same entity as the performer supra, this MAY be omitted for readability purposes.
Identifier(s)
Name(s)
Telecom
Address
Identifier(s)
Status
Type
Received time
Parent specimen (It is possible a specimen refers to a parent specimen(s), from which it originated. In that case the specimen SHALL clearly state this by giving the identifier(s). The actual parent specimen(s) SHALL be visualized as seperate specimen.)
Collection details (All subelements available under the .collection element SHALL be visualized when available (e.g. when they were collected, the method of collection etc.)
Processing details (All subelements available under the .processing element SHALL be visualized when available (e.g. a specific procedure that was done)
Condition
Notes (Any free text note to explain something concerning the specimen)
As a general guidance concerning the visualisation of the observations any visualisation mechanism SHALL take note an observation MAY have components (.component element) and an observation MAY have member observations (.hasMember element). If any of these structures exists, a visualisation mechanism SHALL present these structures in a hierarchical fashion. Cfr. infra for specific guidance in specific reports
When visualizing a CodeableConcept:
Status (For readability purposes a status of 'final' MAY be hidden)
Category (NB remark supra 'When visualizing a CodeableConcept')
Code (NB this is the main code to identify the Observation. When an Observation is used as a title, it may happen no actual code is available in the .code element but this title will be available in the .code.text element.) (NB remark supra 'When visualizing a CodeableConcept')
Effective time (the clinically relevant time of of the observation)
Issued time (time this observation was made available)
Performer (observation.performer)
It is fully expected the performer(s) (here it is assumed they are of the Practitioner and/or Organization type) may not be exhaustively available in the report. However, if available, the following elements SHALL be visualised
For readability purposes, it is RECOMMENDED to only visualise the performer here when it is available and different from the performer in the root of the diagnosticreport
Identifier(s)
Name(s)
Telecom
Address
Value (Special attention SHALL be given to also correctly visualize any unit)
Data absent (NB remark supra 'When visualizing a CodeableConcept')
Interpretation (NB remark supra 'When visualizing a CodeableConcept')
Reference Range
Bodysite (NB remark supra 'When visualizing a CodeableConcept')
Method (NB remark supra 'When visualizing a CodeableConcept'
Specimen (observation.specimen)
Notes
The .note element MAY contain an author and a time. The author MAY be omitted for readability purposes if it is the same as the performer of the Observation (when the performer is omitted already because it is the same as the performer in the DiagnosticReport it follows the author of the note, in case it is again the same is also omitted)
A typical structure in an antibiogram is a 'master' observation that has a member Observation for each culture. Each of these members will have a member list for all the susceptibilities of that culture.
The rules around hierarchical fashion as described supra apply here but the visualisation for an antibiogram SHALL be to visualise these susceptibility lists in columns. (Giving the name of the antibiotic only once and expressing the different susceptibilities for the different cultures as columns that are cleary marked to which culture they apply) This means for readibility purposes, only the .interpration element is considered from the susceptibility Observation.
Example:
[...] Culture 1.Morganella morganii 2.Escherichia coli Antibiogram 1 2 Ampicilin R S Trimethoprim+Sulfamethoxazole S S Nitrofurantoin R S Cefuroxime R S Gentamicin S S Colistin R S [...]
A report that does not contain any structured information concerning the observations is not considered to be a structured Belgian laboratory report but technically, the format still allows for this. A proper visualisation for the results in those kind of reports is the rendering of the pdf that will live in the .presentedForm element.