# Master Data Management Tab

The **Master Data Management** tab is used to control the links controlled by the [Master Data Storage](/santedb/data-and-information-architecture/data-storage-patterns/master-data-storage.md) plugin in SanteDB.&#x20;

{% hint style="info" %}
The Master Data Management tab will not appear when:

* The user does not have the appropriate MDM policy permissions
* The record being viewed is not under MDM control
* The MDM plugin is not enabled on the iCDR server
  {% endhint %}

![](/files/4EF4Nah13gRJqcUmpYS4)

## Local Records

The local records panel shows the currently attached/established local or source records for the current master view (including the record of truth). These records are those which have been sent by a patient identity source (see: [Master Data Storage](/santedb/data-and-information-architecture/data-storage-patterns/master-data-storage.md#mdm-data-storage-pattern)). These are source records which are used to derive the master record (if no record of truth is established).

![](/files/Yd2BoPEaTluWMBsc9vKb)

### Link Classification

The MDM layer captures the type of classification of link between the source record and its master. The types of classifications which are listed are:

| Classification | Description                                                                                                                                                                                                                         | Creation                                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| System         | <p>The system classification indicates that the link was performed because the MDM plugin has established this link. <br>System links are never modified by the MDM layer unless needed to perform an unlink or link operation.</p> | <ul><li>New source record is registered with no definite master</li><li>Source is detached/unlinked from old master.</li></ul>                                     |
| Verified       | The link has been reviewed by a human and established for the source and master. The link is never modified by the MDM layer (they are sticky)                                                                                      | <ul><li>Administrator has resolved a candidate link.</li></ul>                                                                                                     |
| Auto           | The link has been established using an automatic merge rule in the match configuration or via unique identity domain.                                                                                                               | <ul><li>Patient with the same identifier in an identity domain listed as Unique</li><li>Match configuration with <code>$mdm.auto-link</code> set to true</li></ul> |

### Un-Linking

When a source record is unlinked from the master, the MDM layer will perform its unlinking logic.&#x20;

1. The relationship between the source and the current master is removed
2. A new master link for the unlinked source is created (with classification system)
3. An ignore instruction is added for the unlinked record and the old master (so they are not re-matched)
4. The re-match process is invoked

## Candidate Records

The candidates panel shows the identified [Master Data Storage](/santedb/data-and-information-architecture/data-storage-patterns/master-data-storage.md#candidate-links) for the current master record.&#x20;

![](/files/nbDvgiOcddmH03B6I80A)

To resolve a candidate link:

1. View the details of the match to see the attributes in each record which were considered for matching.
2. If needed click on the **View** button to see details about the candidates.
3. Make a determination about the candidate pair:
   1. If the candidate is a match (they represent the same person) click the **Resolve** button to link the two&#x20;
   2. If the candidate is not a match (they represent different people) click the **Ignore** button&#x20;

### Match Details

Click on the candidate details button will open a popup window which illustrates the individual attribute values in both the current master and the candidate. This allows administrators to determine the reason why the two records are considered candidates for linking.

![](/files/dGxKyGh1DwXyLKFobgRW)

## Ignored Candidates

The ignored candidates panel shows the list of candidate (source) records for the current master which are considered definite non-matches (and should be ignored for future matching).

![](/files/IJRbfDyuk3rdzPfNhN94)

Like the candidates view, it is possible to perform gather an updated match report by clicking on **Details**. Users may also un-ignore the record if they feel the ignored (non-match) candidate may be a candidate for matching the master.

{% hint style="info" %}
If the source system (that which sent the data to the SanteMPI instance) updates their own information about the source record, then the data will be reflected in the ignored candidates row. It is possible that newer versions of the ignored patient may result in a previously ignored candidate becoming a match candidate (however due to the ignore statement they are excluded from the matching).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.santesuite.org/user-guides-and-training/santempi/the-patient-dashboard/master-data-management-tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
