Structured search

REQ-175

Actors

Name

The structured search uses XPath expressions to search for repository nodes.

Such expressions consist of

  • A node type constraint
  • A path constraint
  • A value constraint, which can be a complex logical expression and include child node values

All parts are optional.

It is possible to specify the columns of the result, according to the selected node type. In addition, ordering of results based on columns can be specified.x

Select the node type

After pressing the node type selector button, a list of available node types will be displayed. Select an entry by double click or by confirming it with the OK button.

Specify the base path

Type the base path directly in the text box or use the ellipsis button to select a repository node.

Specify the value constraint

To specify the value constraint, drag one of the symbols above the value constraint tree into the tree. Symbols are

  • Remove to remove a node
  • And and Or for logical expressions
  • Property to set some property expression. This can be done using the combo boxes at the bottom of the value constraint area.

Specify the result columns

Specify the result columns in the Columns tab. Use the arrow buttons to change columns from the available set to the current set and vice versa.

Specify the result sort order

Use the Sorting tab for this. Again, use the arrow buttons to move columns from the result columns to the ordering area. Use the up and down buttons to change the priority of the ordering, select ascending and descending using the checkboxes.

Check the query in the description area

There is a description area at the bottom of the dialog, which summarizes the current query settings. There are two tabs, Description and XPath. The former is preselected by default and describes the search in human language. The second tab shows the XPath expression, that will be used to query the repository.