How to filter and search batches

The batch list has an entry for every batch that has run in the past or is currently running. You can use filtering so that the batch list will only display a subset of the batches based on various criteria. Filtering makes it easy to find batches with a particular name or to find tests in a particular state or condition. You can also use filtering to find batches you want to delete and then delete them in one command (See How to Delete Batches).

You can filter batches by one of three categories either in isolation or combined:

  • Batches whose name contains some text that you provide.
  • Batches whose status is in a given state (one or more of Running, Passed, Failed, Unresolved).
  • Batches that include tests that are in a given state (one or more of Running, Passed, Failed, Unresolved, Diffs, New, Aborted, Changed, Starred, New issues, New Remarks).

Each of the categories can be active or not. The text category is active if it is not empty, the batch and test status are active if the list of states contains at least one required state. Test Manager will display the batches that meet all of the active categories.

In other words, Eyes does an AND on the active categories and an OR on the possible options in each category.

For example, you can ask to see the batches that meet the following criteria:

  • The batch name includes the string "MyBatch"
  • AND  the Batch status is "Unresolved" OR “Failed”
  • AND the Batch has tests with "Diffs" OR tests that "Aborted" OR "Failed."

Setting the filter

To filter the list of batch entries do as follows:

  1. Press the Filter Batches icon in the Batch Control panel.
  2. The Test Manager will then display the Filter dialog.
  3. At the top of the Dialog, there is a text box (where it says Match batch name). If you type any string here, then after you press the Apply button, the batch list will only include batches whose name contains the string you entered.
  4. The four checkboxes underneath the text box allow you to quickly choose to filter by one or more of four common text status values - batches with unresolved tests, batches with failed tests, batches with new tests and batches with unsaved tests.
  5. Underneath the checkboxes, you can click on “More Filters", and can then choose either the Batch status category or the Test status category.
  6. Clicking on one of these will display and allow you to select the options relevant to that category.
    1. For batches
    2. For tests (the list is scrollable and includes Running, Passed, Failed, Unresolved, Diffs, New, Aborted, Changed, Starred, New Issues, New Remarks)
  7. If you want to filter by both categories, then first select one category and choose the options that you want. Then, change the selection to the other category and choose the options of that category that you want.
  8. Underneath the Filter category selection button, Test Manager displays the options you have selected. To the right of each option is an X – if you press it, then that option will be removed from the relevant list.
  9. Once you have set the criteria you want, press "Apply", and Test Manager will update the batch list so that only batches that meet the criteria you chose are displayed.
  10. If instead of clicking "Aply" you click outside of the Filter Dialog, then it will be canceled, and any changes you have made will be discarded.

When you set a filter, Test Manager displays the 30 most recent batches that meet the criteria of the filter. When you scroll down to the end of the list, if there are older batches that meet the filter criteria and are not yet displayed, then you will see a button that says  “Search Beyond <date>” where the <date> is the date when the last batch in the list ran. Press that button, and more entries will be displayed.

Seeing the current filter status

The Test Manager displays two indications in the Batch Management Panel when filtering is active. The words "Filtering is on" appears and the button is highlighted.

Hovering over this field will show the list of test and batch status values that are being filtered for.

If no filter is currently set, then you will see the following.

Changing the Batch Filter

If the filter is on, you can change the current filter by clicking on the button again.

If you have multiple filter criteria, you can quickly remove only one particular criteria by placing your cursor over the "Filtering is on" icon. You will see the list of currently selected test and batch criteria. Click the X to the right of the criteria(s) you want to cancel. The "Apply" and “Cancel" buttons will appear. If you click “Apply” then the batch list is updated to reflect the remaining criteria, if you click “Cancel” then the set of criteria remains as they are at the moment.

Canceling the Batch Filter

If you click the X to the right of the "Filtering is on" icon then filtering will be canceled and the most recent set of batches will be displayed.