Zoeken voor gevorderden


De Aquo-Standaard wordt gepresenteerd in een MediaWiki omgeving. Deze omgeving is een opensource platform die eveneens gebruikt wordt door Wikipedia.

Het voordeel van deze omgeving is dat de informatie vanuit een kennismodel gebaseerd op linkeddata technieken gepresenteerd kan worden naar haar gebruikers. Ook heeft het platform een actieve wereldwijde community van ontwikkelaars, waarvan de Aquo-standaard profiteert.

Achtergrond informatie over de mediawiki omgeving kunt u hier vinden: https://www.mediawiki.org/wiki/MediaWiki De MediaWiki omgeving is één van de onderdelen van wereldwijde doelstelling om educatieve informatie te delen. Dit allemaal opensource en non-profit. https://www.wikimedia.org/

Speciaal:vragen

Om specifieke informatie uit het totaal van de standaard op te vragen, is de Wiki omgeving uitgerust met verschillende tools. In deze instructie gaan we specifiek in op de functie van “Speciaal:vragen”.

Deze functie geeft de gebruiker de mogelijkheid om semantische query’s te maken via een gebruikersinterface. Met deze query’s kunnen vanuit het kennismodel van de Aquo over de totale inhoud van de Aquo onderdelen overzichten gemaakt worden. In deze overzichten hebben we mogelijkheden voor filteringen en het zoeken op deelverzamelingen. Zo kan er gezocht worden naar bv een domeinwaarden die specifiek onderdeel is van een domeintabel.

We onderkennen in de Aquo Wiki omgeving de volgende onderdelen van de Aquo-standaard, nl:

  • Begrippen, kennismodel Begrip
  • Symbolen, kennismodel Symbool
  • Domeintabellen en zijn domeinwaarden. Resp kennismodel Domeintabel en Domeinwaarde
  • Informatie modellen, kennismodel Informatiemodel


Het Speciaal:vragen wordt hoofdzakelijk toegepast op de eerste 3 onderdelen, en in het bijzonder bij de domeintabellen en zijn waarden.

Speciaal:vragen interface

SpeciaalVragenBegin.jpg

Om de functie van speciaal:vragen op te roepen kunt u in de zoekbalk het volgende intypen: speciaal:vragen



Hierna verschijnt de query gebruikers interface waarin je als gebruiker je vraag kunt opbouwen.

SpeciaalVragenQueryScherm.jpg












In het voorbeeld hebben we al een aantal zoek onderdelen ingevuld. De zoekopdracht is als volgt verwoord.

In het onderdeel Voorwaarde geven we aan wat we zoeken, dus in dit geval:

  • We zoeken in [[Categorie:Domeinwaarden]]
  • Waarbij de domeinwaarden onderdeel zijn van een relatie met domeintabel [[Breder::Id-ecbe0e11-3cdc-4661-903f-f9382b32a343]]. De Guid is van de domeintabel naar keuze, in dit voorbeeld Bemonsteringsapparaat
  • De waarden moeten een begin geldigheid hebben van ouder dan 1 januari 2000
  • De waarden moeten een Eind geldigheid hebben van ouder dan 1 juli 2020
  • De waarden hebben een wijzigingsdatum van na 1 juli 2021

Het resultaat van de zoekopdracht laten we vervolgens zien in een weergave met een lijst van informatielabels. Deze labels, die je kunt vinden in het kennismodel van het onderdeel (in dit geval; domeinwaarden), resulteren in de rapportage lijst.

In dit voorbeeld willen we dus het zoekresultaat weergegeven hebben met de kolommen:

  • Voorkeurslabel (GUID van het item weergegeven in de naam)
  • Omschrijving, omschrijving van het label in de domeinwaarde
  • Id, Id code van de domeinwaarde
  • Codes, code van de domeinwaarde
  • Status, is de waarde geldig of vervallen
  • Begin geldigheid, de datum begin van de geldigheid van de waarde
  • Eind geldigheid, de datum waarop de waarde stopt met geldig zijn
  • Wijzigingsdatum “Modification date”, de datum wanneer de laatste aanpassing heeft plaats gevonden op de waarde
  • Gerelateerd, de relatie naar een begrip in het begrippenkader van de aquo


De lijst met “Print selectie” kan aangevuld worden met de waarden zoals in het kennismodel van het betreffende onderdeel zijn verwoord. Bv. Kennismodel domeinwaarde: https://www.aquo.nl/index.php/Domeinwaarde De lijst met eigenschappen zijn de labels die binnen het kennismodel gevuld kunnen worden

Opties:

In het onderdeel opties, kan de gebruiker selecteren op welke wijze hij het resultaat gepresenteerd en beperkt wil hebben. Opties die hierin veelvuldig gebruikt worden zijn:

  • Brede tabel (standaard). De Wiki omgeving kan het resultaat op verschillende manieren presenteren. De meest gebruikte optie is brede tabel. Dit laat het resultaat zien op het scherm. U kunt ook gelijk een download selecteren. Dan krijgt u bv een CSV-bestand met het resultaat. Experimenteer maar met deze selectie en verken de mogelijkheden van de Wiki omgeving maar eens.
  • Sorteeropties. Door het label aan te geven kun je selecteren of je oplopend, aflopend of willekeurig wil sorteren.
  • Limit: beperkt het resultaat van je zoekopdracht. Advies begin altijd met de 250. Bij hoge waardes heeft de Wiki omgeving langere tijd nodig om het resultaat te presenteren. > 2000 geeft een vertraging van minimaal 40 seconde.
  • Offset: bij veel resultaten is het handiger de limit op lage aantallen te laten en de offset in stappen van de limit te verhogen.

Resultaat speciaal:vragen

SpeciaalVragenResultaatScherm.jpg

Hiernaast hebben we een plaatje van het resultaat van de zoek opdracht.

Door op JSON, CSV, RSS of RDF te klikken. Kan het resultaat in respectievelijke vorm worden gedownload.

Wil je deze query bewaren en op een later moment herhalen. Selecteer dan het streepje met onderliggend de twee puntje welke naast het tabblad resultaat staat. Dit start een web pagina op met een URL die het resultaat rechtstreeks laat zien. De URL in je browser kun je vervolgens kopiëren en opnieuw gebruiken op een later moment.

De URL van onze voorbeeldvraag is:

https://www.aquo.nl/index.php?title=Speciaal:Vragen&q=%5B%5BCategorie%3ADomeinwaarden%5D%5D+%5B%5BBreder%3A%3AId-ecbe0e11-3cdc-4661-903f-f9382b32a343%5D%5D%5B%5BBegin+geldigheid%3A%3A%3E1+januari+2000%5D%5D%5B%5BEind+geldigheid%3A%3A%3E1+juli+2020%5D%5D%5B%5Bwijzigingsdatum%3A%3A%3E1+juli+2021%5D%5D%5B%5BStatus%3A%3AG%5D%5D%0A&p=format%3Dtable%2Flink%3Dnone%2Fheaders%3Dshow%2Fsearchlabel%3D%E2%80%A6-20overige-20resultaten%2Fclass%3Dsortable-20wikitable-20smwtable%2Fsep%3D%2C-20&po=%3FVoorkeurslabel%0A%3FOmschrijving%0A%3FId%0A%3FCodes%0A%3FGroep%0A%3FStatus%0A%3FBegin+geldigheid%0A%3FEind+geldigheid%0A%3FModification+date%0A%3FGerelateerd%0A&sort=&order=asc&eq=yes&offset=0&limit=250

Speciaal:vragen, speciale zoek functies

In het stellen van de zoekvragen hebben we nog een aantal speciale functies.

Eigenschappen met waarde: +

Het is mogelijk te zoeken naar een eigenschap dit informatie bevat. Dus als voorbeeld, het zoeken eigenschap “SDN P01 code” waar deze informatie bevat. Dit doen we door in de voorwaarden het volgende op te nemen.

[[SDN P01 code::+]]

Deze voorwaarde geeft als resultaat alle objecten die iets in de eigenschap “SDN P01 code” aan informatie hebben staan. Wat er inhoudelijk staat is niet relevant, je krijgt alle items waarbinnen deze eigenschap gevuld is.

Groter of kleiner dan een waarde: > Of <

Groter of kleiner dan. Deze voorwaarden worden gebruikt bij datum en getallen. In het gegeven voorbeeld hebben we deze functie gebruikt. zie voorbeeld query opbouw.

Zoeken op delen van tekst: ~*tekstdelen*

Bij het zoeken in een eigenschap naar onderdelen van tekst is deze functie te gebruiken. Indien je in de eigenschap Omschrijving zoek naar een deel van een woord ziet dat er zo uit.

[[Omschrijving::~*vis*]]

Deze voorwaarde geeft als resultaat alle omschrijvingen die een deel van het woord “vis” hebben. Dus bv vistrap of vangvis, etc.

Zoeken op twee items

Met het Pipe “of” teken waardoor je zoekt in twee (of meer) elementen.

[[Elementtype::Domeinwaarde || DomeinwaardeTechnisch]]


Zoeken op categorie

Aan de hand van het kennis model, onderkent Aquo de volgende categorieën.

  • Begrippen
  • Sjablonen
  • Domeintabellen
  • Domeinwaarden

Deze categorie is het belangrijkste in de zoekvraag en geeft aan waarbinnen je de zoekopdracht uitvoert.

PAS OP. Bij de categorie wordt er 1 x het : teken gebruikt in de voorwaarde. Bij de volgende zoek voorwaarden op eigenschappen worden er 2 x het : teken gebruikt.

Voorbeelden query's

Zoeken van begrippen

https://www.aquo.nl/index.php?title=Speciaal:Vragen&q=%5B%5BCategorie%3ABegrippen%5D%5D+%0A&p=format%3Dtable%2Flink%3Dnone%2Fheaders%3Dshow%2Fsearchlabel%3D%E2%80%A6-20overige-20resultaten%2Ftheme%3Dbootstrap&po=%3FLabel+%28nl%29%0A%3FLabel+%28en%29%0A%3FLabel+%28de%29%0A%3FSynoniem+%28nl%29%0A%3FSynoniem+%28de%29%0A%3FSynoniem+%28en%29%0A%3FCode%0A%3FAfkorting%0A%3FDefinitie+%28nl%29%0A%3FPublieksvriendelijke+toelichting%0A%3FToelichting+%28nl%29%0A%3FExacte+overeenkomst%0A%3FBijna+overeenkomst%0A%3FBron%0A%3FAfbeelding+van%0A%3FDatum+start%0A%3FDatum+eind%0A%3FDatum+gewijzigd%0A%3FStatus%0A%3FId%0A%3FImport%0A%3FCategorie+van%0A%3FBreder%0A%3FSmaller%0A%3FGerelateerd%0A%3FHeeft+onderdeel%0A%3FGebruikt+voor%0A&sort=&order=&eq=no&offset=0&limit=50

Zoeken van domeintabellen

https://www.aquo.nl/index.php?title=Speciaal:Vragen&q=%5B%5BCategorie%3ADomeintabellen%5D%5D+%0A&p=format%3Dbroadtable%2Flink%3Dnone%2Fheaders%3Dshow%2Fsearchlabel%3D%E2%80%A6-20overige-20resultaten%2Fclass%3Dsortable-20wikitable-20smwtable&po=%3FId%0A%3FVoorkeurslabel%0A%3FToelichting+%28nl%29%0A%3FReden+beeindiging%0A%3FVerantwoordelijke+organisatie%0A%3FURL+Verantwoordelijke+organisatie%0A%3FVervangen+door%0A%3FURL+domeintabel%0A%3FURL+achtergrondinformatie%0A%3FIs+open+domein%0A%3FBegin+geldigheid%0A%3FEind+geldigheid%0A%3FDatum+gewijzigd%0A%3FModification+date%0A%3FXSD%0A%3FMetadata%0A%3FCategorie+van%0A%3FGerelateerd%0A&sort=&order=asc&eq=no&offset=0&limit=500

Zoeken van domeinwaarden van een specifieke domeintabel

https://www.aquo.nl/index.php?title=Speciaal:Vragen&q=%5B%5BCategorie%3ADomeinwaarden%5D%5D+%5B%5BBreder%3A%3AId-ecbe0e11-3cdc-4661-903f-f9382b32a343%5D%5D%5B%5BBegin+geldigheid%3A%3A%3E1+januari+2000%5D%5D%5B%5BEind+geldigheid%3A%3A%3E1+juli+2020%5D%5D%5B%5Bwijzigingsdatum%3A%3A%3E1+juli+2021%5D%5D%5B%5BStatus%3A%3AG%5D%5D%0A&p=format%3Dtable%2Flink%3Dnone%2Fheaders%3Dshow%2Fsearchlabel%3D%E2%80%A6-20overige-20resultaten%2Fclass%3Dsortable-20wikitable-20smwtable%2Ftheme%3Dbootstrap&po=%3FVoorkeurslabel%0A%3FOmschrijving%0A%3FId%0A%3FCodes%0A%3FGroep%0A%3FStatus%0A%3FBegin+geldigheid%0A%3FEind+geldigheid%0A%3FModification+date%0A%3FGerelateerd%0A&sort=&order=asc&eq=no&offset=0&limit=250

Zoeken van sjablonen

https://www.aquo.nl/index.php?title=Speciaal:Vragen&q=%5B%5BCategorie%3ASymbolen%5D%5D+%0A&p=format%3Dbroadtable%2Flink%3Dnone%2Fheaders%3Dshow%2Fsearchlabel%3D%E2%80%A6-20overige-20resultaten%2Fclass%3Dsortable-20wikitable-20smwtable&po=%3FLabel+%28nl%29%0A%3FCodering%0A%3FDefinitie+%28nl%29%0A%3FBegin+geldigheid%0A%3FEind+geldigheid%0A%3FAfbeelding+van%0A%3FWijzigingsnummer%0A%3FBron%0A%3FExacte+overeenkomst%0A%3FKoppeling+DWG%0A%3FKoppeling+DXF%0A%3FRubriek%0A%3FDeel%0A%3FGerelateerd%0A&sort=&order=asc&eq=no&offset=0&limit=500