Skip to content

Commit

Permalink
refine draft
Browse files Browse the repository at this point in the history
  • Loading branch information
rpietzsch committed Aug 1, 2023
1 parent f1622e5 commit 882efaa
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 9 deletions.
Binary file modified docs/explore-and-author/query-module/Queries.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 6 additions & 9 deletions docs/explore-and-author/query-module/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,10 +20,9 @@ The catalog lists all existing SPARQL queries including name, type and descripti

Use the **:eccenca-operation-search: Search** bar in order to look for a specific query.

![image](query-catelog.png)

Select the query from the Queries catalog, to open and load the query. 
![](Queries.png){ class="bordered" }

Select the query from the Queries catalog, to open and load the query.

## Query editor

Expand All @@ -35,7 +34,7 @@ The query editor features SPARQL syntax highlighting and SPARQL validation, allo

The Query editor allows to Run query, Download Results, Delete, Save and Save as Queries.

![](./QueryEditor.png)
![](./QueryEditor.png){ class="bordered" }

### Run a query

Expand All @@ -44,9 +43,9 @@ The results are presented as a table with pagination.

### Export results

To export the full set of results without any limits in form of a CSV file click **:eccenca-item-download: Download result** on the top right. 
To export the full set of results without any limits in form of a CSV file click **:eccenca-item-download: Download result** on the top right.

![](./QueriesResults.png)
![](./QueriesResults.png){ class="bordered" }

!!! info

Expand All @@ -58,7 +57,6 @@ To export the full set of results without any limits in form of a CSV file click
To save a query in the Query catalog click **:material-floppy: Save**.
This opens a dialog that allows you to overwrite the existing query.


### Placeholders

In addition to the standard SPARQL syntax, placeholders can be used to parametrize a query.
Expand All @@ -67,7 +65,7 @@ Multiple placeholders can be defined by changing the name inside the brackets.

When a query contains a placeholder, the placeholder list to the right of the query editor shows a field with its name.

![](./placeholder.png)
![](./placeholder.png){ class="bordered" }

When running a query that contains placeholders, the query editor replaces the `{{placeholdername}}` string in the query with the respective string entered into the placeholder list.
This is a direct string replacement, so placeholders can contain simple strings and literal values, URIs, variables or even sub queries.
Expand All @@ -86,4 +84,3 @@ When you enter `Person` into the `class` placeholder field in the placeholde
```sparql
SELECT * WHERE { ?classInstance a <http://dbpedia.org/ontology/Person> .}
```

Binary file not shown.

0 comments on commit 882efaa

Please sign in to comment.