matchCandidate() - trillium_quality - 17.2

Guide de référence du SDK Trillium Director

Product type
Logiciels
Portfolio
Verify
Product family
Product
Trillium > Trillium Quality
Version
17.2
Language
Français
Product name
Trillium Quality
Title
Guide de référence du SDK Trillium Director
Topic type
Référence
Installation
Aperçu
Administration
Comment faire
Configuration
First publish date
2008
ft:lastEdition
2024-06-03
ft:lastPublication
2024-06-03T07:28:44.380698

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

Entrant

––

Handle vers une instance du serveur du programme de correspondance Director.

trillName

string[ ]

Entrant

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[ ]

Entrant

n*

Tableau de chaînes de caractères contenant les données à faire correspondre.

key

string[ ]

Sortant

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[ ]

Sortant

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

Entrant

--

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[ ]

Sortant

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);