Squish has three kinds of searches available; built-in searches, keyword searches and searches you create on the Search screen.
The home page provides access to several built-in searches. Some of these searches are available through the Reports menu and some are available through links at the top of the lists on the project Home page, which can be modified through the Edit link in the title bar. The searches in the Reports menu cannot be modified. The searches that appear in the body of the Home page on the Search page and which searches appear can be changed when viewing the search results.
Clicking the link opens the search results table on the Search screen. Issues in the results table are sorted by Date Last Modified, by default with the most recent being first. Each of the built-in searches is described below.
On the Title Bar:
- Total Issues - The link for Total Issues displays the results table for all issues (both non-confidential and confidential) that have been entered into the project. This statistic and its results table include both resolved and unresolved issues.
- Unresolved Issues - The link for Unresolved Issues displays the results table including all unresolved issues (both non-confidential and confidential).
- Unresolved Issues Assigned to Me - Clicking this link opens the result table of unresolved issues that are assigned to you. This links to the same results table as the link to the title of the Unresolved Assigned to Me list that appears below the statistics bar.
On the Project Navigation Bar:
- Recently Updated Issues - Clicking on this link, opens the result table of all issues for the project that have had recent activity, regardless of their status. The issues are listed in order of Date Last Modified, with the most recent date at the top. To open an issue, click on the Issue ID or Subject.
- Unresolved Issues Assigned to Me - Clicking this link opens the results table of unresolved issues that are assigned to you. This links to the same results table as the link Unresolved Assigned to Me that appears above in the statistics bar.
Note: My Watch List does not link to a results table. The issues that you have selected for your watch list appear in the list on the home page.
Keyword searches can be done from the box on the right side of the project navigation bar on any project screen. Type one or more words in the field with spaces between the words and press Enter or click the magnifying glass icon. The search treats multiple words as an AND search, where all words must appear in the issue. If you want to search for a phrase (words appear together and in the specified order), enclose the words in quotes.
You can also search by Issue ID by typing the ID in the field and pressing Enter or clicking the magnifying glass icon. If you would like to search for multiple IDs, type the IDs with a comma followed by a space between them.
If you entered an Issue ID and that number does not also appear in other issues, that issue will be displayed. If you entered one or more keywords, the Search screen will be displayed with a table listing the search results.
Creating your own search
The Search screen is reached by selecting Search from the navigation bar or by clicking one of the built-in searches on the Home page. The Search page for each project has:
- A search field on the title bar.
- A list of searchable fields at the left of the screen with selectable criteria.
- A dropdown list in the title bar of Recent Searches.
Notes: You can run an existing saved search from the Search menu or a recent search by selecting the name from the Recent Searches dropdown list.
You can create a new search by using any combination of variables available on the Search screen.
- Select an operator from the dropdown list next to the field you want to search on and enter the value in the text field to search for issues on.
- Multiple search criteria can be added.
- Text fields are filled by keying in the value.
- Drop-down lists are used by selecting the values. Multiple vales that appear in order can be selected by selecting the first value and dragging the mouse down over the other values, or by holding down the Shift key and selecting the first and last values. Multiple values that are not in order can be selected by holding down the Ctrl key and clicking on the desired values.
- Date fields can be filled in by keying in the date or by selecting the date from the Calendar control.
- Mark the Show only issues on my watchlist checkbox if you only want to return issues on your watchlist which also match the search criteria.
- If needed, select an option for grouping the results from the Group by dropdown list.
- Select an option from the Results per page dropdown list.
- Use the checkboxes to include those fields you want to appear in your results and to remove those fields that you don't want to see.
- Click on the Search button at the bottom of the screen to run your search.
- Search results are displayed in a table with links to individual issues. You can change the sort in the table by placing the mouse pointer over a column title until the title is underlined and then clicking on the title. The arrow in the column header will show which column is being sorted and whether the sort is ascending or descending. Click the column title again to switch the direction of the sort.
- Note: Columns based on lookups will sort following the order specified in the Lookups tables.
Once you have the results you can click the Actions menu on the search bar or update the search parameters to make further use of the search results.