Configuring Sun Master Indexes (Repository)

Modifying the Master Index Match String (Repository)

Once you define a match string, you can modify or delete information about the fields in the match string as necessary. This should only be done prior to moving to production. Otherwise, unexpected matching results might occur. For more information about Sun Match Engine match types and field IDs, see Understanding the Sun Match Engine.

ProcedureTo Modify the Match String (Configuration Editor)

  1. In the Projects window, right-click the master index application you want to modify, and then click Open.

  2. If the Configuration Editor dialog box appears, click Edit to check out the listed files.

    The Configuration Editor appears.

  3. Expand the object structure so all fields are visible.

  4. To add a field to the match string, click the field name and then select a value for the Match Type field on the Properties page.

    The field is added to the match string.

  5. To modify the match type specified for a field, click the name of the field defined for matching and then select a new value for the Match Type field on the Properties page.

  6. To remove a field from the match string, click the name of the field defined for matching and then select None for the Match Type field on the Properties page.

  7. On the Configuration Editor toolbar, click Save.

ProcedureTo Modify the Match String (XML Editor)

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

    The file opens in the NetBeans XML editor.

  2. Scroll to the MatchingConfig element, and then scroll to the match-system-object element.

  3. To add a field to the match string, do the following:

    1. In the match-columns element, create a new match-column element.

    2. In the new match-column element, create and define a column-name element.

      Enter the fully qualified field name of the field on which to match (for example, Enterprise.SystemSBR.Person.Address.City).

    3. Following the column-name element, create and define a match-type element.

      Enter an ID that identifies the field to the match engine. For the Sun Match Engine, this value must correspond to a defined match type.

      For example:


      <match-system-object>
         <object-name>Address</object-name>
         <match-columns>
           <match-column>
             <column-name>Enterprise.SystemSBR.Person.Address.StreetName
             </column-name>
             <match-type>StreetName</match-type>
           </match-column>
         </match-columns>
      </match-system-object>
  4. To change a field used in the match string, change the value of the column-name element.

    Enter the fully qualified field name of the new field (for example, Enterprise.SystemSBR.Person.FirstName).

  5. To change the type of matching to perform for a field, change the value of the match-type element.

    Enter an ID that identifies the field to the match engine. For the Sun Match Engine, this value must correspond to a defined match type.

  6. To delete a field from the match string, delete all text between and including the match-column element defining the field you want to delete.

    Using the example below, to delete the HouseNo field from the match string, delete the boldface text.


    <match-system-object>
      <object-name>Address</object-name>
      <match-columns>
         <match-column>
           <column-name>Enterprise.SystemSBR.Person.Address.StreetName
           </column-name>
           <match-type>StreetName</match-type>
         </match-column>
         <match-column>
           <column-name>Enterprise.SystemSBR.Person.Address.HouseNo
           </column-name>
           <match-type>HouseNumber</match-type>
         </match-column>
    
  7. Save and close the file.