Semantic inline query

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.

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 inline query is een formele, gestructureerde manier om een vraag te stellen aan Semantic MediaWiki. Een query bestaat in de basis uit drie onderdelen:

1. 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
2. Het bepalen van de weer te geven informatie
3. Het bepalen van de vormgeving van de geselecteerde gegevens

Voorbeelden:

1. Selecteer de objecten (pagina's):
   1. Uit de categorie "personen"
   2. Filter alle personen waarvan de eigenschap "HeeftKleurOgen" is gelijk aan "blauw"
2. Geef van de geselecteerde personen weer, de waarden van de eigenschappen:
   1. "HeeftVoornaam",
   2. "HeeftAchternaam" en
   3. "HeeftPasfoto"
3. 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