Distributed Index Handler 26.2
Distributed Index Handler Help

# UnknownFieldValueAction

The action that DIH must take if a document contains an unknown value for the distribution field. This option is available in DistributeByFields and DistributeByDate mode.

In DistributeByFields mode, DIH takes the specified action when the fields listed in the DistributeByFieldsCSVs are missing or contain an unknown value.

In DistributeByDate mode, DIH takes the specified action when the date fields are missing, contain a date string that DIH cannot parse, or contain a date value that does not fall into any of the configured date ranges.

You can set `UnknownFieldValueAction` to one of the following values:

- Ignore. DIH logs a warning and ignores the document.

- Default. DIH sends the document to the child server that you set in the UnknownFieldValueDefaultEngine configuration parameter.

- Distribute. DIH uses a hash of the field value to distribute the document, as with conventional field-based indexing. If the field value is missing, DIH distributes documents according to your BalanceDistributeByFields setting.

  NOTE: If you use this option in DistributeByDate mode, DIH routes documents that do not have a valid date as if you are using DistributeByFields on that value.

Type: | String
Default: | Distribute (DistributeByFields mode) Ignore (DistributeByDate mode)
Required: | No
Configuration Section: | Server
Example: | `UnknownFieldValueAction=Distribute`
See Also: | BalanceDistributeByFields DistributeByDate DateRangeN Configuration DistributeByFields DistributeByFieldsCSVs DistributeByFieldsValues UnknownFieldValueDefaultEngine

Copyright 2026 Open Text
Version 26.2 | Last updated April 2026

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: Knowledge Discovery Distributed Index Handler 26.2

Topic Title: UnknownFieldValueAction