Perform a Parametric Search

After you configure HPE IDOL Server 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 HPE IDOL Server. It includes values in documents that you do not have access to, and values in documents that were deleted (unless you compacted the HPE IDOL Server data index after the documents were deleted).

For example:

action=GetTagValues&FieldName=Grape

This action requests the different values of the HPE IDOL Server Grape fields. It returns a list of all grape varieties stored in an HPE IDOL Server 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 HPE IDOL Server 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= A smooth 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= A smooth 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. HPE IDOL Server displays the values in alphabetical order when it returns them.

http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= A smooth 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 HPE IDOL Server to return the number of documents that contain each value.

http://localhost:5552/action=GetQueryTagValues&FieldName=GRAPE,COUNTRY&Text= A smooth 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 HPE IDOL Server to find sets of values that occur together. If HPE IDOL Server 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 HPE IDOL Server Reference.


_HP_HTML5_bannerTitle.htm