Alias dictionary

An instance of the AliasDictionary class contains all the aliases defined in an index. Information on using aliases to search is provided on the Using aliases page.

To get the number of existing aliases, use the getCount method.

Use the add method to add new alias-replacement pair.

Use the addRange method to add a collection of new alias-replacement pairs.

To remove an alias from the dictionary, use the remove method.

The contains method is used to check for the presence of a particular alias in the dictionary.

To get a replacement for a particular alias, use the getText method.

The clear method is used to remove all existing aliases from the dictionary.

To export the list of aliases with replacements to a file, use the exportDictionary method.

To import the list of aliases from a file, use the importDictionary method.

The following example demonstrates the use of methods of the alias dictionary.

const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating or opening an index from the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

if (index.getDictionaries().getAliasDictionary().getCount() > 0) {
  // Deleting all existing aliases
  index.getDictionaries().getAliasDictionary().clear();
}

// Adding aliases to the alias dictionary
index.getDictionaries().getAliasDictionary().add('t', '(gravida OR promotion)');
index.getDictionaries().getAliasDictionary().add('e', '(viverra OR farther)');
const pairs = java.newArray('com.groupdocs.search.dictionaries.AliasReplacementPair', [
  new groupdocs.search.AliasReplacementPair('d', 'daterange(2017-01-01 ~~ 2019-12-31)'),
  new groupdocs.search.AliasReplacementPair('n', '(400 ~~ 4000)'),
]);
index.getDictionaries().getAliasDictionary().addRange(pairs);

if (index.getDictionaries().getAliasDictionary().contains('e')) {
  // Getting an alias replacement
  const replacement = index.getDictionaries().getAliasDictionary().getText('e');
  console.log('e - ' + replacement);
}

// Export aliases to a file
const fileName = Utils.OutputPath + 'AdvancedUsage/ManagingDictionaries/aliasDictionary/Aliases.dat';
index.getDictionaries().getAliasDictionary().exportDictionary(fileName);

// Import aliases from a file
index.getDictionaries().getAliasDictionary().importDictionary(fileName);

// Search in the index
const query = '@t OR @e';
const result = index.search(query);

More resources

GitHub examples

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

Free online document search App

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online Free Online Document Search App.