wiki:Web2/RunningSemanticQueries

Version 2 (modified by manualwiki, 11 years ago) (diff)

--

Running semantic queries

The query bar is located in the upper section of the screen, below the menu. You can construct new queries whenever this bar is enabled.

Constructing semantic queries

To learn more about semantic queries see the Semantic Queries page.

While typing a query the interface offers possible continuations for uncompleted sub-terms. An offered option can be chosen from a drop-down list. The drop-down menu also shows the meaning of the chosen continuation. This auto-complete mechanism helps new RefactorErl users using the language, and also all developers to speed up query constructions and avoiding constructing wrong queries.

Pressing ”Execute” evaluates the query.

Starting queries

A file browser (same as the one on the database page) is placed at the left side of the page. A file can be viewed by clicking on it. You can also filter files in the filter textbox.

If you want to start a query from an exact node in the code, you have two options:

  • You can run any (appropriate) query from a node by right-clicking on it. If you do that, you can choose from various predefined queries, or run a query of your own. If you select a macro, you can also see the value of the macro without running the query!
  • You can simply start the first query of the context menu by double-clicking on a node.

After starting a query, it will appear in the upper right section of the screen. This alert box shows every running, and finished, but unseen queries. If the box show 1/2, it means, that you started two queries, one of which is still running. The other one is finished, but you haven't seen the results yet. The background of the alert box is red, if you have an unseen query. You can see a list of the queries by clicking on this alert box. The list marks running queries with white, and finished queries with grey background.

Previous Queries

For your convenience, the interface stores previously executed queries and their results, which are listed at the rigth side of the page under the ”Queries” tab. You can select any previous query by clicking on the query definition. After this action, you can see the results of this query. The definition appears in the query bar, so you can easily re-eexecute the query by clicking the "Execute" button. Users can delete their own queries from the list by clicking the corresponding "delete" button.