Results > Search and Retrieve > Synonym Search > Enable Synonym Searches

Enable Synonym Searches
Use this procedure to enable synonym searches in IDOL server.
To enable synonym searches
1.
2.
Configure IDOL server to use a synonym file.
3.
For details on the settings that the [Synonym] sections can contain and on how you can configure them, see the IDOL server online help.
Related Topics 
*
*
*
*
Set up a Synonym File
 
To set up a synonym file
1.
Create a text file and save it in IDOL server's IDOL/content directory using the file name you specified in the IDOL server configuration file [SynonymType] section.
2.
Create sections for each language type you defined in the IDOL server configuration file. For example:
[EnglishASCII]
[GermanUTF8]
3.
In each section, create a line for each word for which you want to list synonyms (using the same encoding you are using for the associated language type). For example:
[EnglishASCII]
cat
dog
[GermanUTF8]
Katze
Hund
4.
List synonym strings next to each word and save the file. You must separate the word and each string with commas (there must be no space before or after a comma). The individual terms can contain spaces but must not contain any punctuation. For example:
[EnglishASCII]
cat,feline,grimalkin,moggy,mouser,puss,pussy,tabby
dog,bitch,cur,hound,mans best friend,mongrel,mutt,pooch,puppy
[GermanUTF8]
Katze,Mietze,Mietzekatze,Mietzekater,Kater,Mulle,Kätzchen
Hund,Wau Wau,Hündin,Töle,Kläffer,Hündchen,Welpe
 
Related Topics 
*
Configure IDOL Server to Use a Synonym File
 
NOTE You must configure IDOL server to use the synonym file before you index the data you want to search.
To configure IDOL server to use a synonym file
1.
Open the IDOL server configuration file in a text editor.
2.
In the IDOL server configuration file's [FieldProcessing] section, set up a synonym process. This process allows IDOL server to determine when it must apply synonym settings. For example:
[FieldProcessing]
0=SynonymMatch
3.
Create a section for the synonym process you listed, in which you create a property for the process (synonym properties always point to a defined synonym job). Identify the fields you want to associate with the process. For example:
[SynonymMatch]
Property=ApplySynonymMatch
PropertyFieldCSVs=*/DRETITLE,*/DRECONTENT
In this example, IDOL server returns only documents for synonym queries if their DRETITLE or DRECONTENT field values match the query.
 
(When identifying the fields, use the format /FieldName to match root-level fields, */FieldName to match all fields except root-level, or /Path/FieldName to match fields that the specified path points to).
4.
Create a section for the property in which you set the SynonymType parameter to the name of the synonym job that specifies which settings IDOL server must apply to synonym queries.
[ApplySynonymMatch]
SynonymType=Synonym_job
5.
In the IDOL server configuration file [Synonym] section, list the synonym job whose settings you want to apply when you send a synonym query to IDOL server. You can set up multiple jobs. However you normally only require one. For example:
[Synonym]
0=Synonym_job
6.
Define a section for your synonym job in which you specify the settings that you want to apply to synonym queries. The section must have the same name as the synonym job. For example:
[Synonym_job]
File=animals.txt
MaxExpandLevel=1
7.
Execute Synonym Searches
After you create a synonym file and configure IDOL server to use it, you can turn any Query action that you send to IDOL server into a synonym query by adding &Synonym=true to it. For example:
http://localhost:5552/action=Query&Text=Felix is a great mouser&Synonym=true
This query returns documents that conceptually match the term mouser, as well as documents that conceptually match any of the terms listed as synonyms for the term mouser in the synonym file.