Once you have a well defined set of search parameters you may want to save them for future use. Saved queries can be used to generate reminders, keep you informed of progress on artifacts or to quickly access a specific artifact configuration. You may have access to globally available saved queries or create your own.
Saving queries
To create a saved query select define your search parameters (for more information see Advanced queries) and click the Save this query button. Stored queries are accessible through the Query artifacts tab or Saved queries drop down box on the query bar.
When naming your saved queries, the query name should be short and descriptive. The saved query name appears in the Saved queries drop down box on the query bar. You can add a description to further identify your query. The query description appears in the saved query list screen and can help users make a better determination of which query to use.
For example, you have defined several queries that search for artifacts that relate to the AIX operating system. One of your queries specifically look for all new high priority artifacts entered. A second query may search for all closed high priority artifacts. The first query is named AIXopen, the second AIXclosed. You can use the description field to remind yourself that these artifacts are specifically for high priority artifacts.
Before you can save your query you need to determine the availability. Your query can be available only to yourself by selecting "personal" from the drop down list. If you think your query is of value to all members of the project, you can select "project." If you do not have permission to create a project saved query, the query will be submitted to the administrator for approval (see Approval for further information on the approval process).
Click the Save button to complete the saving process.
NOTE: Once a query has been saved, it will not automatically be updated if there is a change to the availability of the search criteria in the project. For instance, if you save a query with specific options selected and the options are removed from the artifact type, the query will return all artifacts that meet the search criteria minus the removed option. Furthermore, if the option is later readded to the artifact type, the query will return no results until a new artifact containing the search criteria is created.
Managing saved queries
Use the Edit saved queries table to manage the saved queries. All available saved queries appear in this table. Click on the Edit link to access the query edit screen. Clicking the query name will execute the query. Clicking on the name in the Initiated by field will provide an email form, using your browsers default email interface.
You can use the buttons to affect multiple queries simultaneously. Use the checkboxes to select the queries you would like to affect.