Open topic with navigation

# CategorySuggestFromDocument

Returns categories that are similar to a document that you specify.

You can specify secure documents for this action. Use the SecurityInfo parameter to specify the security string to use.

## Example

    http://12.3.4.56:9000/action=CategorySuggestFromDocument&DocID=125

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

By default, this action operates by sending a Query action to the Agentstore, but it can send a SuggestOnText query instead, if you set the UseSuggestOnText parameter. SuggestOnText and Query work slightly differently. SuggestOnText is faster, but Query is more accurate. Reducing the MaxQueryTerms when you UseSuggestOnText is set to `False` (the default) speeds up the `CategorySuggestFromDocument` action, but reduces accuracy.

## Parameters

Parameter | Description | Required
--- | --- | ---
AgentBoolean | Whether to use Boolean restrictions for a category. |
AnyLanguage | Whether to retrieve categories that were stored in all languages. |
Databases | Restricts results to a specific category database. |
DatabaseMatch | The databases that contain the documents to suggest on. |
DocID | The document IDs of the documents to suggest on. | See Comments
DocRef | The references of the documents to suggest on. | See Comments
FieldText | A field restriction to apply to results. |
FullPathOnly | Whether to return only the full path from the schema root to the category. This parameter applies only when you set ShowCategoryPath to `True`. |
IncludeTopLevel | Whether to include the top level category in a path that shows the position of the category. This parameter applies only when you set ShowCategoryPath to `True`. |
MaxQueryTerms | The maximum number of terms to use in the query. |
NumResults | The number of results to return. |
Params | Query action parameters to add. |
PrintFields | The category fields to display in the results. |
Schema | The ID of the category to set as the root for the hierarchy, to restrict the results to this category and its descendants. |
SecurityInfo | The security details for the user that sends the action. |
ShowCategoryPath | Whether to show each returned category in its place in the category hierarchy. |
TaxonomyName | The name of the taxonomy to restrict results to. |
TextParse | Whether to treat the document as XML or IDX. |
Threshold | The relevance threshold of the result categories. |
UserName | The name of the user that sends the action. |
UseSuggestOnText | Whether to send a SuggestOnText action to Agentstore, instead of a Query action. |
Values | Values for the specified Params. |

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

The action requires you to set DocID or DocRef.

© 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