# Record Merging Provider `IRecordMergingService` in assembly SanteDB.Core.Api version 3.0.1980.0 ## Summary Record merging service ## Operations | Operation | Response/Return | Input/Parameter | Description | | --------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- | | GetMergeCandidateKeys | IEnumerable\ | *Guid* **masterKey** | Gets the duplicates for the specified master record | | GetMergeCandidates | IQueryResultSet\ | *Guid* **masterKey** | Get merge candidate keys | | GetGlobalMergeCandidates | IQueryResultSet\ | *none* | TODO | | GetIgnoredKeys | IEnumerable\ | *Guid* **masterKey** | Gets the ignore list for the specified master record | | GetIgnored | IQueryResultSet\ | *Guid* **masterKey** | Gets the ignore list for the specified master record | | Ignore | IdentifiedData |

Guid masterKey
IEnumerable\ falsePositives

| Indicates that the engine should ignore the specified false positives | | UnIgnore | IdentifiedData |

Guid masterKey
IEnumerable\ ignoredKeys

| Indicates that an ignored record should be removed from the ignore list | | Merge | RecordMergeResult |

Guid masterKey
IEnumerable\ linkedDuplicates

| Merges the specified into | | Unmerge | RecordMergeResult |

Guid masterKey
Guid unmergeDuplicateKey

| Un-merges the specified from | | DetectGlobalMergeCandidates | void | *none* | TODO | | ClearGlobalMergeCanadidates | void | *none* | TODO | | ClearGlobalIgnoreFlags | void | *none* | TODO | | ClearMergeCandidates | void | *Guid* **masterKey** | Clear all merge candidates | | ClearIgnoreFlags | void | *Guid* **masterKey** | Clear ignored flags | | DetectMergeCandidates | void | *Guid* **masterKey** | Perform the necessary operations to detect merge candidates for | | Reset | void |

Guid masterKey
Boolean includeVerified
Boolean linksOnly

| Reset the specified merge service data on the specified record | | Reset | void |

Boolean includeVerified
Boolean linksOnly

| Reset the specified merge service data on the specified record | ## Implementations ### SimResourceInterceptor\ - (SanteDB.Core.Api) Single Instance Mode Handler #### Description This class binds to startup and enables the listening and merging of records based on the record matcher {% hint style="info" %} This service implementation is abstract or is a generic definition. It is intended to be implemented or constructed at runtime from other services and cannot be used directly {% endhint %} ### MdmEntityMerger\ - (SanteDB.Persistence.MDM) An MDM merger that operates on Entities #### Description This class exists to allow callers to interact with the operations in the underlying infrastructure. {% hint style="info" %} This service implementation is abstract or is a generic definition. It is intended to be implemented or constructed at runtime from other services and cannot be used directly {% endhint %} ### MdmResourceMerger\ - (SanteDB.Persistence.MDM) An implementation of a IRecordMergeService for an MDM controlled resource {% hint style="info" %} This service implementation is abstract or is a generic definition. It is intended to be implemented or constructed at runtime from other services and cannot be used directly {% endhint %} \# Example Implementation \`\`\`csharp /// Example Implementation using SanteDB.Core.Services; /// Other usings here public class MyRecordMergingService : SanteDB.Core.Services.IRecordMergingService { public String ServiceName => "My own IRecordMergingService service"; ////// Gets the duplicates for the specified master record ///public IEnumerable GetMergeCandidateKeys(Guid masterKey){ throw new System.NotImplementedException(); } ////// Get merge candidate keys ///public IQueryResultSet GetMergeCandidates(Guid masterKey){ throw new System.NotImplementedException(); } public IQueryResultSet GetGlobalMergeCandidates(){ throw new System.NotImplementedException(); } ////// Gets the ignore list for the specified master record ///public IEnumerable GetIgnoredKeys(Guid masterKey){ throw new System.NotImplementedException(); } ////// Gets the ignore list for the specified master record ///public IQueryResultSet GetIgnored(Guid masterKey){ throw new System.NotImplementedException(); } ////// Indicates that the engine should ignore the specified false positives ///public IdentifiedData Ignore(Guid masterKey,IEnumerable falsePositives){ throw new System.NotImplementedException(); } ////// Indicates that an ignored record should be removed from the ignore list ///public IdentifiedData UnIgnore(Guid masterKey,IEnumerable ignoredKeys){ throw new System.NotImplementedException(); } ////// Merges the specified into ///public RecordMergeResult Merge(Guid masterKey,IEnumerable linkedDuplicates){ throw new System.NotImplementedException(); } ////// Un-merges the specified from ///public RecordMergeResult Unmerge(Guid masterKey,Guid unmergeDuplicateKey){ throw new System.NotImplementedException(); } public void DetectGlobalMergeCandidates(){ throw new System.NotImplementedException(); } public void ClearGlobalMergeCanadidates(){ throw new System.NotImplementedException(); } public void ClearGlobalIgnoreFlags(){ throw new System.NotImplementedException(); } ////// Clear all merge candidates ///public void ClearMergeCandidates(Guid masterKey){ throw new System.NotImplementedException(); } ////// Clear ignored flags ///public void ClearIgnoreFlags(Guid masterKey){ throw new System.NotImplementedException(); } ////// Perform the necessary operations to detect merge candidates for ///public void DetectMergeCandidates(Guid masterKey){ throw new System.NotImplementedException(); } ////// Reset the specified merge service data on the specified record ///public void Reset(Guid masterKey,Boolean includeVerified,Boolean linksOnly){ throw new System.NotImplementedException(); } ////// Reset the specified merge service data on the specified record ///public void Reset(Boolean includeVerified,Boolean linksOnly){ throw new System.NotImplementedException(); } } \`\`\` ## References * [IRecordMergingService C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Services_IRecordMergingService.htm) * [SimResourceInterceptor\ C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Core_Data_Management_SimResourceInterceptor_1.htm) * [MdmEntityMerger\ C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Persistence_MDM_Services_Resources_MdmEntityMerger_1.htm) * [MdmResourceMerger\ C# Documentation](http://santesuite.org/assets/doc/net/html/T_SanteDB_Persistence_MDM_Services_Resources_MdmResourceMerger_1.htm) --- # 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/developers/server-plugins/implementing-.net-features/service-definitions/record-merging-provider.md?ask= ``` 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.