Match modes affect which records are returned by a record search, by specifying requirements for matches. Depending on the match mode, the records returned must have property values or be tagged to dimension values that match the entire search term or only some words in the search term.
To specify the match mode used for keyword searches by your
application, specify the match mode as the value of the
defaultMatchMode property of the
navigationStateBuilder component in
assembler-context.xml. For example:
<property name="defaultMatchMode" value="ALLPARTIAL"/>
Note
Match modes apply to all components of the response, such as results lists and refinement menus.
The following table lists the supported match modes and shows the phrases that would match the search string "ultra compact digital" when each of the match modes is selected.
|
Match mode |
Description |
Given the search string "ultra compact digital", returns records where there is a match on: |
|---|---|---|
|
MatchAll (default) |
Returns records that have a property value or are tagged to a dimension value that matches the entire search string. |
|
|
MatchPartial * |
Returns records that have a property value or are tagged to a dimension value that matches two or more words in the search string. |
|
|
MatchAllPartial* |
Returns records that have a property value or are tagged to a dimension value that matches the entire search string If the record search finds no such records, it returns records that have a property value or are tagged to a dimension value that matches any possible combination of words in the search string. If the record search finds no such records, it returns nothing. |
or else
or else
|
|
MatchAny |
Returns records that have a property value or are tagged to a dimension value that matches at least one word in the search string. |
|
|
MatchAllAny |
Returns records that have a property value or are tagged to a dimension value that matches the entire search string. If the record search finds no such records, the record search returns records that have a property value or are tagged to a dimension value that matches at least one word in the search string. If the record search finds no such records, it returns nothing. |
or else
or else
|
|
MatchPartialMax* |
Useful only when the search string consists of four or more words. The record search returns records that have a property value or are tagged to a dimension value that matches the entire search string. If it finds no such records, it returns records that have a property value or are tagged to a dimension value that matches any combination of three words in the search string. If it finds no such records, it returns records that have a property value or are tagged to a dimension value that matches any combination of two words in the search string. If it finds no such records, it returns nothing. |
Given the search string "deluxe ultra compact digital", the record search returns records that have a property or are tagged to a dimension search that matches:
or else
or else
or else
|
|
MatchBoolean |
Matches by using a Boolean query expression using AND, OR, NOT, ONEAR and NEAR. |
MatchBoolean is useful only for applications whose end users know how to enter boolean-formatted queries. It is not appropriate for eCommerce websites. The MatchBoolean match mode has negative interactions with relevancy ranking, processing rules, and other aspects of MDEX engine query processing. |
* The partial match modes (MatchPartial, MatchAllPartial, and MatchPartialMax) specify that matches occur only when at least two words in the search string match the property or dimension value and that matches can omit no more than two words in the search string.
Note
MatchAllPartial and MatchPartialMax are the most commonly chosen match modes in eCommerce applications.
