Configuring Sun Master Indexes

Defining the Master Index Single Best Record Structure

In order for a field to be populated in the SBR, that field must be defined in the candidate field list of the survivor helper. By default, all the fields that were specified in the wizard are also defined here. Any candidate fields defined for the SBR must also be defined in object.xml. If you add a field to the object definition, you should also add the field here.

The SBR can only be defined by modifying the XML file directly.

ProcedureTo Specify a Candidate Field

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

    The file opens in the NetBeans XML editor.

  2. Scroll to the candidate-definitions element in the SurvivorHelperConfig element.

  3. Do any of the following:

    • To add a new field, add a new candidate-field element within the candidate-definitions tags, and then name the new element using the ePath of the field.

      For example:


         <candidate-definitions>
            <candidate-field name="Person.LastName"/>
            <candidate-field name="Person.DateOfBirth"/>
         <candidate-definitions>
    • To modify an existing field, scroll to the candidate-field element you want to modify, and then change the value of the attribute.

    • If any of the updated fields do not use the default strategy, define a strategy for those fields, as described in Defining a Master Index Survivor Strategy for a Field or Object.

  4. Save and close the file.

  5. To define or modify exclusion lists of values to be excluded from the SBR, see Filtering Default Values From Master Index Processes

Deleting Candidate Fields

Once a field is defined in the SBR candidate field list, you can delete the field if you do not want to include the field in the SBR. If you delete a field from the object definition, make sure to delete the field here as well.

ProcedureTo Delete a Candidate Field

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

    The file opens in the NetBeans XML editor.

  2. Scroll to the candidate-definitions element in the SurvivorHelperConfig element.

  3. Delete all text between and including the appropriate candidate-field element.

    Using the example below, to delete the Religion field, delete the boldface text; to delete the Alias object, delete the plain text.


    <candidate-field name="Person.Religion"/>
    <candidate-field name="Person.Alias[*].*"/>
       <system-fields>
          <field-name>LastModified</field-name>
       </system-fields>
       <survivor-strategy>
          <strategy-class>com.sun.mdm.index.user.MyStrategy
          </strategy-class>
       </survivor-strategy>
    </candidate-field>

    Note –

    Do not delete all candidate fields; at a minimum, the match fields must be defined.


  4. Save and close the file.