Configuring the Match Engine

You can configure the match engine by specifying the match engine to use and configuring the predefined comparison functions. You can also plug in custom standardization and matching rules. You only need to specify the match engine to use if you are using an engine other than the Master Index Match Engine.

Perform any of these steps to configure the match engine:

• Specifying a Match Engine for the Master Index

• Configuring the Comparison Functions for a Master Index Application

• Importing Custom Comparison Functions

• Deleting a Custom Comparison Function

Specifying a Match Engine for the Master Index

Oracle Java CAPS Master Index can support different match engines depending on the adapter configured to communicate with the engine. Default classes are provided for using the Master Index Match Engine. You can implement a custom match engine along with custom adapters. The match engine configuration is defined by the matcher-api and matcher-config elements.

To Configure the Match Engine

1. In the Projects window, expand the Configuration node in the project you want to modify, and then double-click mefa.xml.

   The file opens in the NetBeans XML editor.

2. Scroll to the matcher-api element in the MatchingConfig section.
3. Specify the Java class for the matching adapter to use, using the fully qualified class name as shown below.

   <matcher-api>
      <class-name>com.sun.mdm.index.matching.adapter.SbmeMatcherAdapter
      </class-name>
   </matcher-api>

4. In the matcher-config element, specify the Java class for the configuration of the matching adapter, using the fully qualified class name as shown below.

   <matcher-config>
      <class-name>
       com.sun.mdm.index.matching.adapter.SbmeMatcherAdapterConfig
      </class-name>
   </matcher-config>

5. Save and close the file.

Configuring the Comparison Functions for a Master Index Application

The match configuration file in the Match Engine node of the master index project lists and defines the configuration for each match type based on the predefined comparison function for the Master Index Match Engine. These match types can be applied to each field in the match string. You can modify the configuration of the existing matches types, add new match types, and specify whether the match engine should use agreement and disagreement weights or m-probabilities and u-probabilities.

For more information about the structure of the match configuration file and the comparison functions you can use, see Oracle Java CAPS Master Index Match Engine Reference.

To Configure the Comparison Functions (Configuration Editor)

1. In the Projects window, right-click the Configuration node in the project you want to modify, and then click Edit.

   The Configuration Editor appears.

2. Click the Matching tab.

   The Matching page appears with a list of fields defined for matching and a list of comparators that you can modify.

3. In the Probability Type field, select one of the following:

   • Use Agree/Disagreement Weight Ranges – Uses agreement and disagreement weights for matching. If agreement and disagreement weights are used, the m-probability and u-probability fields are ignored and do not appear on the Matching page.

   • Use M-Probabilities/U-Probabilities – Uses m-probabilities and u-probabilities for matching. If m-probabilities and u-probabilities are used, the agreement and disagreement weight fields are ignored and do not appear on the page.

4. To add a new matching rule:
   1. Click Add in the lower right portion of the window.

      The Edit Matching Rules dialog box appears.

   2. Fill in the fields described in Match Comparator Configuration Properties for Oracle Java CAPS Master Index.
   3. Click OK.
5. To edit an existing matching rule:
   1. Click Edit in the lower right portion of the window.

      The Edit Matching Rules dialog box appears.

   2. Change the value of any of the fields described in Match Comparator Configuration Properties for Oracle Java CAPS Master Index.
   3. Click OK.
6. To remove an existing matching rule:
   1. In the matching rule table, select the rule you want to delete.
   2. Click Remove.
7. On the Configuration Editor toolbar, click Save.

To Configure the Comparison Functions (Text Editor)

1. In the project window, expand the master index project, and then expand the master index application.
2. In the Match Engine folder, double-click matchConfigFile.cfg.
3. For the Probability Type, enter one of the following values:

   • 0 – Uses m-probabilities and u-probabilities for matching. If m-probabilities and u-probabilities are used, the agreement and disagreement weight fields are ignored.

   • 1 – Uses agreement and disagreement weights for matching. If agreement and disagreement weights are used, the m-probability and u-probability fields are ignored.

4. For each comparison function you want to configure, modify the value of any of the columns described in Match Comparator Configuration Properties for Oracle Java CAPS Master Index.
5. Save and close the file.

Match Comparator Configuration Properties for Oracle Java CAPS Master Index

The following table lists and describes the Configuration Editor fields used to define the comparison functions. It also lists the corresponding column in the match configuration file if you want to modify the file directly.

Importing Custom Comparison Functions

The Master Index Match Engine is based on a very flexible framework that allows you to define new algorithms in the form of comparison functions that compare field values between two records. You need to import the comparison function into NetBeans to make it available to all master index applications or only the current application.

This section only describes importing custom comparison functions after they have been created. For information about creating a custom comparison function, see Creating Custom Comparators for the Master Index Match Engine, in Understanding the Master Index Match Engine

To Import a Comparison Function

1. In the Projects window, expand the main master index project.
2. Right-click Match Engine, and select Import Comparator Plug-in.
3. In the dialog box that appears, navigate to the location of the plug-in ZIP file.
4. Select the file containing the plug-in, and then click Open.
5. Do one of the following:
   • To import the plug-in and make it available to all future master index application, click Yes.
   • To import the plug-in and make it only available to the current master index application, click No.

   The contents of the ZIP file are imported into the Match Engine node and the new comparators are added to the list of comparator definitions in comparatorsList.xml.

6. In the Match Engine node, navigate to the /lib folder that was added and verify that all of the required files are there.
7. Open comparatorsList.xml and verify the new comparator definitions are included.

Deleting a Custom Comparison Function

If you add a custom comparison function to a master index application in error, you can remove it from the Match Engine node. Optionally, you can simply make the comparison function unavailable by removing it from the comparators list in comparatorsList.xml.

To Delete a Custom Comparison Function

1. Back up the source files for the function in case you need them at a later time.
2. In the Project window, navigate to the Match Engine node in the master index project and then to the /lib folder.
3. Right-click the folder containing the files to remove, and then select Delete.

   A confirmation dialog appears.

4. Click Yes.

   The source files are removed from the project.

5. Open comparatorsList.xml and remove the comparator definitions from the list.
6. Save and close the file.