Query Manipulation Server 26.3
Query Manipulation Server Help

# Dynamic Promotion Rules

The table shows all the fields that you must include in the IDX file for dynamic promotion rules.

Required IDX fields for dynamic promotion rules

Field | Description | Content type or value
--- | --- | ---
`#DREREFERENCE` | The reference for the rule. | String
`#DRETITLE` | The title of the rule. | String
`QMSTYPE` | The type of the QMS rule. | `3`
`QMSAGENTBOOL` | The AgentBoolean expression used to match the original query text. | Boolean matching expression
`QMSFIELDTEXT` | The FieldText rules to match the original query text. | FieldText expression
`PROMOTION_NAME` | The value that QMS must return in the `autn:promotionname` tag. Data Admin uses this field value as the promotion type. Use one of the following values: Top Promotions. A list of documents that are being promoted internally. Top Promotions are not advertisements. Sponsored. A paid advertisement. Hotwire. Promoted documents that are shown at the top of a results list for a particular keyword, but are noticeably distinct from the list. | String
`QMSUSERTYPE` | The value that QMS must return in the `autn:usertype` tag. | String
`DYNAMIC_QUERY_TEXT` | The query text to send for additional promotions. | String
`FIELDTEXTRESTRICTION` | The optional field text restriction for the query to send for additional promotions. | Percent-encoded string.
`FIELD_CRITERIA_DATABASEMATCH` | (Optional) The Content databases that this rule matches. If you include this field, QMS returns the promotions for this rule only if the original query includes a `DatabaseMatch` parameter with at least one database that matches the `FIELD_CRITERIA_DATABASEMATCH`. QMS applies this field only when the original query includes the `DatabaseMatch` action parameter. | String
`DYNAMIC_DATABASEMATCH` | The databases to query for additional promotions. | String
`QMS_SCOPE_RULE` | (Optional) You can use this field with the `PromotionsScope` query parameter to return only promotions that match the text that you specify as the scope rule. This allows you to filter the list of returned promotions by user-defined criteria such as a specific department or job function. | String list. Separate items in the list with a comma.

You must also add the `ALWAYSACTIVE` field with the value `True`, or a `SCHEDULE` field with iCalendar data. See Create a QMS Rule IDX Document.

Related Topics

- Create Query Manipulation Server Rules
- Create a QMS Rule IDX Document
- Scope Rules

Copyright 2026 Open Text
Version 26.3 | Last updated July 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 Query Manipulation Server 26.3

Topic Title: Dynamic Promotion Rules