IDOL Category Component 23.4

# Index a Dummy IDX

If your AgentBoolean expressions contain field restrictions, you might need to index a dummy IDX document to ensure that the IDOL Agentstore component contains all the fields that you use for field restrictions in your agents and categories.

For example, if your agents and categories contain the FieldText expression `MATCH{dog}:Animal10`, Agentstore must include the `Animal10` field to optimize restrictions.

## Determine Whether a Dummy IDX is Required

When you index an agent document, Agentstore attempts to automatically create the fields that you use in your field restrictions in the configured `AgentBooleanCacheField` and `FieldTextCacheField`.

For simple restrictions that do not include wildcards (for example `dog:Animal10`), or that include only a leading `*/` wildcard, Agentstore can create the required fields and you do not need to use a dummy document.

However, if you use wildcards that can expand to different field names (for example `Animal*`), you must use a dummy document to add all the relevant fields to your index.

IMPORTANT: Agentstore creates new fields under any document root fields that exist in the agent index (that is, the current document root and any fields that match `DocumentDelimiterCSVs`).

Agentstore does not add the field to every possible XML field path. For example, if your field restriction contains the `NAME` field, Agentstore does not match a value in `XML/DOCUMENT/USER/NAME`. In this case you can:

- use `USER/NAME` in your restriction (and configure `XML/DOCUMENT` as a document root, if it not already)
- index an XML dummy document that includes `USER/NAME` as a field.

## Create and Index the Dummy IDX

A dummy IDX document contains all fields that you use in field restrictions, with empty values. For example, create a copy of your alert documents, and remove the values from each field. For example:

    #DREREFERENCE dummy document
    #DRETITLE DummyDocument
    #DREFIELD Animal10=""
    #DREFIELD Animal11=""
    #DRECONTENT
    #DREENDDOC

To ensure that Agentstore does not subsequently return the dummy document in queries, index it into the `Deactivated` Agentstore database. You can delete the document after indexing.

NOTE: You must index the dummy IDX before you index or create the agents.

Related Topics

- Manually Create IDX Files

Copyright 2023 Open Text
Version 23.4 | Last updated September 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.4

Topic Title: Index a Dummy IDX