Search conditions

You can use the search conditions option to build complex queries by selecting fields, operators, and values. While this feature has the same functionality as the search condition section of the saved search form, it's conveniently available from the Documents tab and Relativity Dynamic Object tabs. This option displays up to five rows, with each row representing a separate criterion. Depending on the type of field you select, different operators appear. You can use this option alone or in conjunction with keyword searches, dtSearches, Analytics, or Cluster visualization. When you use search options in conjunction with another search feature, documents must both meet the search criteria and also the conditions specified.

Note: To use the search conditions option, you must have add or edit permissions for Search and access to the Saved Searches Browser assigned to you through the Security page. See Workspace security.

Setting up search conditions

Setting up search conditions in the Search panel

To set up search conditions in the Search panel follow these steps:

1. Navigate to the Search Builder.
2. Click Add Condition and select the fields to which you want to apply conditions.
   A pop-up window opens for each condition field you select.
3. Set the required conditions in the relevant field pop-up window by selecting the desired field or by choosing a field category and then selecting the desired field. To learn more, visit Field categories.
4. Click Apply.
5. (Optional) Click Add Logic Group to add a logic group. Logic groups are evaluated first, and then connected to other filter conditions or logic groups using AND / OR operators.
6. (Optional) Drag and drop conditions together to create logic groups.
7. (Optional) Add the AND or OR operators to connect the criterion.
8. Click Apply.

If you need to edit the condition, click on the condition card. The pop-up reopens so you can make changes.

Setting up search conditions in the Search browser

To set up search conditions in the Search browser, follow these steps:

1. Click the Saved Search icon to navigate to the Search Browser.
   
2. Click New Search.
3. Click Add Condition and select the fields to which you want to apply conditions.
   A pop-up window opens for each condition field you select.
4. Set the required conditions in the relevant field pop-up window.
5. Click Apply.
6. (Optional) Click Add Logic Group to add a logic group and drag and drop your conditions into the frames. Logic groups are evaluated first and then connected to other filter conditions or logic groups using AND / OR operators.
7. (Optional) Add the AND or OR operators to connect the criterion.
8. Enter all required Fields.
9. Click Save or Save As.

If you need to edit the condition, click on the condition card. The pop-up reopens so you can make changes.

Using the multiple object condition builder

You can set conditions for multiple object fields from a single pop-up window. The following example uses Batch as a multiple object field condition.

To use the multi-object condition builder, follow these steps:

1. Click Add Condition from the Search browser or Search panel.
2. Enter or select Batch.
   The Condition: Batch window opens.

3. Select the desired operator from the Operator drop-down list. For example, these conditions.
4. Click Add Condition.
5. Select the condition from the Add Condition drop-down list. For example, Batch:: Batch Set.
6. Click the available fields from the Available column and move them to the Selected column as desired.
7. Click Apply.
8. (Optional) Click Add Logic Group to add a logic group. Logic groups are evaluated first and then connected to other filter conditions or logic groups using AND / OR operators.
9. (Optional) Drag and drop conditions into logic groups as desired.
10. Click Apply on the Condition: Batch window.
    Relativity applies your search conditions.

For more information about multiple object searching logic, see Multiple object searching.

Canceling queries

You can cancel a long-running search or view by clicking the Cancel button. This link appears when you perform a keyword search, dtSearch, Analytics search, or use Pivot. It also appears when you filter or sort a document or Dynamic Object list. It also appears when you perform other actions on item lists containing documents or Dynamic Objects that initiate a query in the background.

When you click Cancel Request, Relativity stops the background query used to populate documents in an item list. If you edit a search and click this link, your changes save, but the item list doesn't load. For example, your changes save when you perform a mass edit on a list of documents in a search and then click Cancel Request when the query is running to redisplay the updated list.

Note: Relativity creates an audit record in the History tab for canceled queries. The query description displays the running time of the query and indicates that it was canceled. You must have the appropriate permissions to view this tab.

The following table explains different scenarios in which you might cancel a running query and whether the query actually cancels.

Scenario	Result
You start a query and click Cancel Request or Cancel.	The query is canceled.
You start a query and close the browser.	The query is canceled.
You start a query and an system admin resets the IIS on the server.	The query is not canceled.
You start a query and leave your browser idle for longer than the session timeout specified in Relativity web.config, regardless of whether you clicked OK or Cancel on the message from the webpage pop-up.	The query is not canceled.
You start a query and click Cancel on the message from the webpage pop-up within the session timeout specified in Relativity web.config.	The query is canceled.
You start a query and click OK on the message from webpage pop-up within the session timeout specified in Relativity web.config.	The query continues to run. Relativity returns you back to the waiting screen (see the first row of this table).
You start a query and paste a different URL into your browser, or you refresh the page.	The query is canceled.

Frequently asked searching questions

This section includes frequently asked questions from Relativity users.

Multiple terms in dtSearch queries

Proximity searches in dtSearch queries

Using reserved characters in dtSearch queries

Multiple conditions

Nesting searches