Using the sample queries

Sample queries gather a broad range of artifacts, from all artifacts to only one kind, such as change management or requirements management. Queries are written in the SPARQL query language, which is used to find linked data. You do not need to know SPARQL to use sample query, but you do need it to create or modify queries.

Before you begin

Sample queries are available in the Queries page. Click the Shared Queries tab and then open the Sample folder.

If you do not see the Sample folder in the Shared Queries tab, talk to your administrator. If samples are missing, your administrator might need to deploy the content package. If you are responsible for deploying the content package, see Deploying a content export package.

About this task

If you require custom queries, consider these points.

Procedure

  1. In the main menu, click Queries and then select Browse > Shared Queries.
  2. To view the sample queries available for your use, open the Sample folder in the Shared Queries screen.

    For a description of each query, see Predefined queries overview.

  3. Run a query by clicking the one that best fits your needs.
  4. Some queries have parameters that you must supply before the query is run. Enter the values in the Assign Values to Query Parameters dialog box.

    After entering the parameter values, you can run the query, or you can click Save as to save a copy of the query with your parameter. Give the newly copied query a descriptive name and save it to your private folder (My Queries). You can run the new query without being prompted for values.

  5. After you run a query, if you do not receive the query results that you expected, talk to your team's query author.

    To troubleshoot the query, authors can start by viewing the SPARQL query that was run by the index. They can run the query and then click the Show the SPARQL query used to produce the query results icon in the upper right to troubleshoot.

    If you use one or more parameters in your query, read about a known issue.

  6. The Query Result page shows the artifacts that are retrieved by the query. Act on the artifacts in the Query Result page.
    • 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.

    In version 4.0.6 and later, you can download the query as a .csv spreadsheet by clicking the Download as Spreadsheet icon in the upper right.

What to do next


Feedback