IDOL Category Component 24.2

# 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

The `GetTagValues` 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

The `GetQueryTagValues` 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= 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`. Content 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 Content 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 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.

Related Topics

- Display Online Help

Copyright 2024 Open Text
Version 24.2 | Last updated March 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL IDOL Category Component 24.2

Topic Title: Perform a Parametric Search