Querying for artifacts using predefined queries

Use predefined queries to gather a set of artifacts. You might need to look at all the work items for your product to assess how well the team is progressing. A query can build such a list of artifacts.

Before you begin

If your team is new to this tool, your shared queries list might show the sample and artifact elements queries only. Talk to your team lead or product manager about creating shared queries for your product.

Procedure

  1. In the main menu, click Queries > Shared Queries or Artifact Elements Queries.
  2. Start the search by clicking the query.
    • In the Shared Queries screen, click the query you want to run.
    • In the Artifact Elements Queries screen, click the query you want to run. In the Assign Values to Query Parameters dialog box, select an artifact parameter to customize the query results by clicking the pencil icon. Specify as many parameters as you need to customize the query results.

    The artifacts gathered by the query are displayed in the Query Result screen.

  3. Hover over an artifact to read details.
  4. Act on an artifact by clicking it and selecting a choice:
    • Open Artifact starts the native tool that the artifact was created in and displays the artifact in the tool. You can then modify the artifact and save it.
    • Show Properties displays the properties of the artifact in a results window.
    • Start Analysis loads the default impact analysis profile. Click Run to start the analysis.
    • Open View starts a view selector where you can choose a view to visualize the query results.

What to do next


Feedback