Running a saved query

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 define your search parameters (for more information see Advanced queries)

  1. 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.

  2. 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.

  3. If you think your query is of value to all members of the project, select "This project."

    If you do not have permission to create a project saved query, the query will be submitted to the administrator for approval.

  4. 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 restored to the artifact type, the query will return no results until a new artifact containing the search criteria is created.

Note: You can copy a query saved under "This Project" and make it a "Personal" one and edit it to meet your requirements.

Related information