HealthRecordCommunity
FHIR🌏 International🏛 Microsoft LearnEnriched

How to Configure Expansion Maps for FHIR Data Integration

Configure expansion maps | Microsoft Learn

November 20, 2025Microsoft Learn

Summary

This article explains how to configure 'expansion maps' used to transform hierarchical JSON data into Dataverse's relational model. This allows complex JSON attributes to be mapped to multiple, related Dataverse attributes.

Details

Expansion maps are crucial in FHIR data integration, enabling the mapping of complex JSON-based hierarchical data into Dataverse’s relational data model. They allow administrators to map complex JSON attributes to multiple, related Dataverse attributes. Key functionalities include specifying parent link attributes to define relationships between parent and child records. For instance, using expansion maps for the Patient entity can bring patient identifiers and various links into Dataverse. The data integration toolkit includes pre-built maps for Medical Identifier, Patient Link, Care Team Participant Role, and Appointment slots. These default maps are based on the FHIR specification, making it critical not to alter the 'FHIR Element Map' value to prevent adverse effects on data synchronization. Configuration involves adding a new attribute map within an entity map, setting the Action Type to 'Expand', and defining the lookup relationship (expansion entity map). This process facilitates the comprehensive integration of complex medical information structures into Dataverse.

📰
Read Original Article
learn.microsoft.com

Original content copyright by respective publishers