General Lab DiagnosticReport (Patient) Profile
FHIR Requirements for general lab DiagnosticReport information displayed to a citizen/patient.
Constraints on the DiagnosticReport resource to reflect source data mappings for the ACCESS Health project. Focus of this profile is on display of general Diagnostic Report result information to citizen/patient viewers.
This profile was generated from HL7 DiagnosticReport StructureDefinition
Sources-To-Date
Nova Scotia HL7v2 LIS Specification & Test Messages
Prince Edward Island HL7v2 LIS Specification
Ontario Laboratory Information System (OLIS) HL7v2 LIS Specification
Constraints
As part of the scope of the discovery phase of this project, mappings, profiles, and implementation guides were expected to be agnostic with regard to implementation decisions or architectural paradigm.
- It could not be assumed that future implementations will exchange information via a RESTful API.
- Design for how resources could be identified and verified/matched across organizations and jurisdictions fell outside of scope for this phase. Mappings had to be made under the most basic assumption that resources could be referenced on a local server.
Availability of Atlantic LIS specifications and test messages were also a limitation on mapping and profiling efforts. Currently, the general lab profiles were completed using documentation from Nova Scotia, Prince Edward Island, and Ontario Lab Information Systems (LIS). Additional evaluation and iteration of these profiles, as additional jurisdictional specifications are made available, is paramount to ensure the final profile reflects the current state of Atlantic systems.
Alignment and compatibility with other prominent profiles in similar functional areas were sought (e.g. OLIS, US Core/CA Core), in part to validate the ACCESS Atlantic work, and in part to ensure that decisions taken in developing the ACCESS profiles were, at a minimum, not mutually exclusive with widely used profiles.
ACCESS General Lab DiagnosticReport (Patient) Profile
ACCESS DiagnosticReport General Lab (Patient) Profile
AccessDiagnosticReportGeneralLabPatient (DiagnosticReport) | | | DiagnosticReport | There are no (further) constraints on this element Element idShort description ACCESS DiagnosticReport General Lab (Patient) Profile Definition Expected requirements for the DiagnosticReport resource when reflecting general lab result data based on existing source mappings.
Comments Note for implementors: This profile focuses on general lab results. It excludes pathology, microbiology, serotology, etc for two reasons: 1) The density and content of information in the various lab types are dramatically different from each other, these differences drive different information and interaction requirements from patients, and 2) there is a large degree of variance in how general lab results are formatted (more structured) and how other types of labs like pathology are structured (largely text based). Additional analysis required for microbiology, serotology, and pathology lab result types to determine level of structured data available.
Data type DiagnosticReport |
identifier | | | Identifier | There are no (further) constraints on this element Element idDiagnosticReport.identifier Short description Business identifier for report Data type Identifier Mappings- vendor-agnostic-v2: OBR-51
Other suggested options if OBR-51 is not available: OBR-2 + OBR-3 + OBR-4
- ontario--olis: OBR-3 + ORC-4
- prince-edward-island--cerner-millennium: OBR-2 + OBR-3
- nova-scotia--meditech-magic: OBR-2 + OBR-3
- nove-scotia--cerner-millennium: OBR-2 + OBR-20
- nova-scotia--meditech-c/s: OBR-2 + OBR-3
|
status | S | | codeBinding | There are no (further) constraints on this element Element idShort description registered | partial | preliminary | final + Comments Mapping Note: See the notes in the mapping document discussing the need to map the HL7 v2 codes used by the LIS (shorthand often single-digit codes) to the codes used by the FHIR value set (usually full word code).
Data type code Binding DiagnosticReportStatus (required)Mappings- vendor-agnostic-v2: OBR-25 (not 1:1 mapping)
- ontario--olis: OBR-25 (Codes supported: P, F, C, N, W, X, Z)
- prince-edward-island--cerner-millennium: OBR-25 (Codes supported: P, F, C, D, R, S, D, U, I) Could also receive codes from Cerner Millennium Code Set 8 (UNAUTH, TRANSCRIBED, C_TRANSCRIBED, INPROGRESS, AUTH, ALTERED, MODIFIED, INERROR, INERRNOMUT, INERRNOVIEW, CANCELLED, NOT DONE)
- nova-scotia--meditech-magic: OBR-25 (Codes supported: P, F, D, A*)
- nove-scotia--cerner-millennium: OBR-25 (Codes supported: P, F, C)
- nova-scotia--meditech-c/s: OBR-25 (Codes supported: P, F, C, D, A*, FOUT*)
|
category | S | 1..* | CodeableConcept | There are no (further) constraints on this element Element idDiagnosticReport.category Short description Service Category Comments Laboratory should be the default code used in this diagnostic report profile. Other profiles may support other codes.
Data type CodeableConcept Sliced: Unordered, Open, by pattern(Value) Binding Diagnostic Service Section Codes
DiagnosticServiceSectionCodes (example)Mappings- vendor-agnostic-v2: OBR-24
- ontario--olis: ?
- prince-edward-island--cerner-millennium: OBR-24
- nova-scotia--meditech-magic: OBR-24
- nove-scotia--cerner-millennium: OBR-24
- nova-scotia--meditech-c/s: OBR-24
|
(All Slices) | | | | There are no (further) constraints on this element |
lab | S | 1..1 | CodeableConceptPattern | There are no (further) constraints on this element Element idDiagnosticReport.category.lab Data type CodeableConcept Pattern {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v2-0074",
"code": "LAB"
}
]
} |
code | S | | CodeableConceptBinding | There are no (further) constraints on this element Element idShort description Name/Code for this diagnostic report Comments Implementor Note: US Core uses a value set that pulls from the LOINC Diagnostic Report codes but does not fix a certain value. OLIS pulls from LOINC but requires a fixed value of 11502-2 to identify the lab report. Keeping the LOINC value set as an example is intended to strike a balance between both profiles, but further investigation with jurisdictional end-users/LIS is recommended to determine if a fixed value should be pursued to reduce confusion and inconsistency for patients.
Data type CodeableConcept Binding LOINC Diagnostic Report Codes
LOINCDiagnosticReportCodes (preferred)Mappings- vendor-agnostic-v2: OBR-4 (HL7 v2 doesn't provide an easy way to indicate both the ordered test and the performed panel)
- ontario--olis: OBX-3
- prince-edward-island--cerner-millennium: OBR-4
- nova-scotia--meditech-magic: OBR-4
- nove-scotia--cerner-millennium: OBR-4
- nova-scotia--meditech-c/s: OBR-4
|
subject | S | 1..1 | Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-patient) | There are no (further) constraints on this element Element idShort description The subject of the report Data type Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-patient) Mappings- vendor-agnostic-v2: PID-3(MRN) , PID-2 (primary insurance policy number) should also be considered
Other suggested options if PID-3 is not available or the patient resource is tied to provincial identifiers: PID-2 OR PID-4 (Depending on if HL7 v2.3 or lower)
- ontario--olis: PID-3
- prince-edward-island--cerner-millennium: PID-3 (if v2.3.1 and above), PID-4 (if v2.3 or below)
- nova-scotia--meditech-magic: PID-3
- nove-scotia--cerner-millennium: PID-3
- nova-scotia--meditech-c/s: PID-3
|
effectiveDateTime | S | | dateTime | There are no (further) constraints on this element Element idDiagnosticReport.effectiveDateTime Short description Clinically relevant time/time-period for report Data type dateTime Mappings- vendor-agnostic-v2: OBR-7 (Observation Date/Time)
- ontario--olis: OBR-7
- prince-edward-island--cerner-millennium: OBR-7
- nova-scotia--meditech-magic: OBR-7
- nove-scotia--cerner-millennium: OBR-7
- nova-scotia--meditech-c/s: OBR-7
|
issued | S | | | There are no (further) constraints on this element Element idShort description DateTime this version was made Comments Mapping note: Keep in mind that the instant data type requires seconds and time zone to be reported and the HL7 v2 ORU messages that are the source of the conversions are likely to only include YYYY-MM-DD-HH-DD. If hour and minute are unknown, the Meditech NS LIS append "UNK". Additional work will be required on behalf of the converter to add in zeros for seconds and time zone to be conformant to the FHIR Data type. There are no limitations from the base HL7 spec or NS implementation guides for time stamp that would prevent bi-directional conversion.
Mappings- vendor-agnostic-v2: OBR-22 (Results Rpt/Status Chng – Date/Time)
Other suggested options if OBR-22 is not available: OBR-7 or OBX-19 can be used if interface is HL7 v2.4 or higher
- ontario--olis: ZBX-1 (Test Result Release Date/Time)
- prince-edward-island--cerner-millennium: OBR-22
- nova-scotia--meditech-magic: OBR-22
- nove-scotia--cerner-millennium: OBR-22
|
performer | S | | Reference(Practitioner | Organization) | There are no (further) constraints on this element Element idDiagnosticReport.performer Short description Responsible Diagnostic Service Data type Reference(Practitioner | Organization) Sliced: Unordered, Open, by profile(Value) |
(All Slices) | | | | There are no (further) constraints on this element |
practitioner | | | Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-practitioner) | There are no (further) constraints on this element Element idDiagnosticReport.performer.practitioner Short description Practitioner responsible for the diagnostic report Comments SME Note: Rare in general labs to have physicians that sign the lab result. Lab performing practitioner is usually internal information that gets stored by LIS for operational purposes, but not likely of value to patients or clinicians.
Implementor Note: Included for alignment with existing Canadian & International profiles, kept as optional until reviewal by end-users determines removal or must-support flag.
Data type Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-practitioner) Mappings- vendor-agnostic-v2: OBR-32 (Principal Result Interpreter) or OBX-16 (Responsible Observer)
- prince-edward-island--cerner-millennium: OBR-32
- nove-scotia--cerner-millennium: OBX-16 (not sent for all results)
|
organization | | | Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-organization) | There are no (further) constraints on this element Element idDiagnosticReport.performer.organization Short description Organization responsible for the diagnostic report Comments SME Note: Most commonly, performing organization will be available (more frequently than performing practitioner).
Data type Reference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-organization) Mappings- vendor-agnostic-v2: OBX-15 (Producer ID), OBX-23 (Performing Organization Name) if interface is HL7 2.5.1 and higher
- ontario--olis: ZBR-6 (Performing Laboratory)
- prince-edward-island--cerner-millennium: OBX-23
- nova-scotia--meditech-magic: ZPS-2 (Meditech performing lab site mnemonic) / ZPS-3 (Meditech performing lab site name)
- nova-scotia--meditech-c/s: OBX-15
|
specimen | | | Reference(Specimen) | There are no (further) constraints on this element Element idDiagnosticReport.specimen Short description Specimens this report is based on Data type Reference(Specimen) Mappings- vendor-agnostic-v2: OBR-3.1 (Filler Order Number ID) SPM-2 (Specimen ID) can be used in interfaces that are HL7 v2.5.1 and higher
- ontario--olis: OBR-3.1
- prince-edward-island--cerner-millennium: SPM-2.2
- nova-scotia--meditech-magic: OBR-3.1
- nove-scotia--cerner-millennium: OBR-20 (Filler Field 1+ Unformatted Millennium accession number)
- nova-scotia--meditech-c/s: OBR-3.1
|
result | S | | Reference(ACCESS Observation General Lab (Patient) Profile) | There are no (further) constraints on this element Element idShort description Observations Data type Reference(ACCESS Observation General Lab (Patient) Profile) Mappings- vendor-agnostic-v2: OBX-21 (Observation Instance Identifier)
Other suggested options if OBX-21 is not available: OBR-2 (Placer Order Number) + OBR-3(Filler Order Number) + OBX-3 (Observation Identifier)
- ontario--olis: OBR-3.1
- prince-edward-island--cerner-millennium: OBR-3.1 + OBR-4.1
- nova-scotia--meditech-magic: OBR-3.1 + OBR-4.1
- nove-scotia--cerner-millennium: OBR-20 + OBR-4.1
- nova-scotia--meditech-c/s: OBR-3.1 + OBR-4.1
|
conclusion | | | string | There are no (further) constraints on this element Element idDiagnosticReport.conclusion Short description Clinical conclusion (interpretation) of test results Data type string Mappings- vendor-agnostic-v2: OBX. Or NTE-3 when NTE-2 data type is interpretive data
|
conclusionCode | | | CodeableConcept | There are no (further) constraints on this element Element idDiagnosticReport.conclusionCode Short description Codes for the clinical conclusion of test results Data type CodeableConcept Binding SNOMED CT Clinical Findings
SNOMEDCTClinicalFindings (example)Mappings- vendor-agnostic-v2: OBX. Or NTE-3 when NTE-2 data type is interpretive data
|
Removed the following elements from the profile due to lack of available semantically equivalent ORU fields across examined sites:
- basedOn, encounter, resultsInterpreter, imagingStudy, media, presentedForm
Flagged the following elements as "Must Support":
- status, category, code, subject, effectiveDateTime, issued, performer, result
Changed the cardinality of the following elements:
These profiles sought to target alignment with the US Core DiagnosticReport Profile and OLIS DiagnosticReport Profile in order to avoid proliferation of competing standards.
Much like Observation, the ACCESS DiagnosticReport profile has intentional alignment with the US Core DiagnosticReport profile.
Differences between the two profiles are largely due to the citizen access focus of the ACCESS profile as well as from natural constraints and variances from the anticipated data sources (HL7 v2 ORU RO1 messages).
Differences between the two profiles are as follows:
Must Support Differences
- Media and presentedForm elements are flagged as Must Support elements in the US Core profile, but are not considered Must Support in the ACCESS profile.
- Media: This decision was due to the difficulty associated with correctly identifying and parsing the correct media from an HL7 v2 ORU RO1 attachment when there is no clear method of differentiating between what the base-64 encoded images are intended to represent when they are included in the OBX-5 field of a message.
- presentedForm: While providing the full ORU message in the presentedForm element helps clinicians ensure clinical fidelity, this profile is solely focused on providing simple meaningful lab information to patients in a user-friendly manner that can be displayed by third-party applications. Very few patients are expected to know how to read the ORU messages presented and the variances between LIS formatting of messages will likely cause further confusion.
Cardinality Constraint Differences
- Category, effective, and issued have different cardinalities between the two profiles which can be categorized in the following ways:
- Elements with upper constraint added in US Core profile: category
- Elements with lower constraint added in US Core profile: effective, issued
Data Type Constraint Differences
Binding Differences
- Setting a fixed system or value for category was avoided due to the expectation that other profiling efforts will result in the use of two (or more) category systems and values. US Core fixes its system to “http://terminology.hl7.org/CodeSystem/v2-0074” and fixes its value to “LAB”. ACCESS provides an example binding from the same code system but allows for additional diagnostic service categories to be present in the value set since that additional detail may be present in OBR-24 of the source HL7 v2 messages.
- For diagnosticReportCode, US Core creates an extensible binding to its own value set: US Core Diagnostic Report Laboratory Codes which pull from the LOINC code system. Because the LIS in the analysis primarily use their own unique nomenclatures (with some jurisdictions like PEI and OLIS supporting LOINC codes or nomenclatures that map to LOINC codes) the ACCESS profile identified the LOINC codes as a preferred binding when available but did not require its use through a “required” or “extensible” conformance binding.
- The ACCESS DiagnosticReport profile supports the optional elements of conclusionCode and provides an example binding to SNOMED CT clinical findings.
Much like Observation, the ACCESS profile and OLIS DiagnosticReport profiles are similar; Observation ACCESS profile requirements are an approximate subset of OLIS requirements. It's important to note that OLIS profiles are built on FHIR STU3, while ACCESS profiles are built on FHIR R4, so a one-to-one comparison is not possible. Furthermore, the ACCESS profiles are tailored to citizen access, whereas OLIS is intended to support clinician use. Differences between the two profiles are as follows:
Must Support Differences
- category and effectiveDateTime are flagged as Must Support for the ACCESS profile and US Core, but not OLIS
- id, contained, identifier, specimen, and codedDiagnosis are flagged as Must Support for OLIS but not the ACCESS profile.
Cardinality Constraint Differences
- identifier, category, performer, and specimen have different cardinalities between the two profiles which can be categorized in the following ways:
- Elements with upper constraint added in OLIS profile: category, performer, and specimen
- Elements with lower constraint added in OLIS profile:
- Elements with both upper and lower constraints added in OLIS profile: identifier
- Elements with a lower constraint added in the ACCESS profile: category
Data Type Constraint Differences
- The OLIS profile constrains subject to the OLIS Patient Profile, while the ACCESS profile references the CA Core Patient Profile in anticipation of its release
- The ACCESS profile similarly limits performer data types to Practitioner and Organization references, however, each references its respective profiles (CA Core & OLIS)
- In addition to referencing its own Observation profile, OLIS also references a secondary OLIS Observation profile focused on Microbiology. The ACCESS profile in comparison only focuses on general lab results & diagnostic reports.
Binding Differences
- The ACCESS profile binds to the R4 Diagnostic Report Status value set whereas the OLIS profile binds to the STU3 Diagnostic Report Status value set. Similar to the observation profile, the value sets are different, but the coded values within both value sets are the same so no terminology considerations are anticipated.