addToMatchWindow()   - trillium_quality - 17.1

Trillium Director SDK Reference Guide

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Quality
Version
17.1
Language
English
Product name
Trillium Quality
Title
Trillium Director SDK Reference Guide
Topic type
How Do I
Administration
Installation
Overview
Reference
Configuration
First publish date
2008
ft:lastEdition
2024-02-22
ft:lastPublication
2024-02-22T11:34:59.273199

The addToMatchWindow() adds a match candidate to a linked list that is subsequently sent to the Director matcher server when matchCandidate() is called.

The client should check the error code after each add ToMatchWindow() call. If the value 705 is returned, the number of records added to the match window has exceeded the maximum window size. The application should attempt the match again. Note that the record that caused the 705 error code was not processed. 

Syntax

public void addToMatchWindow(int handle,
                            java.lang.String trillName[],
                            java.lang.String inputData[],
                            java.lang.String key,
                            int retCode[]);

Parameters

Name

Type

Use

Length

Description

handle

int

In

––

Handle to a Director matcher server.

trillName

string[ ]

In

n*

Array of strings that contains the field names of the candidate data. These field names correspond to the field names in the DDL file.

inputData

string[ ]

In

n*

Array of strings containing candidate data.

key

string

In

user-defined

Unique “key” for this candidate. This value  will be subsequently returned by the matchCandidate() method if the matcher server identifies this candidate as a match.

retCode

int[ ]

Out

4

Error code that indicates status of method call.

*indicates a platform-specific length; that is, the length depends on the platform on which the program runs.

Return Values

Refer to Return Values.

Example

TrilTGenClient testClient = new TrilTGenClient();
int[] retCode= new int[1];             // Return code and handle
int handle = 0;
char systemID;                         // System and Server ID for attach()
String serverName;
String[] matchFields = {"FirstName", "LastName", "MiddleName"};
String[] inputData = new String[3];
String keyValue;
String[] outPats = new String[12];
String[] outKeys = new String[12];
systemID = 'G';
serverName = "RMatcher";
handle = testClient.openMatcherEx(systemID, serverName, retCode);
inputData[0] = "JOHN";                 // Error handling omitted
inputData[1] = "SMITH";
inputData[2] = "D";

keyValue = "1ST JOHN";                 // Add first candidate to match window

testClient.addToMatchWindow(handle, matchFields, inputData,
keyValue, retCode);
inputData[0] = "JOHNATHAN";
inputData[1] = "SMITH";
inputData[2] = "DAVID";

keyValue = "2ND JOHN";               // Add second candidate to match window

testClient.addToMatchWindow(handle, matchFields, inputData,
keyValue, retCode);
inputData[0] = "J";
inputData[1] = "SMITH";
inputData[2] = "D";

keyValue = "3RD JOHN";               // Add third candidate to match window

testClient.addToMatchWindow(handle, matchFields, inputData,
keyValue, retCode);
inputData[0] = "JOHN";
inputData[1] = "SMITH";
inputData[2] = "";                  // Match current record against candidates
testClient.matchCandidate(handle, matchFields, inputData, outKeys,
outPats, retCode);