Release Notes

Release 2025.09.09

FHIR Features

  • Apigee X Configurations for specific authorized users
  • Infrustructure updates for improved On-Call support efficiency
  • Updating and additional STMO configuration

Release 2025.09.04

DICOM Features

  • Added DICOM data stores eligible for archival storage

FHIR Features

  • Apigee X bug fixes
  • Apigee X added application user exceptions
  • Infrastructure updates and vulnerability management

Release 2025.08.19

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.2.0 DiagnosticReport-Lab HL7v2 - ORU HL7v2 - ORU Update presentedForm.contentType to "text/html" of realtime and historical resources
2.1.0 Observation-Flowsheet HL7v2 - ORU HL7v2 - ORU New field named "performer" introduced to capture patient entered flowsheets

Release 2025.07.22

FHIR Features

  • Apigee X External LPR proxies are now available
  • Apigee X bug fixes and IP allowlisting
  • OnBase to LPR logging improvements

Release 2025.07.15

FHIR Features

  • Dataflow and Pubsub alerts are configured for the Midia project
  • API Product Descriptions are updated for Apigee X Internal
  • Provide access to MCP team to perform deidentification of dicom store
  • Apigee Prod Exceptions have been added for Guard and RLIMS applications

Release 2025.07.10

FHIR Features

  • Appointment - Full backload completed

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.8.0 Appointment-Patient HL7v2 - SIU Full backload to populate visit mode service category.

Release 2025.07.08

FHIR Features

  • Apigee X Internal LPR proxies are now available
  • Improved handling for CareEverywhere documents
  • Fixes to FHIR Ingest Framework
  • Improved performance of EAPIS STU3 MedicationStatement

Release 2025.06.23

FHIR Features

  • DocumentReference-MDM - Full backload completed

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.9.1 DocumentReference-mdm HL7v2 - MDM (Epic Clinical Notes) HL7v2 - MDM (Epic Clinical Notes) Full backload to add support for Practitioner literal references if available

Release 2025.05.13

FHIR Features

  • DocumentReference-Care Everywhere - Maya-scoped release of PDF and expanded patient cohort

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.2.0 Practitioner PractitionerRole Epic Clarity Attribute improvements to support Care Team Navigator

Release 2025.04.22

DICOM Features

  • Removed legally restricted images from the LPR ImagingStore through April 3, 2025.

FHIR Features

  • Removed ImagingStudy and Endpoint FHIR resources associated with legally restricted images from the LPR FHIR store through April 3, 2025.

Release 2025.03.27

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.5.0 DocumentReference-onbase Hyland OnBase Exports Hyland OnBase Exports Backloaded all historical time ranges, updated document date representation to CT offsets, added type coding code value. Some documents not yet loaded (see Known Issues & Limitations).

Release 2025.03.25

FHIR Features

  • Fixes legacy-only Patient merge issue
  • Internal infrastructure updates

Release 2025.03.11

FHIR Features

  • Adds log retention for LPR FHIR Apigee proxy auditing
  • Improves support for internal vulnerability monitoring
  • Add new entitlements and access for granular restrictive and sensitive data

Release 2025.03.05

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.3.1 ServiceRequest HL7v2 - ORM,ORU Historical backload with updates to authoredOn, identifier, and status fields

Release 2025.03.04

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.3.1 ServiceRequest HL7v2 - ORM,ORU Realtime updates to authoredOn, identifier, and status fields

Release 2025.02.25

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.2.0 Patient HL7v2 - ADT HL7v2 - ADT Added meta.security tags to represent privacy indicators: an indicator for patients that require Epic Break-the-Glass to access, and an indicator for "Confidential Patient" as seen in Epic Hyperspace. See LPR Privacy & Security for more info.

Release 2025.01.28

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
6.5.1 AllergyIntolerance HL7v2 - ADT Historical backload with recordedDate element, where available

FHIR Features

  • Address malformed PDFs in pre-Epic on-demand rendering
  • MIDIA data quality improvements
  • OnBase operational improvements
  • LPR data quality improvements

Release 2025.01.07

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.4.1 DocumentReference-onbase DocumentReference-OnBase improved validation of encounter CSN
2.6.0 ImagingStudy Backloaded identifier and type to subject and endpoint identifier attributes.
1.25.1 DiagnosticReport-Radiology HL7v2 - ORU Adds additional Practitioner references

Release 2024.12.03

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.3 DocumentReference-onbase Added time granularity to the DocumentReference.date attribute for new DocumentReference resources. (historical patch planned for future release)

Release 2024.11.19

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.1.0 DocumentReference-onbase Added identifier and type to subject and context.encounter attributes.

FHIR Features

  • Data Quality configuration updates for MedicationRequest, DocumentReference-onbase
  • Infrastructure updates and vulnerability management

Release 2024.11.12

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.1 DocumentReference-onbase Added business key identifier to list of identiifers

Release 2024.09.24

FHIR Features

  • HL7v2 notifications
    • A new topic for HL7v2 messages has been created
    • gcs-to-fhir now sends all HL7v2 messages to the newly created topic
  • Legacy FHIR Store
    • All patients have been reloaded into Legacy FHIR Store after error replay process was fixed
  • Daily FHIR Backup and Restore
    • Failures involving the daily FHIR backup and restore of ValueSet have been resolved

Release 2024.09.17

DICOM Features

Release 2024.09.10

FHIR Features

  • Improved data latency

Release 2024.09.03

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.1.9 Observation-Flowsheet HL7v2 - ORU
2.5.2 Observation-Lab HL7v2 - ORU

FHIR Features

  • Observation (Flowsheet) Fixes
    • Cleaned up duplicate Observation resources
  • Observation (Lab) Fixes
    • Updated logic for 'note' field

Release 2024.08.30

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.5.4 Flag-AdvancedDirective HL7v2 - ADT 30 day replay of history
1.5.4 Flag-InfectionStatus HL7v2 - ADT 30 day replay of history
1.5.4 Flag-IsolationStatus HL7v2 - ADT 30 day replay of history

FHIR Features

  • Flag
    • Isolation Flag is now based on an encounter. Flag identifier.value migrates from {mrn}_{isolation type} to {mrn}_{csn}_{isolation type}.
    • Advance Directive and Isolation Status are processing nearly all ADT message event types. Previously a subset of message event types were used.
    • Fixed various bugs with deactivating and reactivating Flags

Release 2024.08.27

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.5.0 DiagnosticReport-Pathology HL7v2 - ORU

FHIR Features

  • DiagnosticReport (Pathology) Fixes
    • Updated logic for 'status' field
  • Observation (Pathology) Fixes
    • Updated logic for 'category' field

Release 2024.08.20

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.6.3 Appointment-Patient HL7v2 - SIU
2.6.3 Appointment-Surgery HL7v2 - SIU
1.0.0 ValueSet No real-time. Data is updated daily for changes from Terms

FHIR Features

  • Appointment Fixes
    • Updated logic for 'start' field
  • ValueSet Changes
    • Updated identifier due to change in data source

Release 2024.08.13

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.3.3 Coverage HL7v2 - ADT
6.3.1 Patient HL7v2 - ADT

FHIR Features

  • Coverage Fixes
    • Fixed error processing related person
  • Patient Enhancements
    • Added originating MRN identifier to Patient

Release 2024.08.02

FHIR Features

  • Patient: updated the Patient BigQuery flattened views to include columns that represent first name and middle name:
    • ‘given_name_1’
    • ‘given_name_2’

Release 2024.07.30

Version FHIR Resource Historic Source Real-time Source Notes
2.6.1 Appointment-Patient HL7v2 - SIU
2.6.1 Appointment-Surgery HL7v2 - SIU

FHIR Features

  • Appointment Fixes
    • Updated logic for 'serviceType' field

Release 2024.07.23

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.3.0 DiagnosticReport-Pathology HL7v2 - ORU

FHIR Features

  • DiagnosticReport (Pathology)
    • Performed historical Load

Release 2024.07.16

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.2.0 Observation-Lab HL7v2 - ORU

FHIR Features

  • Observation Fixes
    • Cleaned up duplicate Observation resources
  • Observation (Microbiology)
    • Performed historical Load

Release 2024.07.09

Version FHIR Resource Historic Source Real-time Source Notes
2.4.1 Appointment-Patient HL7v2 - SIU
2.4.1 Appointment-Surgery HL7v2 - SIU

FHIR Features

  • Appointment Fixes
    • Fixed a bug where only the first Practitioner associated with the Appointment as added. Now additional participating Practitioners will be associated with Appointment resources with a participant type code of "http://terminology. hl7.org/CodeSystem/v3-ParticipationType|PART"

Release 2024.07.02

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.3.1 Coverage HL7v2 - ADT
2.2.0 Observation-Lab HL7v2 - ORU

FHIR Features

  • Coverage Enhancements
    • Bugfixes
      • Complete names provided for Coverage related person
  • Observation (Microbiology) Enhancements
    • Improved resource identifier
      • identifier.value will be a 3 or 4 part - delimited string
      • orderId-orderCode-resultCode or orderId-orderCode-resultCode-subId

Release 2024.06.18

FHIR Features

  • ValueSet Search – When querying the LPR FHIR Store via Apigee API, the code:in= parameter now supports searching ValueSets of any size.
    • This functionality overcomes a limitation from Google’s Healthcare API (queries with code:in= fail if the ValueSet exceeds roughly 600 items).
    • LPR consumers can now execute FHIR API queries with expected usage, more closely resembling the access patterns supported by EAPIS API
    • See FHIR Specs for additional details about standard code:in= functionality

Release 2024.05.30

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.2.3 Appointment-Patient HL7v2 - SIU
2.2.3 Appointment-Surgery HL7v2 - SIU

FHIR Features

  • Appointment Enhancements

    • Bugfixes
      • Start time not present for errored Appointments
      • Appointment type ConceptMap updates for accuracy
    • Expanded the Appointment.participants field to include more location details
      • Room Code (AIL-3.1)
      • Bed Code (AIL-3.2)
      • Care Department (AIL-3.4)
      • Surgical Room/Bed/Dept Code: (AIG-3.2)
    • Linked Location references for the following:
      • Surgical - Care Department (example care department 'ROMBOR')
      • Patient - Department (example department 'RST HPBS ROGO')
    • For Surgical Appointments, added two meta tags for the sending application (MSH-3.2) and receiving facility (MSH-6.1) for consumers needing specialized flag data
    • Enabled reference linking for Practitioners in Appointments. This enables a "by provider" search by using the standard _revinclude FHIR query pattern
  • Concept Maps

    • Addition of a new concept maps to associate Locations with a primary regions (i.e. MCR, MCF, MCA, MCHS). This ConceptMap can be retrieved by using the following query: ConceptMap?url=http://terms.mayo.edu/mccfhir/conceptmap/epic.location.code.to.region.code

Release 2024.05.07

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.0 ImagingStudy Midia, IIMS No historic backload / Real time only
6.0.4 Patient HL7v2 - ADT

FHIR Features

  • ImagingStudy Fixes and Enhancements

    The following address real-time processing only, historical patching is planned for future releases.

    • Bug fix for incorrect study and series dates (time zone handling)
    • Bug fix for rejected instances not being removed from studies
    • Bug fix for series.endpoint.type incorrect capitalization
    • Bug fix for series.instance.sopClass values being truncated
    • Bug fix for endpoint.type incorrect capitilization
    • Data change - subject.identifier and subject.name will no longer be populated (see subject.reference instead)
    • Improvements to error reporting and replay to improve data quality
    • Various performance enhancements
  • Real-time data ingestion process fixes and enhancements

    • Patient:
      • Updated communication.language mapping for some previously undetermined languages
      • Updated telecom.use values to reflect the actual system and use values in the source HL7v2 messages
      • Updated us-core-race extension to represent race code and display values in the ombCategory and detailed subextentions

Release 2024.05.02

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.2 DiagnosticReport (Lab) HL7v2 - ORU
1.2.3 Flag-AdvancedDirective HL7v2 - ADT
1.2.3 Flag-InfectionStatus HL7v2 - ADT
1.2.3 Flag-IsolationStatus HL7v2 - ADT
2.0.2 Coverage HL7v2 - ADT

FHIR Features

  • DiagnosticReport (Lab):
    • Change: LPR FHIR team will stop adding a header with patient details to the report text ('presentedForm.text' attribute) of DiagnosticReport (category = Laboratory) resources.
    • Reason for change: The patient details could change in a subsequent update from the EHR which renders the patient details in the DiagnosticReport text to be incorrect, leading to privacy and security issues.
    • Scope of change: These changes will be immediately applied to newly created or updated DiagnosticReport (Laboratory) resources. These details will also be removed from previous reports that had a chart correction event. All existing DiagnosticReport resources will remove these header details in a future release.
    • How to associate a report text to a patient after the change: Patient details associated with the DiagnosticReport's subject can be retrieved by querying the Patient resource directly.
    • As a reminder, DiagnosticReport (Radiology) reports initiated this change this past Tuesday, 4/29.
  • Flag (all categories: Isolation Status, Infection Status, Advance Directive Code):
    • Change: For Flags, the LPR FHIR ingestion process will no longer filter out ADT messages that do not contain PV1-19 segments (encounter identifiers). Our FHIR mapping specifications have changed the encounter identifiers from "required" to "optional."
    • Reason for change: Encounter identifiers are not required for Flags, specifically. Regardless of the encounter details, these messages contain meaningful updates for the Flags and filtering out these messages result in incomplete, inaccurate Flag statuses.
    • Scope of change: These changes will be immediately applied to newly created or updated Flag resources. In a future release, the previously created Flags will be adjusted to comply with the latest logic for more accurate, complete representation of the clinical data.
  • Coverage:
    • Change: The LPR FHIR ingestion process will now include a pre-process filter that skips Coverage messages that do not contain IN1-4 segments (Payor organization identifiers).
    • Reason for change: Payor organization identifiers (“payor” attributes) are required for Coverage resources, and messages missing this information cannot be used to create meaningful resources.
    • Scope of change: These changes are strictly internal to the LPR FHIR ingestion processing pipelines and have no impact to the data.

Release 2024.04.30

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.7 Observation-Flowsheet HL7v2 - ORU No historic backload
1.11.6 Condition HL7v2 - PPR No historic backload
1.21.3 DiagnosticReport-Radiology HL7v2 - ORU No historic backload

FHIR Features

  • DiagnosticReport (Radiology): Newly created or updated DiagnosticReports with results in the presentedForm attribute will no longer include patient name, MRN, DOB, or practitioner name appended to the report text's header. Existing resources that were subject to chart correction events will also have these additional annotations removed from presentedForm. All existing resources will remove these annotations in a future release.
  • Observation (Flowsheet): Enhanced pipeline performance for improved data freshness. No impact to the data.
  • Condition: Operational updates for pre-processing filters. No impact to the data.

Release 2024.04.23

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.4 Observation-Flowsheet HL7v2 - ORU
1.2.0 Flag-AdvancedDirective HL7v2 - ADT
1.2.0 Flag-InfectionStatus HL7v2 - ADT
1.2.0 Flag-IsolationStatus HL7v2 - ADT

FHIR Features

  • MedicationRequest: Remaining artifacts were removed from LPR
  • Observation (Flowsheet IO): For a subset of newly created or updated Observations that were previously missing details regarding I/O directionality (i.e. Intake vs Output), an enhancement has been applied to include the appropriate extension (extension.url="http://terms.mayo.edu/mccfhir/extensions/flowsheet_io_directionality").
  • Flag: Updating common LPR libraries which allows inactive flags to be properly inactivated (i.e. the given Flag no longer applies to the patient and should not be considered by an application). A 60 replay of Flag messages will be done in conjunction with this resource release to ensure older data is accurate. This is expected to be completed within the release window.

Imaging Features

  • All Family Medicine STMO created.

Release 2024.04.19

Legacy FHIR Store Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Legacy FHIR Store Make Apigee API call to V2 add header: fhir_resource: legacy

https://internal.mcc.api.mayo.edu/v2/mcc/fhir/r4/

header fhir_resource: legacy

Release 2024.04.16

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
5.16.1 Patient HL7v2 - ADT
1.9.4 ServiceRequest HL7v2 - ORM

FHIR Features

Real-time data ingestion process fixes and enhancements

  • Patient: Fixed display text for Patient confidential codes.
  • ServiceRequest: Fixes for requester field.

MedicationRequest

  • As communicated previously, MedicationRequest resources are no longer available in the LPR FHIR API, PubSub event streaming, or BigQuery tables and views. BigQuery tables and views have been dropped, with the following exceptions, to be dropped at a future date:

    • ml-mps-adl-arestricted-p-a43b.phi_raw_fhir_v2_us_p.MedicationRequest
    • ml-mps-adl-arestricted-p-a43b.phi_raw_fhir_v2_us_p.MedicationRequestView

    For more information please see https://docs.mcc.mayo.edu/docs/data-analytics/longitudinal-patient-record/lpr-bugs/#medicationrequest

Release 2024.04.09

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
2.0.2 Observation-Flowsheet HL7v2 - ORU
1.9.3 ServiceRequest HL7v2 - ORM
1.9.3 Coverage HL7v2 - ADT
1.26.1 Observation-Lab HL7v2 - ORU

FHIR Features

  • The following changes apply to DocumentReference
  • Observation (Lab/Micro): Real-time fix for “referenceRange. referenceRange.low” and “referenceRange.high” will only be populated if both a valid low and high value can be successfully parsed from “referenceRange.text”.
  • The following changes apply to ServiceRequest:
    • A new field “reasonCode” will be added to newly created or updated ServiceRequest resources.
    • Logic for the “status” field has been updated to recognize more valid source values within the HL7v2 messages.

Release 2024.04.04

FHIR Features

Real-time data ingestion process fixes and enhancements

  • ImagingStudy: Corrected issue where the ImagingStudy.series.started value was being populated from the series creation date rather than the acquisition time. The value for started will now be the acquisition time. Records prior to 2024-04-05 will be updated in a future release.

Release 2024.03.19

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.25.4 Observation-Lab HL7v2 - ORU

FHIR Features

Real-time data ingestion process fixes and enhancements

  • Observation-Lab: code update to fix multiple Observations with same identifier
  • ConceptMap: updates to include the most recent inactive mappings in addition to the active mappings
    • For example if the source data for a concept map has the following mappings:
      • A -> 1
      • B -> 2
      • C -> 3
    • Where A,B are active and C is inactive.
    • The map will now appear as show above
    • whereas before the change the map would look like:
      • A -> 1
      • B -> 2
    • All ConceptMaps with an identifier.system of http://terms.mayo.edu/systemid/terms/termsconceptmap/id are affected by this change

Release 2024.03.05

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.6 Flag-AdvancedDirective HL7v2 - ADT Data available from 2024-03-05 forward.
1.0.6 Flag-InfectionStatus HL7v2 - ADT Data available from 2024-03-05 forward.
1.0.6 Flag-IsolationStatus HL7v2 - ADT Data available from 2024-03-05 forward.

FHIR Features

  • Observation (Lab): Realtime fix for referenceRanges field. Only affects newly created and updated resources.
  • Procedure: Realtime fix for code field. Only affects newly created and updated resources.

Release 2024.02.27

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.25.2 Observation-Lab HL7v2 - ORU
1.7.0 Procedure HL7v2 - SIU

FHIR Features

Real-time data ingestion process: Upgraded for faster performance and higher throughput

  • Observation-Lab: add category information for microbiology message types
    • Another category code will be added
      • http://terms.mayo.edu/codesystem/EPIC_ORDER_TYPE_CODE|Microbiology
    • In addition to the lab categoy
      • http://terminology.hl7.org/CodeSystem/observation-category|laboratory
    • So a microbiology Observation resource will have two categories
  • Procedure: realtime fix for missing CPT codes

Release 2024.02.20

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.11.4 Condition HL7v2 - PPR No historic backload
2.16.1 Practitioner HL7v2 - MFN No historic backload
1.8.1 Procedure HL7v2 - SIU No historic backload

FHIR Features

  • Condition: Bug fix to ensure references to encounters are accounted for (when applicable). “note.text” changed to be one item concatenated by a new-line rather than separate items in the array.
  • Observation (vital signs): Changed “code.coding.display” and “code.coding.text” to be the proper display value of “Vital Signs” instead of “vital-signs”
  • Practitioner: Removing the “name.prefix” from newly created or updated resources due to data issues with the source data provided to LPR.
  • Procedure: Changed processing logic to not reject data with empty Surgical Panels

Release 2024.01.30

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
5.15.1 Patient HL7v2 - ADT
5.15.1 Encounter HL7v2 - ADT
5.15.1 AllergyIntolerance HL7v2 - ADT
1.9.1 Coverage HL7v2 - ADT
1.2.2 Observation-LDA HL7v2 - ORU
1.16.0 DocumentReference HL7v2 - MDM
2.15.0 Practitioner HL7v2 - MFN
1.7.0 ServiceRequest HL7v2 - ORM
1.24.0 Observation-Lab HL7v2 - ORU
1.9.0 Observation-Flowsheet HL7v2 - ORU
1.24.0 DiagnosticReport-Lab HL7v2 - ORU
1.15.0 DiagnosticReport-Pathology HL7v2 - ORU
1.11.0 Condition HL7v2 - PPR
1.1.0 Consent HL7v2 - OVC
2.2.0 MedicationAdministration HL7v2 - RAS
1.7.0 Procedure HL7v2 - SIU
1.0.0 Appointment HL7v2 - SIU

FHIR Features

  • Apigee Access: Updated the LPR documentation for requesting Apigee access:
    • “MCC Longitudinal Patient Record” for Dev/Test access in the Apigee NonProd Developer Portal.
    • “MCC Longitudinal Patient Record – Staging” for Stage access in the Apigee Production Developer Portal.
    • “MCC Longitudinal Patient Record” for Production access in the Apigee Production Developer Portal.
  • Procedure: Updated the underlying logic for the identifier attributes to follow best practices when populating the two supported identifier types within the Procedure BigQuery view in the ml-mps-adl-intfhr-phi-p-3b6e.phi_flat_fhir_us_p dataset. No columns were deleted or added.
  • Encounter: Improved the logic that updates resources with limited data attributes once an appropriate subsequent resource is identified with more complete data attributes Real-time data ingestion process: Upgraded for faster performance and higher throughput
  • BigQuery updates: Improved operational pipeline that syncs the LPR FHIR Store with downstream streaming BigQuery tables and views
  • Streamlined ingestion to increase data freshness

Release 2024.01.18

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
0.10.3 Appointment HL7v2 - SIU 14 day backload and all future appointments
1.23.6 Observation (Lab) HL7v2 - ORU No historic backload

FHIR Features

  • Appointment (Non-Surgical, Patient): Real-time data associated with non-surgical patient Appointments will now be represented in the LPR FHIR Store. In addition, appointments created or updated within the past 14 days will also be loaded into the FHIR Store. Older appointment data will be added to the LPR FHIR Store in separate future releases.
  • Observation (Lab): updated a subset of ‘code.coding[].code’ values for additional mapping of internal Epic codes to standardized LOINC codes
  • Procedure: updated ‘encounter.reference’ values to ensure relationships between Procedure and Encounter resources are properly maintained and updated
  • DocumentReference: updated the DocumentReference BigQuery flattened views (‘DocumentReference’ and ‘DocumentReferenceView’ in the ‘ml-mps-adl-intfhr-phi-p-3b6e.phi_flat_fhir_us_p dataset’) to include columns that represent contentTypes and URLs for both RTF and PDF attachments:
    • ‘content_rtf_attachment_contentType’
    • ‘content_rtf_attachment_url’
    • ‘content_pdf_attachment_contentType’
    • ‘content_pdf_attachment_url’

Release 2024.01.09

FHIR Features

  • Updates were made to the existing resource_code field within BigQuery Flattened Views in the ml-mps-adl-intfhr-phi-p-3b6e.phi_flat_fhir_us_p dataset so that the values are consistently populated with operational indicators (“CREATE”, “UPDATE”, or “DELETE”).
  • Internal updates were made to enhance the Apigee proxy; these changes had no impact to API consumers.

Release 2024.01.02

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.8.4 Observation (Flowsheet) HL7v2 - ORU No historic backload

FHIR Features

  • Observation (Flowsheet): added the sub-attribute dataAbsentReason.text when the resource’s status element is equal to entered-in-error for newly created resources

Release 2023.12.21

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
5.13.0 Encounter HL7v2 - ADT No historic backload
5.13.0 Patient HL7v2 - ADT No historic backload
1.15.4 DocumentReference HL7v2 - MDM (Epic Clinical Notes) No historic backload
1.1.6 Observation-LDA HL7v2 - ORU No historic backload

FHIR Features

  • Patient removed ‘generalPractitioner.display’ (Practitioner’s name) attribute for newly created resources
  • Encounter added another value to ‘type[]’ to represent an encounter’s level of care for newly created resources
  • DocumentReference added another value to ‘type.coding.code[]’ to include a LOINC code when there is an appropriate mapping from the internal Epic document type code for newly created resources
  • Observation (LDA) replaced the value of ‘identifier[].system’ to be consistent with the other Observation ‘identifier[].system’ values for newly created resources
  • Contact Move Additional operational updates were made to better support the LPR FHIR Store's handling of contact moves; these changes had no structural or data impacts to resources

Release 2023.12.05

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.23.5 DiagnosticReport (Lab) HL7v2 - ORU Operational updates only; No structural or data impacts to resources
1.15.3 DocumentReference HL7v2 - MDM (Epic Clinical Notes) HL7v2 - MDM (Epic Clinical Notes) Back load of DocumentReference data; consistent access patterns applied

FHIR Features

  • FHIR Full Event Streaming service has been upgraded to improve performance and reliability.
    • metadata attributes have changed as follows (see the FHIR Full Event streaming page for additional details on these attributes):
      • fhirID has been removed in favor of the id attribute within the FHIR resource message payload.
      • lastUpdatedTime has been added
      • storeName has been added
      • versionId has been added

Release 2023.11.28

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.23.4 DiagnosticReport (Lab) HL7v2 - ORU No historic backload
1.18.3 DiagnosticReport (Radiology) HL7v2 - ORU No historic backload
1.15.3 DocumentReference HL7v2 - MDM (Epic Clinical Notes) No historic backload

FHIR Features

The following changes apply to DiagnosticReport (Lab)

  • Fixed a code mapping

The following changes apply to DiagnosticReport (Radiology)

  • Fixed a status mapping

The following changes apply to DocumentReference

  • Fixed a content mapping
  • Support large documents (greater than 8MB)
  • Provide content from Epic Clinical Notes in both RTF and PDF formats
  • Represent RTF and PDF content as external files instead of inline

Release 2023.11.21

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.18.2 DiagnosticReport-Radiology HL7v2 - ORU Resolving errors
2.14.1 Practitioner HL7v2 - MFN No historic backload
5.12.0 Encounter HL7v2 - ADT No historic backload
1.6.5 ServiceRequest HL7v2 - ORM No historic backload
1.1.5 Observation-LDA HL7v2 - ORU No historic backload

FHIR Features

  • DiagnosticReport (Radiology) fixed a status mapping
  • Practitioner fixed a telecom communication mapping
  • Encounter removed practitioner reference display (person's name) from participant.individual.reference.display
  • Observation-LDA removed a trailing space in display text

Release 2023.11.14

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.1.2 Observation-LDA HL7v2 - ORU No historic backload

FHIR Features

  • Updated handling of concept mappings for Patient contact relationships (see field contact[].relationship[].coding[].system)

Release 2023.11.07

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.10.3 Condition HL7v2 - PPR No historic backload

FHIR Features

The following changes apply to the Condition resource. New data only is affected (Historic data will be backloaded at a later date.)

  • note[].text is an array with one element containing the note. Previously each note line was represented with an array element.

Release 2023.10.31

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Observation (Flowsheet) HL7v2 - ORU No historic backload
1.17.3 DiagnosticReport (Radiology) HL7v2 - ORU HL7v2 - ORU No historic backload
1.13.0 DiagnosticReport (Pathology) HL7v2 - ORU HL7v2 - ORU No historic backload
1.23.2 DiagnosticReport (Lab) HL7v2 - ORU HL7v2 - ORU No historic backload

FHIR Features

The following changes apply to the DiagnosticReport (Radiology) resource. New data only is affected (Historic data will be backloaded at a later date.)

  • Add basedOn field
  • Fix service request identifier system
  • Remove practitioner display
  • Moved modality from code to category

The following changes apply to the DiagnosticReport (Pathology) and DiagnosticReport (Lab) resource. New data only is affected (Historic data will be backloaded at a later date.)

  • Add presentedForm field

Release 2023.10.17

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 MedicationAdministration HL7v2 - RAS No historic backload

FHIR Features

  • Add "location_status" column to the EncounterLocation flattened materialized view
  • Add NDC codes to Medication resource

Release 2023.10.03

FHIR Features

The following changes apply to the Encounter resource:

  • Update "location" field to support planned and complete locations

Release 2023.08.29

FHIR Resources

  • Added photo/video consent pipeline to auto-replay configuration

FHIR Features

  • None

Release 2023.08.17

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Consent (Photo/Video) HL7v2 - ADT No historic backload

FHIR Features

  • BigQuery flattened materialized views of FHIR store migrated to Analytics V2 schema

Release 2023.08.15

FHIR Resources

  • None

FHIR Features

  • Changed HL7 Phillips Device Data Storage Bucket retention policy

Release 2023.08.01

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.22.3 Observation (Lab) HL7v2 - ADT No historic backload

FHIR Features

The following changes apply to the Observation-Lab resource:

  • Add "specimen.display" field
  • Add identifier resource-type system and coding
  • Add support for external labs
  • Change "Unknown" ORU lab code, display, and system to null
  • Change backup fields for display and system

Release 2023.07.18

FHIR Features

  • Changes to avoid duplicate AllergyIntolerance records and improve handling of deleted records
  • IAM updates to provide necessary access for non-LPR teams

Release 2023.07.11

FHIR Features

Notification of chart correction events (patient merge, patient unmerge, encounter contact move) now available.

Release 2023.05.26

Content

This is a release of Location, Medication, MedicationRequest, Organization, Practitioner, PractitionerIdentifier, PractitionerRole, Procedure, ValueSet BigQuery optimized tables and ServiceRequest views

Features

Version Resource Notes
1.0.0 Location Initial release of Location optimized table
1.0.0 Medication Initial release of Medication optimized table
1.0.0 MedicationRequest Initial release of MedicationRequest optimized table
1.0.0 Organization Initial release of Organization optimized table
1.0.0 Practitioner Initial release of Practitioner optimized table
1.0.0 PractitionerIdentifier Initial release of PractitionerIdentifier optimized table
1.0.0 PractitionerRole Initial release of PractitionerRole optimized table
1.0.0 Procedure Initial release of Procedure optimized table
1.0.0 ValueSet Initial release of ValueSet optimized table
1.0.0 ServiceRequest Initial release of ServiceRequest views

Known Limitations / Future Enhancements

Resource Notes
ServiceRequest Currently only views for ServiceRequest are available in production, and FHIR based tables are scheduled for future release

Release 2023.05.15

Content

This is a release of EncounterLocation, EncounterReasonCode, Endpoint, ImagingStudy, ImagingStudySeries, ImagingStudySeriesInstance BigQuery optimized tables.

Features

Version Resource Notes
1.0.0 EncounterLocation Initial release of EncounterLocation optimized table
1.0.0 EncounterReasonCode Initial release of EncounterReasonCode optimized table
1.0.0 Endpoint Initial release of Endpoint optimized table
1.0.0 ImagingStudy Initial release of ImagingStudy optimized table
1.0.0 ImagingStudySeries Initial release of ImagingStudySeries optimized table
1.0.0 ImagingStudySeriesInstance Initial release of ImagingStudySeriesInstance optimized table

Known Limitations / Future Enhancements

Resource Notes

Release 2023.04.21

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 ServiceRequest HL7v2 - ORM HL7v2 - ORM Enabling real-time processing
1.0.0 Diagnostic Report (Pat) HL7v2 - ORU HL7v2 - ORU Enabling real-time processing

FHIR Features

None

Known Bugs / Future Enhancements

Missing final message

There are a class of orders in Radiology that are procedural where there is no result and the order is resulted in EPIC but there is no updated HL7 message where ORC-2.1=final.

Only child order in HL7

There is a heirerarchical relationship with orders where only the child order is available in HL7, but all of the parent/child orders are stored in clarity, which makes it difficult to measure total mismatched orders in any category.

Release 2023.04.03

Content

This is a release of AllergyIntolerance, AllergyIntoleranceNote, AllergyIntoleranceReaction, CodeSystem, ConceptMap, Coverage BigQuery optimized tables.

Features

Version Resource Notes
1.0.0 AllergyIntolerance Initial release of AllergyIntolerance optimized table
1.0.0 AllergyIntoleranceNote Initial release of AllergyIntoleranceNote optimized table
1.0.0 AllergyIntoleranceReaction Initial release of AllergyIntoleranceReaction optimized table
1.0.0 CodeSystem Initial release of CodeSystem optimized table
1.0.0 ConceptMap Initial release of ConceptMap optimized table
1.0.0 Coverage Initial release of Coverage optimized table

Known Limitations / Future Enhancements

Resource Notes

Release 2023.03.27

Content

This is a release of Diagnostic Report BigQuery optimized tables.

Features

Version Resource Notes
1.0.0 Condition Initial release of Condition optimized table
1.0.0 Encounter Initial release of Encounter optimized table
1.0.0 Observation Initial release of Observation optimized table
1.0.0 Patient Initial release of Patient optimized table
1.0.0 DiagnosticReport Initial release of DiagnosticReport optimized table

Known Limitations / Future Enhancements

Resource Notes

Release 2023.03.10

Content

This is a release of Big Query optimized tables.

Features

Version Resource Notes
1.0.0 Condition Initial release of Condition optimized table
1.0.0 Encounter Initial release of Encounter optimized table
1.0.0 Observation Initial release of Observation optimized table
1.0.0 Patient Initial release of Patient optimized table

Known Limitations / Future Enhancements

Resource Notes

Release 2023.02.07

Content

This is a release of Big Query views for PractitionerIdentifier Resource.

Features

Version Resource Notes
1.0.0 PractitionerIdentifier Initial release of primary use and secondary use views
2.0.0 Practitioner Added provider_npi and provider_pn fields to current and secondary views

Known Limitations / Future Enhancements

Resource Notes
PractitionerIdentifier The PractitionerIdentifier unnests the PractionerIdentifier field.
Practitioner Practitioner Materialized view does not containing the provider_npi or provider_pn role.
Practitioner Practitioner Current and Secondary views do not currently support provider_pr or provider_esn

Release 2023.01.24

Content

This is a release of Big Query views for PractitionerRole Resource.

Features

Version Resource Notes
2.0.0 PractitionerRole The following fields have been removed:
  • location_type
  • location_identifier_system
  • location_identifier_value

Known Limitations / Future Enhancements

Resource Notes
PractitionerRole The PractitionerRole.location field contains information that cannot be mapped to the location view, as such this field needs to be removed.

Release 2022.12.20

Content

This is a release of Big Query views for AllergyIntoleranceNote, AllergyIntoleranceReaction, EncounterLocation and EncounterReasonCode.

Features

Version Resource Notes
2.0.0 ImagingStudy Patient_id field has been fixed and now populated with correct values. Additionally, the following fields have been added:
  • imaging_study_site_value_coding_code,
  • imaging_study_site_value_coding_display
  • imaging_study_site_value_coding_system
  • imaging_study_stmo_value_coding_system
1.0.0 AllergyIntoleranceNote Initial release of primary use and secondary use views
1.0.0 AllergyIntoleranceReaction Initial release of primary use and secondary use views
1.0.0 EncounterLocation Initial release of primary use and secondary use views
1.0.0 EncounterReasonCode Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Encounter ReasonCode: This attribute has been deprecated. Based on the FHIR definitions, for a given encounter, there may be many reason codes. As such a singular ReasonCode attribute will not satify the one to many relationship. In order to get the reason codes for a given encounter, the consumer should join to the EncounterReasonCode view to retrieve all reason codes for the encounter.
Encounter Location: This attribute has been deprecated. Based on the FHIR definitions, for a given encounter, there may be many reason codes. As such a singular Location attribute will not satify the one to many relationship. In order to get the locations for a given encounter, the consumer should join to the EncounterLocation view to retrieve all locations for the encounter.

Release 2022.10.28

Content

This is a release of Big Query views for ImagingStudy.

Features

Version Resource Notes
1.0.0 ImagingStudy Initial release of primary use and secondary use views
1.0.0 ImagingStudySeries Initial release of primary use and secondary use views
1.0.0 ImagingStudySeriesInstance Initial release of primary use and secondary use views
1.0.0 Endpoint Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Endpoint id - Contains duplicate records for the same id and last updated date.
ImagingStudy id - Contains duplicate records for the same id and last updated date.

Release 2022.10.04

Content

This is a release of Big Query views based on LPR FHIR data.

Features

Version Resource Notes
1.0.0 Coverage Initial release of primary use and secondary use views
1.0.0 Practitioner Role Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Coverage id - Contains duplicate records for the same id and last updated date.

Release 2022.09.19

Content

This is a release of Big Query views based on LPR FHIR data.

Features

Version Resource Notes
1.0.0 Allergy-Intolerance Initial release of primary use and secondary use views
1.0.0 Condition Initial release of primary use and secondary use views
1.0.0 Diagnostic-Report Initial release of primary use and secondary use views
1.0.0 Provenance Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Allergy-Intolerance id - Contains duplicate record for the same id and last updated date.
Diagnostic-Report id - Contains duplicate record for the same id and last updated date.

Release 2022.09.01

Content

This is a release of an update to the Observation view.

Features

Version Resource Notes
2.0.0 Observation Change column name from loic to loinc

Known Limitations / Future Enhancements

Resource Notes

Release 2022.08.23

Content

This is a release of Big Query views based on LPR FHIR data.

Features

Version Resource Notes
2.0.0 Patient Added home address fields
1.0.0 MedicationRequest Initial release of primary use and secondary use views
1.0.0 Medication Initial release of primary use and secondary use views
1.0.0 Observation Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Observation id - Contains duplicate record for the same id and last updated date.
note.text - Has been temporarily removed as some contain spaces and long texts.

Release 2022.07.12

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 AllergyIntolerance Epic Clarity HL7v2 - ADT Fix to support including RxNorm and/or Snomed coding

FHIR Features

None

Known Bugs / Future Enhancements

Release 2022.07.12

Private Preview

This is a private preview release for datasets and views within AIDE. The views and datasets will be available to users who have been provisioned with the right entitlements. Learn more about how to get access.

Features

Version Resource Notes
1.0.0 Patient Initial release of primary use and secondary use views
1.0.0 Practitioner Initial release of primary use and secondary use views
1.0.0 Encounter Initial release of primary use and secondary use views
1.0.0 Organization Initial release of primary use and secondary use views
1.0.0 Location Initial release of primary use and secondary use views
1.0.0 Procedure Initial release of primary use and secondary use views

Known Limitations / Future Enhancements

Resource Notes
Patient Contains duplicate records and some fields that should contain only one record, are repeated with different values. For example, a patient having more than one primary address or contact number. The problematic fields have been removed for now to guarantee only one record per patient. In the future releases, we will resolve these data inconsistencies and add the missing fields.
Encounter Contains duplicate records for the same enounter number. Also encounter data is repeated for different reasons (headache, dizziness, etc) an encounter takes place. For this release, we will only retrieve one reason code to eliminate duplicates. In the future releases, we will explore an alternate option to display all reasons without repeating remaining data fields.

Release 2022.06.28

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Medication Request HL7v2 - RDE,HL7v2-ORM HL7v2 - RDE,HL7v2-ORM

FHIR Features

None

Known Bugs / Future Enhancements

Medication codes are different for ORM and RDE. It's being worked on to map both of them to a common code like RxNorm

Map the medications to the Medication resource

Release 2022.06.23

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Procedure HL7v2 - SIU HL7v2 - SIU

FHIR Features

None

Known Bugs / Future Enhancements

Release 2022.06.21

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Coverage HL7v2 - ADT HL7v2 - ADT

FHIR Features

None

Known Bugs / Future Enhancements

Release 2022.06.14

FHIR Resources

Document Reference

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 DocumentReference HL7v2 - MDM HL7v2 - MDM Enabling real-time processing

FHIR Features

None

Known Bugs / Future Enhancements (Check Status of Bugs Here)

Large documents (greater than 8MB) are not supported

Release 2022.06.02

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Valueset Terms No real-time. Data is updated daily for changes from Terms
2.0.0 ConceptMap Terms No real-time. Data is updated daily for changes from Terms Updated the start date, end date and status fields
2.0.0 CodeSystem Terms No real-time. Data is updated daily for changes from Terms Updated the start date, end date and status fields

FHIR Features

None

Known Bugs / Future Enhancements

Large messages are being rejected in FHIR Store

Release 2022.05.17

FHIR Resources

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Condition HL7v2 - PPR HL7v2 - PPR

FHIR Features

None

Known Bugs / Future Enhancements

The sensitive diagnosis flag, that identifies problems as sensitive to be suppressed from the patient portal, is being slated for future development

Release 2022.05.26

FHIR Features

Release 2022.03.29

FHIR Resources

ConceptMap, CodeSystem

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 ConceptMap Terms No real-time. Data is updated daily for changes from Terms
1.0.0 CodeSystem Terms No real-time. Data is updated daily for changes from Terms

FHIR Features

None

Known Bugs / Future Enhancements

Large messages are being rejected in FHIR Store for Concept Maps and Code Systems

Release 2022.03.15

FHIR Resources

Location, Organization

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Location EPIC-Clarity No real-time. Data is updated daily for changes from Epic Clarity
1.0.0 Organization EPIC-Clarity No real-time. Data is updated daily for changes from Epic Clarity

FHIR Features

None

Known Bugs / Future Enhancements

Release 2022.03.09

FHIR Resources

Diagnostic Report (Labs), Observation (Labs)

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Diagnostic Report (Labs) HL7v2 - ORU HL7v2 - ORU Enabling real-time processing
1.0.0 Observation (Labs) HL7v2 - ORU HL7v2 - ORU Enabling real-time processing

FHIR Features

None

Known Bugs / Future Enhancements

DiagnosticReport (Lab), Observation (Lab)

Some DiagnosticReports and Observations not created for inbound real-time messages (less than 0.5%) due to the following bugs to be addressed in future releases:

  1. Bug 1365180 ORU Lab: Lab results not supported for HL7 with multiple OBX with same OBX-3.1 value (RESOLVED)
  2. Bug 1374839 ORU Lab: Result Cancellations not currently supported (RESOLVED)

Release 2022.02.22

FHIR Resources

DiagnosticReport (Radiology), DiagnosticReport (Labs), Observation (Labs)

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 DiagnosticReport (Radiology) HL7v2 - ORU HL7v2 - ORU
1.0.0 DiagnosticReport (Labs) HL7v2 - ORU HL7v2 - ORU Real-time not active; see below.
1.0.0 Observation (Labs) HL7v2 - ORU HL7v2 - ORU Real-time not active; see below.

FHIR Features

Feature Description Notes
Break the Glass (Encounter level) Security Labeling of Restricted Encounter records that data consumers must inspect and protect. Consumers of the LPR FHIR API must agree to inspect and protect Encounter data marked with this meta tag.

Known Bugs / Future Enhancements

DiagnosticReport (Radiology)
  1. DiagnosticReport (Radiology) content is based on the existing EAPIS STU3. However, it does not include practitioner pager numbers, because those changes do not trigger resending of the reports.
  2. DiagnosticReport/Observation (Labs) - There is a bug in the real-time processing of DiagnosticReport and Observation for Labs. A fix and live feed of Labs will be available in the next release. Right now there is Lab data from Epic Epoch through 2022-02-22.
Encounter (Break the Glass)
  1. Story 1339326 Sensitive encounter types are not currently receiving the meta.security tag during real-time processing.
  2. Story 1339503 AODA Department encounters are not currently receiving the meta.security tag during real-time processing.
  3. Bug 1335822 PR1 segment may be missing in some messages, causing the real-time to miss tagging based on AODA Visit Type criteria.

Special Note - Encounter security meta tag

For each Encounter FHIR resource that has been deemed sensitive (subject to the known issues described above), an element has been added to the meta.security attribute with the following values:

  • security.system: "http://terminology.hl7.org/CodeSystem/v3-Confidentiality"
  • security.code: "R"
  • security.display: "restricted"

For example, an encounter that has been deemed as sensitive would have a structure similar to the following:

{
  "resourceType": "Encounter",
  "id": "...",

  "meta": {
    "security": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-Confidentiality",
        "code": "R",
        "display": "restricted"
      }
    ]
  }
}

Release 2021.11.16

FHIR Resources

Medication, PractitionerRole

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Medication Epic Clarity No real-time. Data is updated daily for changes from Epic Clarity
1.0.0 PractitionerRole Epic Clarity No real-time. Data is updated daily for changes from Epic Clarity

FHIR Features

None

Known Bugs / Future Enhancements

General
  • Bug 1139614 - In rare occurrences (< 1%), internal errors may lead to outdated or missing data (RESOLVED)
  • Bug 1141214 Beam SDK Version needs to be updated to 2.34 (RESOLVED)
Medication
  • Bug 1137503 - Redundant display in text.div. Example: Medication 6040, display is copper copper (RESOLVED)

  • Bug 1142669 - Two missing Medications due to parsing bug (RESOLVED)

    • Med IDs 40840042 and 40801900242
PractitionerRole
  • Bug 1141018 - Incorrect System URIs (RESOLVED)
  • Bug 1142695 - Not US Core Compliant - Missing Standard ConceptMaps for Speciality and Code (REMOVED)

Release 1.0.0 - Initial Release

Please note this is the initial release of the Longitudinal Patient Record. The Longitudinal Patient Record is available for data consumers who have obtained authorization from MCC Executive Leadership. Read the release notes below for special notes on the data and functionality of this initial release.

This means:

  • 24/7 support is available for break/fix of severe production issues.
  • 8-5 CT weekday support is available for all other questions and issues.
  • Data structure (fields, case, etc) and history may change. Notice to consumers will be given.
  • Reporting Errors in operation (API calls) or Data are encouraged! However, bug resolution may be triaged without definite resolution dates.
  • Use of data should be specific to a business use case. GDPR and VIP data should be protected and used appropriately.

FHIR Resources

Organization, Patient, Encounter, AllergyIntolerance, Practitioner

Version FHIR Resource Historic Source Real-time Source Notes
1.0.0 Organization Static This is a static, single Org representation for Mayo Clinic.
1.0.0 Patient Epic Clarity HL7v2 - ADT
1.0.0 Encounter Epic Clarity HL7v2 - ADT
1.0.0 AllergyIntolerance Epic Clarity HL7v2 - ADT
1.0.0 Practitioner Epic Clarity HL7v2 - MFN

FHIR Features

Feature Description Notes
Data Resiliency Ability to maintain ingestion, consumption and restore data in the event of a disaster. See the LPR FHIR SLA - Recovery Time Objectives section.
Operational Alerting and Monitoring Ability to Alert and Monitor according to the LPR FHIR Service Level Agreement. See the LPR FHIR SLA.
GDPR (Patient level annotation) Security Labeling of Patients residing in GDPR countries. Consumers of the LPR FHIR API must agree to protect Patient data marked with this meta tag.
Break the Glass (Patient level annotation) Security Labeling of Restricted Patient records that data consumers must inspect and protect. Consumers of the LPR FHIR API must agree to inspect and protect Patient data marked with this meta tag.
Apigee API Proxy Management API Mediation of the LPR FHIR API through Apigee. This allows for uniform authentication and authorization to the LPR FHIR API.

See the section below for how to request access.

Special Note - Patient FYI meta tag

There is a lower percentage of patients that have more than one patient confidential flag set in Epic and are being triggered from real time EPIC ADT HL7 outbound with both confidential flag display values in NTE segments. In those scenarios, the patient FHIR resource meta.security tag display and code is being set to one of the values from NTEs and the system is being always set to "http://terms.mayo.edu/mccfhir/systemid/epic/patient_confidential"

For example: There are the cases of 2 NTEs coming out of single EPIC ADT message for a patient that has values like

NTE|1||Confidential-Medium|...
NTE|2||Confidential PSN|...

Based on NTE confidential messages sequence order, Patient FHIR resource meta.security[x].system is being set as either:

[{"system":"http://terms.mayo.edu/mccfhir/systemid/epic/patient_confidential","code":Confidential PSN","display":"Confidential PSN"}]

OR

[{"system":"http://terms.mayo.edu/mccfhir/systemid/epic/patient_confidential","code":Confidential PSN","display":"Confidential-Medium"}]

However the functionality of setting Patient confidential meta security tag is not getting affected and patient confidential BTG process should always check if the patient has meta.security[x] has the system = "http://terms.mayo.edu/mccfhir/systemid/epic/patient_confidential"

Known Bugs / Future Enhancements

AllergyIntolerance
  1. Bug 1504020 & Bug 1231121 AllergyIntolerance resource unsuitable for patient care related activities which rely upon RxNorm or Snomed coding to be present. Current version of resource does not support these mappings, but future versions will. (Resolved in Release 2022.07.12)
Patient
  1. Story 1097238 Patient.contact[] may contain objects without a name or use. In these cases the contact is typically an employer or self. (RESOLVED)