La méthode matchCandidateWithSuspects() fait correspondre un enregistrement aux candidats qui se trouvent dans la fenêtre de correspondance et renvoie un tableau de clés et un tableau correspondant de modèles de correspondance pour chaque candidat qui est une correspondance ou un suspect. Si seules des correspondances sont requises, utilisez la méthode matchCandidate() dans matchCandidate().
Cette méthode a deux signatures. Choisissez une option selon que vous souhaitez ou non identifier explicitement le niveau de correspondance.
Syntaxe
public void matchCandidateWithSuspects(int handle,
java.lang.String trillName[],
java.lang.String inputData[],
java.lang.String key[],
java.lang.String matchPattern[],
int matchLevel,
int retCode[]);
public void matchCandidateWithSuspects(int handle,
java.lang.String trillName[],
java.lang.String inputData[],
java.lang.String key[],
java.lang.String matchPattern[],
int retCode[]);Paramètres
|
Nom |
Type |
Utilisation |
Longueur |
Description |
|---|---|---|---|---|
|
handle |
entier |
Entrée |
–– |
Handle vers un serveur de programme de correspondance Director. |
|
trillName |
string[ ] |
Entrée |
n* |
Tableau de chaînes contenant les noms des champs de l'enregistrement à comparer. Ces noms de champ correspondent aux noms des champs dans les fichiers DDL. |
|
inputData |
string[ ] |
Entrée |
n* |
Tableau de chaînes contenant les données à faire correspondre. |
|
key |
string[ ] |
Sortie |
n* |
Tableau de chaînes contenant les clés des candidats qui correspondent à l'enregistrement d'entrée. Doit être pré-alloué par l'appelant avec un nombre d'éléments égal au nombre d'enregistrements dans la fenêtre de correspondance. |
|
matchPattern |
string[ ] |
Sortie |
n* |
Tableau de chaînes contenant les modèles de correspondance correspondant aux clés candidates renvoyées dans la clé. Doit être pré-alloué par l'appelant avec un nombre d'éléments égal au nombre d'enregistrements dans la fenêtre de correspondance. |
|
matchLevel |
entier |
Entrée |
-- |
Niveau de correspondance à exécuter : 1 ou 2. Si aucun niveau n'est spécifié, le niveau 1 est utilisé. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
n* indique que la longueur dépend de la plateforme sur laquelle le programme est exécuté.
Valeurs renvoyées
Reportez-vous à la section Valeurs renvoyées.
Exemple
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);
testClient.clearWindow(handle, retCode);
// Error handling omitted
inputData[0] = "JOHN";
inputData[1] = "SMITH";
inputData[2] = "D";
keyValue = "1ST JOHN";
testClient.addToMatchWindow(handle, matchFields, inputData,
keyValue, retCode);
inputData[0] = "JOHNATHAN";
inputData[1] = "SMITH";
inputData[2] = "DAVID";
keyValue = "2ND JOHN";
testClient.addToMatchWindow(handle, matchFields, inputData,
keyValue, retCode);
inputData[0] = "J";
inputData[1] = "SMITH";
inputData[2] = "D";
keyValue = "3RD JOHN";
testClient.addToMatchWindow(handle,
matchFields,inputData,keyValue, retCode);
inputData[0] = "JOHN";
inputData[1] = "SMITH";
inputData[2] = ""; // Match this record
// Return matches and suspects
testClient.matchCandidateWithSuspects(handle, matchFields,
inputData, outKeys, outPats, retCode);