On the Search Workbench tab, select Dictionaries from the Show menu.
Select Term Dictionaries.
Click New Dictionary.
Enter a name (required) and description (optional) for the new dictionary.
Enter a Dictionary Adaptor Name (optional). If used, when the dictionary is loaded, it is loaded under this adaptor name. Note that the dictionary name is called
context
by the Search API.Select the dictionary’s language.
For the Load Mode, select one of the following:
Modify—Oracle ATG Web Commerce Search assesses the terms and term relationships of your new dictionary and automatically attempts to correct any data that conflicts with the Search core dictionary. For example, if you add the custom term modems using modify mode, Search recognizes it as the plural of an existing term and modifies modems to modem.
Override—The terms and term relationships of your new dictionary override those in the Search core dictionary. Using this mode, if you add the term modems as a custom term, Search ignores the fact that modems is the plural of an existing term, and adds it to the custom dictionary. Modems becomes a separate term from modem and is no longer recognized as a form of the core term. Override mode is useful if you need to create a distinction between terms that mean different things in their singular and plural forms, such as window and Windows.
Reject—Search rejects any data in your new dictionary that conflicts with the Search core dictionary. For example, if you add modems as a custom term using reject mode, Search recognizes it as the plural of an existing core term and ignores the entry.
Note: For data on rejected terms, enable logging as described in Enabling Search Logging, and search the response XML data for the TermLoad command.
Enter the maximum term expansion.
When dictionary terms are organized hierarchically, you can optionally indicate that this hierarchy implies term expansion (see the explanation of term propagation under Why Add Synonyms and Child Terms). Because a term that is high up in the hierarchy can potentially have many synonyms if all head terms in the hierarchy are propagated, Search allows the user to limit the potential synonyms via the Maximum Term Expansion setting. If a term’s propagated expansions add up to a number greater than the number specified, no propagated expansions will be used. Regular synonym-level expansions are unaffected by the Maximum Term Expansions setting.
Set the maximum term expansion to 0 to disable term expansion. If you set this value to a number larger than the number of levels in your dictionary, all terms are fully expanded. Note that very large expansion sets can slow down search as well as worsen results.
Click Create.
To add a term, term association, or synonym to a dictionary, see Managing Terms in this chapter.