Open topic with navigation

# Query

Allows you to submit a natural language, Boolean, bracketed Boolean, keyword, field, or fuzzy query to IDOL Server.

## Example

    http://12.3.4.56:9000/action=Query&Text=Gene analysis discovered methods to determine the exact sequence of nucleotides that compose a specific gene

This action uses port `9000` to request documents that are conceptually similar to the specified text from IDOL Server, which is located on a machine with the IP address `12.3.4.56`.

## Parameters

Parameter | Description | Required
--- | --- | ---
AbsWeight | Use absolute weights, rather than percentage relevance. |
AgentBooleanField | A field that contains Boolean agent expressions. |
AgentParamsField | A field that contains extra query parameters for AgentBoolean queries. |
AgentSecurityField | A field that contains the SecurityInfo for secure documents in AgentBoolean queries. |
AnyLanguage | Allows IDOL Server to return documents in any language. |
AutoPhrase | Applies automatic phrase quotations to all terms in the query text before sentence-breaking, N-gram breaking, or decomposition. |
CaseSensitive | Determines the case sensitivity of field specifiers. |
Characters | The number of characters that a summary can contain. |
Cluster | Clusters the results that IDOL Server returns. |
ClusterThreshold | The percentage relevance that documents must have to each other to be grouped in a cluster. |
ClusterTitleLength | The maximum number of characters in a cluster title. |
Combine | Combine results that derive from the same source. |
CombineNumber | Increases the number of results that the action returns, if you set Combine to `FieldCheck`, or to a reference field. |
DAHEndState | Define the range of results to return in a batch. |
DAHStartState | Returns results in batches. |
DatabaseMatch | The database to retrieve results from. |
DetectLanguageType | Detect the correct language type of the text. |
DontMatchID | Document IDs for documents that you do not want to return. |
DontMatchReference | References for documents that you do not want to return. |
EndTag | The end HTML tag to apply to highlighted terms. |
FieldCheck | Match results that have a specified value in a FieldCheckType field. |
FieldRecurse | Returns the chain of values in a document ReferenceMemoryMappedType field. |
FieldRestriction | Restrict the query terms to a field. |
FieldText | Add a field restriction to the query. | See Comments
FieldTextField | A field that contains a FieldText expression to use. |
HardFieldRestriction | Specifies that the fields in FieldRestriction are the only fields allowed in the matching process for both FieldText and Text. |
Highlight | Whether to highlight link terms or sentences in the results. |
HighlightTagTerm | Adds an attribute to the StartTag to indicate the term that is highlighted. |
IgnoreSpecials | Ignore certain special characters. |
IRS | Send the query to an instant response server (IRS). |
LanguageType | The language type of the query text. |
LinkFieldText | The `FieldText` expression to match in the linked documents when FieldText contains an expression with the LINK field specifier. |
MatchAllTerms | Whether to return only results that match all query terms. |
MatchEncoding | The encoding that a document must have to return. |
MatchID | Document IDs for documents that you want to return. |
MatchLanguage | The language that a document must have to return. |
MatchLanguageType | The language type that a document must have to return. |
MatchReference | Document references that can return. |
MaxDate | The maximum creation date that a document can have to return. |
MaxID | The highest document ID to return. |
MaxLinksPerTerm | Reduce the maximum occurrence of each term for categorization. |
MaxPrintChars | The maximum number of characters to print in fields. |
MaxQueryTerms | The maximum number of terms to use in the query. |
MaxResults | The maximum number of results to print. |
MaxScore | The maximum score that results can obtain. |
MinDate | The minimum creation date that a document can have to return. |
MinID | The minimum document ID to list. |
MinLinks | The minimum number of links in results documents. |
MinScore | The minimum score that results must have. |
MinTermLength | The minimum length that a term can have after stemming. |
MultiStage | Use multi-stage query for the DAH. |
MultiStageInfo | The VDBs to use for the multistage query. |
MultiStageMinResults | The minimum number of results to return in the multistage query. |
MultiStagePageBackward | Page backward in the multistage query. |
MultiStageStartState | The start state for the multistage query. |
MultiStageTotalStages | The total number of stages for the multistage query. |
OutputEncoding | The encoding to convert the results to. |
PerformanceAnalysis | Return query performance information. |
Predict | Whether to predict the total number of results. |
Print | Defines the fields to display. |
PrintEngine | Whether to display information about the DAH child servers that results come from. |
PrintFields | Overrides fields that display by default. |
QuerySummary | Return a summary of the best terms and phrases in the results. |
QuerySummaryAdvanced | Whether to enable the advanced algorithm for query summaries, for Dynamic Summaries and Automatic Query Guidance. |
QuerySummaryIDs | Whether to include the IDs of parent documents for query summary phrases in the response. |
QuerySummaryLength | The maximum number of best terms to use in a query summary. |
QuerySummaryMaxDocLength | The maximum number of characters in each document to use to generate a query summary. |
QuerySummaryNumbers | Whether to allow numeric and alphanumeric values in query summaries. |
QuerySummaryPhraseLength | The maximum number of terms to include in each query summary phrase. |
QuerySummaryPlus | Whether to enable the `QuerySummaryPlus` algorithm for query summaries. |
QuerySummaryStopPhraseMode | Disable the configured QuerySummaryStopPhraseMode. |
QuerySummaryTerms | The number of terms to use to generate a query summary. |
QuerySummaryWhiteListMode | Disable the configured QuerySummaryWhiteListMode. |
ReferenceField | Restricts the DontMatchReference and MatchReference parameters to the specified reference field. |
SecurityInfo | The security details. |
Sentences | The number of sentences that the summary can contain. |
ShowReasons | Whether to include details of the matching words and phrases in a result. |
SingleMatch | Return a single result. |
Sort | The display order to use for results. |
Spellcheck | Checks the spelling of terms in the Text. |
Start | Print results from this position onwards. |
StartTag | The opening HTML tag to apply to highlighted terms. |
StateDontMatchID | The state token of a group of documents to not return. |
StateMatchID | The state token of a group of documents to return. |
Stemming | Whether to use stemming for advanced search. |
StoredStateDetail | Return `Engine` and `EngineIndex` elements for result documents, as well as child server details. |
StoredStateField | The field that contains reference values to use to create the state token. |
StoredStateTokenLifetime | The length of time to keep the stored state token. |
StoreState | Whether to store results in a state token. |
Summary | The type of summary to return with the results. |
Synchronous | Whether to run the action synchronously or asynchronously. |
Synonym | Whether to run a synonym query. |
Text | The query text. | See Comments
TextParse | The format of the Text. |
TimeoutMS | The period after which the action times out. |
TotalResults | Displays the total number of results found. |
UserMetaFields | Creates a new metafield by performing a mathematical operation on document fields. |
VQL | Run a Verity Query Language (VQL) query. |
WeighFieldText | Adjusts results relevance according to FieldText matching. |
XMLMeta | Whether to return additional metadata for each result. |

This action accepts the following standard ACI action parameters.

Parameter | Description
--- | ---
ActionID | A string to use to identify an ACI action.
EncryptResponse | Encrypt the output.
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.

## Comments

You must set one of the following parameters or parameter combinations:

- Text

- FieldText

- Text and FieldText

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm