Semantic inline query: verschil tussen versies

Versie van 22 jan 2019 om 17:04

Een semantic inline query (nl: "inline" semantische zoekopdracht) biedt de mogelijkheid om een vaste zoekopdracht in de wikitekst op te nemen en de resultaten automatisch weer te geven. Op deze manier kunnen alle complexe semantische queries uitgevoerd worden, terwijl bezoekers van de wiki-pagina zien alleen de resultaten - een tabel, lijst of ander formaat - zullen zien.

Inhoud

1 Toepassingen
2 Samenstelling van een inline query
- 2.1 Syntax - schrijfwijze van een query
3 Voorbeelden
4 Overig

Toepassingen

Hoewel de lijst van toepassingen erg lang is, een paar veel voorkomende situaties:

Genummerde of ongenummerde lijsten van pagina's die een bepaalde eigenschap hebben
Opnoeming van door komma's gescheiden resultaten
Sorteerbare tabellen met semantische gegevens in rijen en kolommen
Galerie met afbeeldingen die een bepaalde semantische eigenschap hebben
Export-file in diverse formaten (csv, csv, dsv, dsv, json, rdf, rdf) met gegevens die kunnen worden gedownload.

Het aantal toepassingen kan met behulp van de extensie "Semantic Result Formats" aanzienlijk worden uitgebreid. Denk daarbij bijvoorbeeld aan: kalenders en tijdlijnen, geografische kaarten, diverse bestandsformaten, grafieken etc.

Samenstelling van een inline query

Een query bestaat in de basis uit drie onderdelen:

Het selecteren van de set van gegevens, eventueel te onderscheiden als:
1. Kies basis set van objecten; een categorie met pagina's
2. Filter de gewenste items uit de set op basis van eigenschappen
Het bepalen van de weer te geven informatie
Het bepalen van de vormgeving van de geselecteerde gegevens

Voorbeelden:

Selecteer de objecten (pagina's):
1. Uit de categorie "personen"
2. Filter alle personen waarvan de eigenschap "HeeftKleurOgen" is gelijk aan "blauw"
Geef van de geselecteerde personen weer, de waarden van de eigenschappen:
1. "HeeftVoornaam",
2. "HeeftAchternaam" en
3. "HeeftPasfoto"
In de vorm van een brede tabel, van hoogsten 20 regels

Syntax - schrijfwijze van een query

Om een query in wikitekst te maken volg je de bovenstaand drie stappen. De query wordt omsloten door dubbele haken en voorafgegaan door een zogeheten "parserfunction": de opdracht om te zoeken:

{{#ask:
[[Categorie:Personen]]                   <!-- basisset gegevens --> 
[[HeeftKleurOgen::Blauw]]                <!-- filter -->
| ?HeeftVoornaam = Voornaam              <!-- weer te geven eigenschap, incl. "label" -->
| ?HeeftAchternaam = Achternaam          <!-- idem -->
| format = broadtable                    <!-- vorm van de gegevensuitvoer -->
| Mainlabel = Personen met blauwe ogen   <!-- label voor de geselecteerde personen -->
| limit = 20                             <!-- ten hoogste 20 regels -->
}}

NB: Het is niet mogelijk om met VisualEditor queries te maken; gebruik de gewone teksteditor.

Voorbeelden

Voorbeeld "Amsterdam" toevoegen + alternatieven

Voor deze training voor de TheaterEncyclopedie, is een speciale pagina met voorbeelden beschikbaar. Je vindt deze hier.

Overig

Zie ook:

Deze pagina maakt deel uit van een handleiding:
Documentatie op semantic-mediawiki.org

@@ Regel 48: / Regel 48: @@
 * Voorbeeld "Amsterdam" toevoegen + alternatieven
+Voor deze training voor de TheaterEncyclopedie, is een speciale pagina met voorbeelden beschikbaar. Je vindt deze [https://theaterencyclopedie.nl/wiki/TheaterEncyclopedie:Workshop_%22Semantische_queries%22_(2019)/voorbeelden hier].
 == Overig ==