addToMatchWindow() ajoute un candidat à une liste liée qui est ensuite envoyée au serveur du programme de correspondance Director lorsque matchCandidate() est appelé.
Le client doit vérifier le code d'erreur après chaque appel ToMatchWindow(). Si la valeur 705 est renvoyée, cela implique que le nombre d'enregistrements ajoutés à la fenêtre de correspondance a dépassé la taille maximale de la fenêtre. L'application doit tenter une nouvelle fois d'établir la correspondance. Notez que l'enregistrement qui a provoqué le code d'erreur 705 n'a pas été traité.
Syntaxe
public void addToMatchWindow(int handle,
java.lang.String trillName[],
java.lang.String inputData[],
java.lang.String key,
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 des données candidates. Ces noms de champs correspondent aux noms des champs dans le fichier DDL. |
|
inputData |
string[ ] |
Entrée |
n* |
Tableau de chaînes contenant les données candidates. |
|
key |
chaîne |
Entrée |
défini par l'utilisateur |
« Clé » unique du candidat. Cette valeur est ensuite renvoyée par la méthode matchCandidate() si le serveur de correspondance identifie ce candidat comme une correspondance. |
|
retCode |
int[ ] |
Sortie |
4 |
Code d'erreur indiquant le statut de l'appel de la méthode. |
*Indique une longueur spécifique à la plateforme, c'est-à-dire que la longueur dépend de la plateforme sur laquelle le programme s'exécute.
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);
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);