IDOL Server 24.1

# TermExpand

Allows you to specify misspelled or Wildcard terms and return all matching terms in IDOL Server. You can also use `TermExpand` to return the term phrases that internal synonym links (returned by a query with the Synonym parameter) correspond to.

You can also restrict the term expansion for Wildcard or misspelled terms to terms in UnstemmedTrackFields by adding a field restriction.

NOTE: By default, `TermExpand` does not apply document security to the results. You can enable security by setting the SecureTermExpansion configuration parameter. In this case you must provide the SecurityInfo with the security information for the user, and `TermExpand` returns terms from only documents that the user has permission to access.

`TermExpand` returns the tag `<autn:secure_expansion>`, which has the value `True` when you have turned on SecureTermExpansion, or when you do not have security configured.

## Example

    http://12.3.4.56:9000/action=TermExpand&Text=sound&Expansion=Fuzzy

This action requests fuzzy matches for the term `sound`.

    http://12.3.4.56:9000/action=TermExpand&Text=Mauri*:Country&Expansion=Wild

This action requests terms that start with `Mauri` in the `Country` field. In this example, the `Country` field must be configured in UnstemmedTrackFields.

## Required Parameters

The following action parameters are required.

Parameter | Description
--- | ---
Expansion | The expansion type to use.
Text | The text or synonym link to expand.

## Optional Parameters

This action accepts the following optional parameters.

Parameter | Description
--- | ---
FieldText | Restrict term expansion results to terms that appear in documents that match the specified field text.
LanguageType | The language type of the Text.
MaxTerms | The maximum number of terms or term phrases to return.
MinDocOccs | The minimum number of times that a term must occur to return as an expansion.
OutputEncoding | The encoding to convert the results to.
SecurityInfo | The security information string for the user.
Stemming | Whether to stem the terms in the results list.
Synchronous | Whether to run the action synchronously or asynchronously.
TermDetails | Whether to return details of the number of documents that each term occurs in.
Type | The value to use to sort the result terms.

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
FileName | The file to write output to.
ForceTemplateRefresh | Forces the server to load the template from disk.
Output | Writes output to a file.
ResponseFormat | The format of the action output.
Template | The template to use for the action output.
TemplateParamCSVs | A list of variables to use for the specified template.

Copyright 2023 Open Text
Version 24.1 | Last updated December 2023

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Server 24.1

Topic Title: TermExpand