MatchUp Object:Hybrid:Match Key

From Melissa Data Wiki
Jump to navigation Jump to search

← MatchUp Object Reference

MatchUp Object Hybrid Interface Navigation
Overview
Order of Operations
Functions
Initialization
Mapping
Match Key
Comparison



The following functions gather the input data and use it to generate match keys according to the mapping and the selected matchcode.

ClearFields

Use this function before the first call to AddField function for each record or after calling the BuildKey function.

Syntax mdMU->ClearFields()
C mdMUHybridClearFields(mdMU)
.Net mdMU.ClearFields


AddField

This function passes a component of data to the deduper prior to calling the BuildKey function.

Fields must be passed to this function in the same order that the corresponding data types were mapped using the AddMapping function.

For example, if the matchcode uses five-digit ZIP codes, last and first names, and the street addresses, in that order. Then the file will only include a single “City/ST/ZIP" and a single full name field.

mdMU->AddField("Rancho Santa Margarita, CA 92688")
mdMU->AddField("Raymond F. Melissa")
mdMU->AddField("Raymond F. Melissa")
mdMU->AddField("22382 Avenida Empresa")

The interface would use only the ZIP Code from the first field, the last name from the second and first name from the third.

Syntax mdMU->AddField(char)
C mdMUHybridAddField(mdMU, char)
.Net mdMU.AddField(string)


BuildKey

This function takes the information passed via calls to the AddField function and, using the mapping defined by the AddMapping function and the pattern defined by the matchcode being used, builds a match key.

A match key is a character string built according to a pattern defined by the current matchcode, consisting only of enough information to determine if the current record is unique or has a duplicate within the key file.

For example, assuming we have a matchcode called for a five-digit ZIP Code, first ten characters of a last name, a street number and the first ten characters of a street name. The current record is for Raymond F. Melissa at 22382 Avenida Empresa in the 92688 ZIP Code. The match key would be:

92688MELISSA RAYMOND 22382EMPRESA   

Because “Empresa” is only seven characters, the key would be padded with three spaces at the end.

Syntax mdMU->BuildKey()
C mdMUHybridBuildKey(mdMU)
.Net mdMU.BuildKey


GetKey

This function returns a string value containing the match key generated by the most recent call to the BuildKey function.

Use this function to recall the most recently generated match key before writing it to a key file or passing it to the CompareKeys function.

Syntax char = mdMU->GetKey()
C char = mdMUHybridGetKey(mdMU)
.Net string = mdMU.GetKey