Open topic with navigation

# Query with the State Token

When you query the IDOL Content component, 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, Content 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 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 Content component that originally created the token.

© 2018 EntIT Software LLC, a Micro Focus company | Send documentation feedback to Micro Focus Close Send documentation feedback 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 swpdl.idoldocsfeedback@microfocus.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_FT_HTML5_bannerTitle.htm