tUniservRTMailSearch - 6.1

Talend Components Reference Guide

English (United States)
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for Data Quality
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
Talend Studio
Data Governance
Data Quality and Preparation
Design and Development

tUniservRTMailSearch properties

Component family

Data quality



tUniservRTMailSearch searches for similar data based on the given input record.


tUniservRTMailSearch searches for duplicate values and adds additional data to each record.

Basic settings

Schema and Edit schema

A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. The schema is either Built-In or stored remotely in the Repository.

Since version 5.6, both the Built-In mode and the Repository mode are available in any of the Talend solutions.

Click Edit schema to make changes to the schema. If the current schema is of the Repository type, three options are available:

  • View schema: choose this option to view the schema only.

  • Change to built-in property: choose this option to change the schema to Built-in for local changes.

  • Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion. If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the [Repository Content] window.


Host name

Server host name between double quotation marks.



Listening port number of the server between double quotation marks.



The service name is "mail" by default. Enter a new name if necessary (e.g. due to service suffix), between double quotation marks.


Maximum of displayed duplicates (0 = All)

Enter the maximum number of duplicates to be displayed in the Run view. The default value is 0, which means that all duplicates will be displayed (up to 1000 duplicates can be displayed).


Use rejects

Select this check box to set parameters based on which duplicate records should be added to the reject flow. Then set the:

Element: Duplicate count.

Operator: <, <=, =, >=, >.

Value: Enter the number manually.

Advanced settings

Uniserv Parameters

For detailed information, please refer to the Uniserv user manual mailRetrieval.


tStatCatcher Statistics

Select this check box to collect log data at the Job and the component levels.

Global Variables

ERROR_MESSAGE: the error message generated by the component when an error occurs. This is an After variable and it returns a string. This variable functions only if the Die on error check box is cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl + Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio User Guide.


tUniservRTMailSearch requires an input component and one or more output components.


To use tUniservRTMailSearch, the Uniserv software mailRetrieval must be installed.


Before the first use of tUniservRTMailSearch, an index pool must be created. You can create the index pool with tUniservRTMailBulk.


Scenario: Adding contacts to the mailRetrieval index pool

This scenario describes a batch job that adds contacts to the index pool of mailRetrieval. Before the addition, it must be checked whether these contacts already exist.

The input file for this scenario is already saved in the Repository, so that all schema metadata is available.


Please note that the data from the input source must be related to the same country.

Dropping and connecting the components

  1. In the Repository view, expand the Metadata node and the directory in which the file is saved. Then drag this file into the design workspace.

    The dialog box below appears.

  2. Select tFileInputDelimited and then click OK to close the dialog box.

    The component is displayed in the workspace.

  3. Drag the following components from the Palette into the design workspace: two tMap components, tUniservRTMailSearch and tUniservRTMailOutput .

  4. Connect tMap with tUniservRTMailSearch first.

    Accept the schema from tUniservRTMailSearch by clicking Yes on the prompt window.

  5. Connect the other components via Row > Main.

Configuring the components

  1. Double-click tMap_1 to open the schema mapping window. On the left is the structure of the input file and on the right is the schema of tUniservRTMailSearch. At the bottom lies the Schema Editor, where you can find the attributes of the individual columns and edit them.