CategoryFindByFields

Allows you to specify one or more field names and values to return the IDs of all categories that contain the specified values in the specified fields. The field name matching is case insensitive.

NOTE:

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

Example

http://12.3.4.56:9000/action=CategoryFindByFields&Fields=Author,Country&Values=Rowling,UK

This action uses port 9000 to instruct HPE Category Component, which is located on a machine with the IP address 12.3.4.56, to return the IDs of all categories for which the field Author has the value Rowling and the field Country has the value UK.

Parameters

Parameter Description Required
Fields A comma-separated list of fields to match. Yes. See Comments
TaxonomyName The name of a taxonomy that the category to find belongs to.  
UserName The name of the user that sends the action.  
Values A comma-separated list of field values to match. Yes. See Comments

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 number of field values specified must match the number of field names specified, and the order of the values must match the order of the names.

NOTE:

You create user-defined fields in categories by using the CategorySetDetails action.


_HP_HTML5_bannerTitle.htm