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 configureXML/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.