TaxonomyGenerate

Allows you to generate a hierarchical taxonomy from a cluster, or from a set of query results.

NOTE:

This is an administrative action that can be sent only from AdminClients (which are set in the [Server] section of the configuration file).

You can use the WriteTaxonomy parameter to specify whether to write the taxonomy to disk or to add the taxonomy to your category hierarchy.

If you write the taxonomy to disk, HPE IDOL Server stores it as a folder hierarchy in the HIERDOCS subdirectory in the taxonomy directory of your HPE IDOL Server installation. It stores the taxonomy documents in text format. Otherwise, HPE IDOL Server adds the taxonomy to the position in the category hierarchy that you specify with the Parent parameter.

NOTE:

Before you create a taxonomy from HPE IDOL Server, you must make sure that it does not contain duplicate documents or text that is repeated in multiple documents (for example, document headers). Ensure that these are stripped out at the import stage to gain optimal results.

Example

http://12.3.4.56:9000/action=TaxonomyGenerate&Parent=123456789987654321&DREQuery=new+tax+cuts

This action uses port 9000 to send the query new tax cuts to HPE IDOL Server, which is situated on a machine with the IP address 12.3.4.56. HPE IDOL Server uses the results of this query to generate a taxonomy, which it adds to the category hierarchy as a child of the category with the ID 123456789987654321.

Parameters

Parameter Description Required
Cluster The number of the clusters to generate the taxonomy from. See Comments
DREQuery A query to use to generate a taxonomy. See Comments
EndDate A timespan for which to generate a taxonomy from clusters.  
Interval A timespan for which to generate a taxonomy from clusters.  
Name The name of the top level category of the taxonomy to create.  
NumResults The maximum number of documents to store in a taxonomy node.  
Parent The ID of the parent category to use for the taxonomy.  
SecurityInfo Send security details.  
SourceJobName The name of the cluster from which to generate a taxonomy. See Comments
StartDate A timespan for which to generate a taxonomy from clusters.  
WriteTaxonomy Whether to store taxonomy documents.  
XMLEncoding Overrides the default XML encoding.  

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:


_HP_HTML5_bannerTitle.htm