Configure attribute maps

The data integration toolkit ships default maps built to conform to the HL7 FHIR specification. However, both entity and attribute maps are deployed as Dataverse records, and are highly configurable to accommodate your various solution requirements.

To learn more about attribute maps, go to Overview of attribute maps.

Attribute map fields

Attribute maps provide the FHIR node to Dataverse field level mapping. They need to account for various different data types.

FHIR element map

The entity attribute mapping definitions on Dataverse contain a FHIR Element Map field. This field defines how to retrieve and send values between Azure Health Data Services FHIR service and FHIR enabled endpoints.

These mapping definitions are contained in a serialized JSON object with entries to support JSONPath selection to retrieve and update existing property values. It also includes definitions to insert new property values that don't already exist in the receiving platform.

JSON object definition

{
    "s": "",
    "c": { 
            "p": "",
            "a": [
                   ""
                 ]
}

Where

• "s" = A valid JSONPath expression used to select an existing JSON property of the FHIR resource to extract or set values from and to Dataverse.
• "c" = JSON property fields used to insert or create JSON properties when the selected path is nonexistent in the resource JSON object.
• "p" = The parent JSON property name to create.
• "a" = Array of attributes to set on the selected JSON property.

For more details and examples of attribute map configuration, go to Attribute map examples.

Used in record matching

Child arrays in FHIR JSON messages don't contain unique identifiers like root level FHIR resources. Because of this characteristic, the Dataverse healthcare APIs, writeback process, and virtual health data tables require other criteria to ensure that the correct values are created and updated. The Used in Record Matching field allows you to identify which expansion map attribute should be used to signal uniqueness. This field is important for expansion maps and for maintaining data integrity when updating Dataverse records.

To have the Used in Record Matching value set to True, you must have at least one attribute map for an expansion entity map. If more than one attribute map has this field marked as True, the combined list of attribute maps together provide a composite key when creating and updating new expansion level records.

Manage attribute map records

The following sections list some common steps for configuring and managing attribute maps. For detailed examples, go to Attribute map examples.

Add an attribute map to an entity map

1. Open the entity map.

2. On the General tab under Related Attribute Maps, select + New Update Service Attribute Map.

Disable an attribute map

If you don't need an attribute map for an entity included with the default data integration toolkit maps, you can disable it. For example, you might not need to sync and store the on behalf of attribute in the EMR system for the encounter entity.

1. Under Map Setup, select Attribute Maps.

2. Select the msemr_encounter entity, and then select Edit.

3. In Related Attribute Maps, select msemr_onbehalfof, and then select Edit.

4. Set the value of the field Disabled to Yes.

   

5. Select Save.

Archive an attribute map

You can disable any attribute map. But, it would still appear in the Active Update Service Attribute Maps view. To remove an attribute map from this view, you can archive the attribute map.

1. Open the entity map.

2. On the General tab, under Related Attribute Maps, select the attribute map.

3. In the Active Update Service Attribute Maps view header, select Archive.

View archived attribute maps

1. Open the entity map.

2. On the General tab, under Related Attribute Maps, select Active Update Service Attribute Maps, and then select Archived Update Service Attribute Maps.

Create a service attribute map

The Contact entity in Dataverse is mapped to the Patient resource in Azure FHIR. Here's how you can add attribute maps to this entity map:

1. Under Map Setup, select Entity Maps.

2. In the list of entities, select the Contact entity mapped to the FHIR resource Patient, and then select Edit.

3. In Related Attribute Maps, select + New Update Service Attribute Map.

4. Set the value of FHIR Required Attribute to No.

   This setting indicates how data flows back to the configured FHIR endpoint. When a change occurs in Dataverse for this patient and the FHIR Required Attribute is set to Yes, you must populate the attribute. If you don't populate the attribute, the change is saved to Dataverse but wouldn't be posted to the FHIR endpoint. The event is written to the logs.

5. For Attribute Name, select First Name (firstname).

6. For Action Type, select Copy Data. This value means that the string data on one system copies to the other system.

7. For FHIR Element Map, add the JSON search string that works with the FHIR API. For example, you might add a JSON search string that allows you to get to the FHIR element, which is the first name.

   

8. Select Save. The Value Maps section is now displayed on the same window with the + New Attribute Value Map option. The Contact entity doesn't require a value map because it's a string.

9. In the entity map for Contact, under Related Attribute Maps, you can now view the attribute map with the name firstname.

Related information

• Overview of data integration toolkit
• Manage FHIR data using data integration toolkit
• Data integration toolkit maps: Examples and use cases