Distributed Action Handler 24.4
IDOL Distributed Action Handler Help

# NOTWILD

The `NOTWILD` field specifier (case sensitive) allows you to find documents in which at least one instance of the specified field contains a value that does not match the specified wildcard string.

If there are one or more instances of a particular field in the document, the document returns as long as at least one instance does not contain the specified string, even if another instance of the field does match. The document does not return if all instances of the specified fields contain the specified string.

If the query does not contain any wildcard characters (`?` or `*`) then the `NOTWILD` field specifier acts in the same way as the NOTMATCH field specifier.

NOTE: You can optimize the field specifier speed by restricting the field to the `MatchType` property type.

## Format

    FieldText=NOTWILD{yourStrings}:yourFields

`yourStrings` | One or more strings containing wildcards. A document returns only if at least one instance of one of `yourFields` does not contain any of these strings. You can specify strings that contain punctuation (but see Note) or consist of several words. NOTE: Strings in the query should be percent-encoded. This ensures that any commas or curly braces that are part of a string are not interpreted as query syntax. If you are sending HTTP requests using the content-type `application/x-www-form-urlencoded` you should then percent-encode all parameter values, meaning that any commas or curly braces that are part of a string are percent-encoded twice (such that a comma is represented by the sequence `%252c`). For more information, see Percent Encoding in Queries.
`yourFields` | Type one or more fields. A document returns only if it contains one of these fields, and if the value in at least one instance of the field does not contain any of `yourStrings`. Separate multiple fields with colons (`:`). There must be no space before or after a colon.

## Example

    FieldText=NOTWILD{passi*incarnata}:Climbers:Plants

At least one instance of the `Climbers` or `Plants` field must contain a value which does not contain a phrase that begins with `passi` and ends with `incarnata` (for example, `passionflower incarnata` or `passiflora incarnata`) for this document to return as a result.

For example, if a document contains only:

    #DREFIELD Climbers="passiflora incarnata"

or

    #DREFIELD Climbers="passiflora incarnata"
    #DREFIELD Plants="passionflower incarnata"

Then it is not returned as a result.

However, if the document contains:

    #DREFIELD Climbers="passiflora incarnata"
    #DREFIELD Plants="passionflower incarnata"
    #DREFIELD Climbers="bindweed"

Then it returns, as one of the `Climbers` fields contains a value that does not match the wildcard string `passi*incarnata`.

NOTE: If you want to find documents in which the specified string is not present in any instance of the specified field, use the WILD specifier with the Boolean operator `NOT`.

For example, `FieldText=NOT+WILD{passi*incarnata}:Climbers` does not return any documents that have a `Climbers` field with a phrase that begins with `passi` and ends with `incarnata`, even if there are other `Climbers` fields with different values.

## See Also

- MATCH Field Specifier

- WILD Field Specifier

Copyright 2024 Open Text
Version 24.4 | Last updated September 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 Distributed Action Handler 24.4

Topic Title: NOTWILD