IDOL Category Component 23.2

# All Field Instances Match a Specified String or Number

You can use the following field specifiers (case sensitive) to return documents with multiple instances of the same fields and all field instances contain a specified string or number.

## MATCHCOVER

The `MATCHCOVER` field specifier (case sensitive) allows you to find documents in which the values in all instances of a specified field have matches in the set of values provided in the specifier. In other words, the specifier must cover all instances of the field. A search that uses `MATCHCOVER` is slower than one that uses `MATCH`.

NOTE: You can optimize the field specifier speed by restricting the field to the `MatchType` and `CountType` property types. You must specify both property types.

    FieldText=MATCHCOVER{yourStrings}:yourField

where:

`yourStrings` | is one or more strings. A document returns only if the value in each of its instances of `yourField` matches one of the strings in `yourStrings`. Separate the strings with commas (there must be no space before or after a comma). `FieldText` queries which include commas and braces within the query have specific percent-encoding requirements. For information about percent-encoding, see FieldText.
`yourField` | is the name of the field to match against. A document returns only if: it contains one or more instances of the field and the value of each instance is found in `yourStrings`. it does not contain the field at all.

Example:

    FieldText=MATCHCOVER{Confidential,Secret,TopSecret,FBI}:SECURITYLEVEL

For a document to return as a result, its `SECURITYLEVEL` fields must not contain any values that are not in the specified list. For example, if a document includes a `SECURITYLEVEL` field with the value MI5, it does not return. (If a document has no `SECURITYLEVEL` field at all, it returns.)

## EQUALCOVER

The `EQUALCOVER` field specifier (case sensitive) allows you to find documents in which the values in all instances of a specified field are found in the set of values provided in the specifier. In other words, the specifier must cover all instances of the field.

NOTE: You can optimize the field specifier speed by restricting the field to the `NumericType` and `CountType` property types. You must specify both property types.

    FieldText=EQUALCOVER{yourValues}:yourField

where:

`yourValues` | is one or more numeric values. A document returns only if the value in each of its instances of `yourField` equals one of the values in `yourValues`. Separate the numbers with commas (there must be no space before or after a comma). `FieldText` queries which include commas and braces within the query have specific percent-encoding requirements. For information about percent-encoding, see FieldText.
`yourField` | is the name of the field to match against. A document returns only if: it contains one or more instances of the field and the value of each instance equals a value in `yourValues`. it does not contain the field at all.

Example:

    FieldText=EQUALCOVER{9,10,11,12}:GRADELEVEL

For a document to return as a result, its `GRADELEVEL` fields must have no values that are not in the specified list. For example, if a document includes a `GRADELEVEL` field with the value 8, it does not return. (If a document has no `GRADELEVEL` field, it returns.)

Copyright 2023 Open Text
Version 23.2 | Last updated March 2023

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL IDOL Category Component 23.2

Topic Title: All Field Instances Match a Specified String or Number