The Master Controller defines how transactions are processed, and is configured in the Threshold file. You can specify Java classes that insert additional logic into the match process, configure the blocking query to use for matching, define how merged record updates are handled, and specify whether a record’s potential duplicates are reevaluated after it is updated. You can customize the Master Controller by performing any of the following actions.
The logic-class element specifies custom match processing logic for messages coming from external systems. The and logic-class-gui element specifies custom match processing logic for the EDM. If no custom plug-ins were created to define the custom logic, leave these elements empty. Custom logic classes can only be specified by modifying the XML file directly.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the logic-class element to the name of the custom plug-in that contains the back-end logic.
For example:
<logic-class>com.stc.eindex.user.CustomProcessing</logic-class> |
Save and close the file.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the logic-class-gui element to the name of the custom plug-in that contains the EDM logic.
For example:
<logic-class-gui>com.stc.eindex.user.CustomEDM</logic-class-gui> |
Save and close the file.
The update-mode element specifies whether potential duplicates are reevaluated for a record each time the record is updated. If you specify that potential duplicates are reevaluated, the reevaluation only occurs when updates are made to fields involved in blocking and matching. The update mode can only be specified by modifying the XML file directly.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the update-mode element to Pessimistic.
For example:
<update-mode>Pessimistic</update-mode> |
Save and close the file.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the update-mode element to Optimistic.
For example:
<update-mode>Optimistic</update-mode> |
Save and close the file.
The merged-record-update element allows you to define whether updates can be made to records with a status of Merged.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the merged-record-update element to Enabled.
For example:
<merged-record-update>Enabled</merged-record-update> |
Save and close the file.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
In the MasterControllerConfig element, change the value of the merged-record-update element to Disabled.
For example:
<merged-record-update>Disabled</merged-record-update> |
Save and close the file.
You need to specify the query that will be used by the master index application to retrieve a candidate selection pool of records that closely match an incoming record and that will be used for probabilistic weighting. The name of the blocking query you specify here must match the name of one of the blocking queries defined in the Candidate Select file. You can only specify one blocking query for matching in the master index application.
Modifying the blocking query once your system is in production is not recommended because it can cause issues with data integrity.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
Scroll to the execute-match element in the MasterControllerConfig element.
Modify the value of the query-builder name to the name of the blocking query you want to use. For example:
<execute-match> <query-builder name="MY-BLOCKER"> <option key="key" value="value"/> </query-builder> </execute-match> |
Make sure the name you specify exactly matches the name of one of the blocking queries defined in the Candidate Select file.
Set the blocking query options, as described in Setting Master Index Blocking Query Options (Repository).
Save and close the file.
Key and value pairs are designed to fine-tune the operation of custom blocking queries. In the default blocking queries defined in the Candidate Select file, key and value pairs are not used. However, if you create a custom blocking query, you can configure the query to use key and value pairs. The key describes the option, and the value specifies the value of the option.
In the Projects window, expand the Configuration node in the project you want to modify, and then double-click the Threshold file.
Scroll to the execute-match element.
To specify a key and value pair, modify the values of the key and value attributes in the option element.
For example:
<option key="wildcard" value="true"/> |
Save and close the file.