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).
http://12.3.4.56:9000/action=CategoryFindByFields&Fields=Author,Country&Values=Rowling,UK
This action uses port 9000
to instruct IDOL 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
.
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. |
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.
|