DefineKeywordGroup Command

Use the DefineKeywordGroup command in a Logic Template to identify keyword indexes which are to be treated as a single keyword index group. The DefineKeywordGroup Command, when used with the KeywordGroupSearch Command, allows the user to search a number of individual keyword indexes as though they were a single large index.

Searching a keyword index group returns the same results that would be returned if a single index were created over all the fields covered by the individual indexes which are part of the keyword index group.

Using a keyword index group containing a number of separate indexes has two advantages over using a single large keyword index over the same data. First, additional flexibility can be achieved by allowing the indexes to be searched individually. Second, the individual indexes can be created with different weighting values as well as with or without the relevancy ranking flag set. This allows for far more accurate sorting by relevancy than would otherwise be available.

A typical use would be to create separate indexes on the title, synopsis and content of an article, turning on relevancy ranking for only the title and synopsis indexes. A match with the title index could be expected to increase the rank more than a match with the synopsis index, which could be expected to increase the rank more than a match with the content index.

With a large single index over all three, title, synopsis and content, no discernable difference would be observed by matching one section of the document over another. Matching 3 out of 3 words within the title would be the same as matching 3 out of 3000 words within the content. Thus, providing a far less accurate relevancy sort.

To define a keyword index group, use the DefineKeywordGroup command with two to n arguments:

DefineKeywordGroup( gid, idx1, idx2[, idx3 [,... ]]);

DefineKeywordGroup Arguments

Argument

Description

gid

The ID assigned to the keyword index group ( 1 - 16 ).

idx1

The name of the first keyword index to be included within the keyword index group.

idx2

The name of the second keyword index to be included within the keyword index group.

idx3

The name of the third keyword index to be included within the keyword index group.

...

List other keyword indexes to be included within the keyword index group in a like manner.

Access the DefineKeywordGroup Dialog Box by selecting the Keyword Index->Define Group menu item under the Searching category of the Logic Template editor command menu.

Example

Command

Description

DefineKeywordGroup( 2, TitleX, AbstractX, ContentX );

Define a keyword index group with ID 2 to include the keyword indexes: TitleX, AbstractX, and ContentX.