La méthode matchCandidate permet de faire correspondre un enregistrement aux candidats qui se trouvent dans la fenêtre de correspondance. Cette méthode renvoie un tableau de clés et un tableau correspondant de modèles de correspondance pour chaque candidat qui correspond.
Cette méthode ne renvoie pas de suspects. Pour renvoyer les suspects, ainsi que les correspondances, utilisez la méthode matchCandidateWithSuspects décrite dans matchCandidateWithSuspects().
Cette méthode a deux signatures. Choisissez une option selon que vous souhaitez ou non identifier explicitement le niveau de correspondance.
Syntaxe
public void matchCandidate(int handle,
java.lang.String trillName[],
java.lang.String inputData[],
java.lang.String key[],
java.lang.String matchPattern[],
int matchLevel,
int retCode[]);
public void matchCandidate(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 une instance du serveur du programme de correspondance Director. |
|
trillName |
string[ ] |
Entrée |
n* |
Tableau de chaînes de caractères 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 de caractères 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. Ce tableau doit être pré-alloué par l'appelant, et le nombre d'éléments doit être é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é. Ce tableau doit être pré-alloué par l'appelant, et le nombre d'éléments doit être é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é par défaut. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode |
n* indique la longueur maximale. La longueur totale dépend du nombre d'éléments alloués et 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
testClient.matchCandidate(handle, matchFields, inputData, outKeys, outPats,
retCode);