Open topic with navigation

# Query with the State Token

When you query IDOL Server, you can use the `StateID`, `StateMatchID`, and `StateDontMatchID` parameters to pass a state token. These parameters are similar to the `ID`, `MatchID`, and `DontMatchID` parameters that specify individual document IDs.

Action | State parameters supported
--- | ---
`GetQueryTagValues` | `StateMatchID`, `StateDontMatchID`
`GetContent` | `StateID`
`List` | `StateMatchID`, `StateDontMatchID`
`Query` | `StateMatchID`, `StateDontMatchID`
`Suggest` | `StateID`, `StateMatchID`, `StateDontMatchID`
`SuggestOnText` | `StateMatchID`, `StateDontMatchID`
`Summarize` | `StateID`
`TermGetBest` | `StateID`

If you use `StateMatchID` and `StateDontMatchID` in the same action, IDOL removes any documents in the `StateDontMatchID` list from the `StateMatchID` list.

Examples:

- Retrieve all documents. Use the `StateID` parameter to retrieve all documents in the token:

      action=GetContent&StateID=CWQ4FJ9LZSE5-6

- Query only the specified documents. Use the `StateMatchID` parameter to, for example, query only the first four documents in the stored result set:

      action=Query&Text=pear&StateMatchID=CWQ4FJ9LZSE5-6[0-3]

- Query all but the specified documents. Use the `StateDontMatchID` parameter to, for example, query all IDOL Server content except for the documents specified in the token:

      action=Query&Text=pear&StateDontMatchID=CWQ4FJ9LZSE5-6

Note: A stored-state-aware DAH forwards any query that includes a state token to the IDOL Server that originally created the token.

© 2016 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close We welcome your comments! To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm