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.)


_HP_HTML5_bannerTitle.htm