DQ.IDENTIFY Function

Identifies the context of a string using an identification analysis definition in the QKB.

Category: Data Quality
Returned data type: Integer
Note: The returned value is a Boolean value where 1= success and 0 = error.

Syntax

DQ.IDENTIFY(ident_def, input, result)

Required Arguments

ident_def

a string representing the name of an identification analysis definition in the QKB.

input

a string representing the input value or input field name.

result

a string representing the output field name.

Details

The DQ.IDENTIFY function analyzes a string and determines the context of the string. The context refers to a logical type of data, such as name, address, or phone.
The function is a member of the data quality class. A data quality object can be declared as a variable and must then be initialized using a call to the function DQ.INITIALIZE. The member function DQ.LOADQKB must then be called to load the contents of a QKB into memory and link that QKB with the data quality object. The data quality object then retains information about the QKB locale setting and the QKB locale setting.
When calling DQ.IDENTIFY, you must specify the name of an identification analysis definition. An identification analysis definition is an object in the QKB that contains reference data and logic used to identify the context of the input string. Refer to your QKB documentation for information about which identification analysis definitions are available in your QKB.
Note: For each identification analysis definition, there is a small set of possible contexts that might be output. Refer to the description of an identification analysis definition in the QKB documentation to see which contexts that definition is able to identify.

Example

data quality dq
 string output
 dq = dq_initialize()
dq.loadqkb("ENUSA")
dq.identify("Individual/Organization", "John Smith", output)
 // outputs "INDIVIDUAL"
 
dq.identify("Individual/Organization", "DataFlux Corp", output)
 // outputs "ORGANIZATION"