Name Variant Expansion

QMS can automatically detect names in query text and expand the original query to include variants of the name, such as using initials, the name with a title, translations, phonetically similar names, and common nicknames.

NOTE: You do not need to configure QMS rules for name variant expansion. However, you must obtain the combined_names.ecr grammar from the IDOL Eduction Grammars package. To obtain this package, contact OpenText support.

When you configure name variants, QMS uses an IDOL Eduction grammar to match names in the query text. When it finds a name, it sends a query to the IDOL Content component to find any variants of this name that occur in your index. QMS then modifies the original query to include the name variants by using a SYNONYM operator, in a similar way to how it adds synonyms for exact phrase search (see Expand Exact Phrase Searches).

Configure Name Variants

To use name variant expansion, you must configure the locations of your Eduction grammar, post-processing script, and the data files that QMS needs to expand names.

You obtain the combined_names.ecr grammar and pii_postprocessing.lua script from the IDOL Eduction Grammars package. The namevariants.dat and hyph_en_US.dic data files are included in the QMS installation.

You configure the locations of these files by using the [NameVariants] configuration section. For example:

[NameVariants]
GrammarDirectory=qms/namevariants/grammars
DataDirectory=qms/namevariants/data

For more information, see NameVariants Parameters.

NOTE: QMS name expansion queries use Soundex operators when it queries the IDOL Content component to retrieve phonetically similar and transliterated names. To use this type of variant, you must set the Soundex configuration parameter to 1 in your Content configuration file.

For more information, refer to the IDOL Content component Help.

Send Name Variant Queries

You send a name variant query by using the ExpandNames action parameter with your query.

For example, to search for "John Smith" and variants of that name, you can use the following query:

action=Query&Text=John Smith&ExpandNames=True

and QMS might produce the following expanded query, where each of the listed variants exists in a document in Content.

'SYNONYM("J Smith","J. Smith","JOHN Jimmy SMITH","JOHN SMITH","John A. Smith","John James Smith","John Jimmy Smith","John Smith","Johnny Smith","Mr. Smith","Джон Смит")'

By default, QMS does not perform name expansions on exact phrases (that is, text in quotation marks ""). For example, the following query returns only results for John Smith:

action=Query&Text="John Smith"&ExpandNames=True

To expand exact phrases, you can set ExpandPhrases to True on the query, in the same way as for synonym rule queries (see Expand Exact Phrase Searches). For example:

action=Query&Text="John Smith"&ExpandNames=True&ExpandPhrases=True

Name Variant Examples

The following table lists the name variant types that QMS can find, with examples:

Variant Type Example Match Example Expansions
initials John Smith

J Smith, J. Smith

titles James Watt James Watt Jr, Dr. Watt

missing components (that is, part of the name is missing)

John Clayton Smith

John Smith

out of order components (such as last name before first name)

Jimmy John Smith John Jimmy Smith

phonetic similarity

Claire Brown Claire Browne

nicknames

Ted Brown Ed Brown, Eddy Brown, Edgar Brown, Ned Brown

translations

Clementine Blom

Клементина Блом

transliteration

Abdul Hussein

Abd al-Hussein

compound names (such as hyphenated names written without a hyphen)

Mary-Ellen Smith

Maryellen Smith

truncated name components

Ronald McDonald

Ron McDonald