Master Index Match Processing Logic Plug-ins

You can implement custom plug-ins that customize the way the execute match methods process data into the master index application. When a record is entered into the master index system, match processing is performed by calling one of the following “execute match” functions from the MasterController class.

• executeMatch

• executeMatchUpdate

• executeMatchDupRecalc

• executeMatchUpdateDupRecalc

• executeMatchGui (this method is only called by the MIDM)

These methods contain standard logic for processing records through the master index database, weighting incoming records against existing records, and then using those weights to determine whether to insert a new record or update an existing record. In addition to configuring the match processing logic in master.xml, you can customize certain aspects of the processing logic using custom plug-ins that contain functions found in the ExecuteMatchLogics class.

Custom Match Processing Logic Methods

There are five decision branches where custom logic can be inserted. At specific points in match processing, the execute match methods look for the value of the methods listed below. For more information about the methods, see the Javadocs for the master index. These methods are contained in the ExecuteMatchLogics class in the package com.sun.mdm.index.master. For information about where the decision points are reached in the processing logic and how to change the logic, see Understanding Sun Master Index Processing . The following methods specify the custom logic.

• bypassMatching - Indicates whether to perform the match process on incoming records or to bypass the match process.

• disallowAdd - Indicates whether an incoming message can be inserted as a new record.

• disallowUpdate - Indicates whether an incoming record can update an existing record.

• rejectAssumedMatch - Indicates whether to accept or reject an assumed match of two records.

• rejectUpdate - Indicates whether to accept or reject an update to an existing record.

Custom Match Processing Logic Plug-in Requirements

The custom plug-ins you create to define custom execute match logic must extend the ExecuteMatchLogics class. In addition, the following classes must be imported into the custom plug-in.

• com.sun.mdm.index.objects.SystemObject

• com.sun.mdm.index.objects.EnterpriseObject

• com.sun.mdm.index.objects.exception.ObjectException

• com.sun.mdm.index.master.ExecuteMatchLogics

• com.sun.mdm.index.master.CustomizationException

Custom Match Processing Configuration

If you create a custom plug-in that defines custom processing logic for the execute match methods, you must specify those custom plug-ins in master.xml in the master index project. If you create a plug-in for customizing logic in the execute match methods used by the back-end, specify the name of that class in the logic-class element. If you create a plug-in for the MIDM, specify the name of that class in the logic-class-gui element. For example:

<logic-class>com.sun.mdm.index.user.CustomCollaboration</logic-class>
<logic-class-gui>com.sun.mdm.index.user.CustomMIDM</logic-class-gui>

For more information about master.xml, see Understanding Sun Master Index Configuration Options .