61.5.1Enable Data Blend

To enable Data Blend, the following configurations must be completed:

61.5.2Create the MDM Rule Definition Script

Create the script that will be referenced in the MDM module configuration (classpath:mdm/mdm-rules.json). This script defines how patient records should be linked across sources.

{
  "version": "1",
  "mdmTypes": [
    "Patient"
  ],
  "eidSystems": {
    "Patient": "http://example.org/eid-system-patient"
  }
}

• File path: classpath:mdm/mdm-rules.json
• Purpose: Defines matching logic for patient records and identifies the EID system used to link related records.

61.5.3Register the Interceptor

Register the interceptor that will be referenced in the Persistence module configuration (com.smilecdr.custom.auto.mdm.export.CustomAutoMdmExportInterceptor). This interceptor is required for Data Blend functionality. It automatically injects the mdm=true parameter into data export requests, ensuring related patient records are included.

To register the interceptor:

1. Work with Smile’s implementation team to obtain the JAR file that contains the com.smilecdr.custom.auto.mdm.export.CustomAutoMdmExportInterceptor class.
2. Place the JAR file in the smilecdr/customerlib folder on the Smile CDR server.

For more details, see the official Smile documentation:
Registering an Interceptor

61.5.4Configure the FHIR Storage Module

Note: This persistence configuration is for the repository where data from source systems are stored.

On the FHIR Storage (R4 RDBMS) module (add it if it does not already exist, or update the existing module), configure the following properties:

1. Under FHIR MDM Server, configure the following properties:
   • MDM Mode Enabled: toggle to Yes
   • Search Expanding Interceptor Enabled: toggle to Yes 2. Under FHIR Subscription Persistence:
   • Message Subscription Enabled: toggle to Yes 3. Under FHIR Interceptors:
   • Interceptor Bean Types: set to com.smilecdr.custom.auto.mdm.export.CustomAutoMdmExportInterceptor
2. Under FHIR Performance:
   • Index Missing Search Params: select ENABLED 5. Save and start (or restart) the module as needed.

61.5.5Configure the Subscription Matcher Module

On the Subscription Matcher module (add it if it does not already exist), configure the following properties:

1. Under Dependencies
   • FHIR Storage Module: select the previously configured FHIR Storage module.
2. Save and start the module.

61.5.6Configure the MDM Module

1. Add the Module:
   • Select MDM from the available options and click Add.
   • Assign a descriptive Module Name to identify it in the console.
2. Under MDM, configure the following properties:
   • MDM Rule Definition Script (File): classpath:mdm/mdm-rules.json
   • MDM Mode: MATCH_ONLY
3. Under Dependencies
   • Subscription Matcher: select the previously configured Subscription Matcher module.
4. Save and start the module.