Perform a Parametric Search
After you configure the IDOL Content component to index and recognize parametric fields, you can use the following actions to perform a parametric search.
GetTagValues
This action allows you to specify one or more parametric fields and return all values that these fields contain in the IDOL Content component. It includes values in documents that you do not have access to, and values in documents that were deleted (unless you compacted the IDOL Content component data index after the documents were deleted).
For example:
action=GetTagValues&FieldName=Grape
This action requests the different values of the IDOL Content component Grape
fields. It returns a list of all grape varieties stored in an IDOL Content component wine database, for example.
You can also restrict the action, so that it returns Grape
field values only if they are in a document that also contains other specific fields that have specific values. For example:
action=GetTagValues&FieldName=Grape&Restriction=MATCH{Barossa Valley}:Region+MATCH{Red}:Color
This action returns Grape
field values only if they are in a document that also contains a Region
field that has the value Barossa Valley and a Color
field that has the value Red.
GetQueryTagValues
This action combines query text with one or more parametric fields. When Content performs the query, it finds documents that match the specified query text, and returns the values of the specified parametric fields for these documents. Unlike the GetTagValues
action, the GetQueryTagValues
action does not return field values in documents that you do not have access to, or in documents that were deleted.
For example:
http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= Asmooth red wine that complements game
This action requests the different values of the GRAPE
and COUNTRY
fields of documents that are conceptually similar to the specified Text
.
You can also restrict the action by combining it with various action parameters. For example:
http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= Asmooth red wine that complements game&MaxValues=10&Sort=Alphabetical
This action requests the 10 top values of the GRAPE
and COUNTRY
fields of documents that are conceptually similar to the specified Text
. Content displays the values in alphabetical order when it returns them.
http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= Asmooth red wine that complements game&DocumentCount=True
This action requests the different values of the GRAPE
and COUNTRY
fields of documents that are conceptually similar to the specified Text
. The DocumentCount
parameter instructs Content to return the number of documents that contain each value.
http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= Asmooth red wine that complements game&FieldDependence=True
This action requests the different values of the GRAPE
and COUNTRY
fields of documents that are conceptually similar to the specified Text
. The FieldDependence
parameter instructs Content to find sets of values that occur together. If Content finds documents that contain the first parametric field listed, it checks if they also contain the subsequently listed parametric fields and returns them. You can also use the FieldDependenceMultiLevel
parameter to display these results in a hierarchical structure.
For further details on available parameters for the GetTagValues
and GetQueryTagValues
actions, refer to the IDOL Content component Reference.