Create a fuzzy lookup source
Use the procedure in this topic to create a fuzzy lookup source that can then be used by fuzzy lookups in your solution.
Before you create a fuzzy lookup source, verify that you have the necessary files or website available.
- Select the Settings menu on the ribbon.
- Select Processing.
-
In the
Fuzzy Lookup Sources section, select
Add Fuzzy Lookup Source.
The Add Fuzzy Lookup Source window is displayed with two tabs at the top and a preview of the fuzzy lookup source at the bottom.
-
On the
Settings tab, configure the following settings.
Setting
Description
Name
The name of the fuzzy lookup.
Source CSV/Text
The format of the lookup source file. Select from:
- File:
-
Select and use Browse to upload the source file in either *.csv or *.txt format.
File-based source files cannot be updated automatically. If the file changes, a manual update is required.
- URL:
-
Select Configure URL to provide the following information in the Web Resource window:
- URL:
-
Enter the web address for your fuzzy lookup source file.
- Anonymous Auth:
-
When selected, any user is able to access the source file. (Default: Selected)
When cleared, enter the User name and Password required to access the source file website.
This website must be accessible by the TotalAgilityserver.
If you want to update the web-based source file automatically, enable Live Update.
Click OK to save your changes in the Web Resource window.
Import settings
Convert text to lowercase
Converts all search and lookup strings to lowercase, effectively ignoring case. (Default: Selected)
Use first row as column headings
If selected, takes the first row in the file is the header row. (Default: Selected)
Field delimiter
Enter values into this field to specify what characters separate the import file content into individual fields. (Default: ; (semicolon))
- Tab:
-
Uses a Tab as a delimiter in addition to the characters specified in the Field delimiter setting. (Default: Cleared)
The same character cannot be used as a field delimiter, a word separation character or an ignored character.
Word separation
If fields in the source file contain compound words, common characters can be specified so each part of the compound word is searched and evaluated separately. (Default: -, (space, hyphen, comma))
For example, using the default settings, the compound word "Diagon-Alley," is treated as two words, "diagon" and "alley" that are searched and evaluated separately.
- Tab:
-
Uses a Tab as a word separation character in addition to the characters specified in the Word separation characters setting. (Default: Cleared)
- Space:
-
Uses a Space as a word separation character in addition to the characters specified in the Word separation characters setting. (Default: Selected)
Ignore characters
Enter a list of characters to filter unwanted characters from the input record. When you want to use a field delimiter that may also be a character in the input, such as a comma (,), then you have to use quotes (") to identify the input strings. However, you probably do not want to retain those quotation marks as part of the final results. (Default: ."'! (period, quotation mark, single quotation mark, and an exclamation point))
If you define the quotes as characters to ignore, they are removed. To define a tab or space as characters to ignore, select the corresponding check box.
- Space:
-
Ignores a Space character in addition to the characters specified in the Characters to ignore setting. (Default: Cleared)
The Preview is updated with the first 20 records from the fuzzy lookup source. If you change one of the settings, the preview is updated automatically.
-
Select the
Columns tab.
The list of columns for the selected source file is displayed, where you can edit the Display name as needed.
- Optional. Edit the Display name for any source file columns that have a default name that is not suitable.
-
By default, all columns in the source file are included in searches. Clear the
Search setting to exclude any fields from fuzzy lookup searches.
Select the Search setting for fields that might be present on the document. If a field is never printed on a document, clear this setting.
-
Select
Add.
The newly added lookup source is added to the Fuzzy Lookup Sources list.
-
Optional. Select
Edit fuzzy lookup source and
Delete fuzzy lookup source to manage your fuzzy lookup sources.
If a fuzzy lookup uses a fuzzy lookup source, you cannot edit it by selecting another source file or URL that contains a different structure or column order.
If you attempt to delete a fuzzy lookup source that is used by a fuzzy lookup, a warning message is displayed indicating that if you delete the source, the related lookup and associated fields are removed everywhere.
If you have Live Update configured a web-based lookup source and the source structure or column order changes, an error occurs during runtime and you will need to configure the fuzzy lookup source, fuzzy lookup, and fields again.