Hoe kan ik gegevens uit de databank opzoeken?

Zoeken in de databank gebeurt via Elasticsearch, een flexibel en schaalbaar platform dat is ontworpen voor snelle en efficiënte zoekopdrachten en analyses van uitgebreide datasets.

Ongefilterde zoekopdracht

Op https://data.archiefpunt.be/ vind je welke entiteiten en codetabellen je kan raadplegen.

Op https://data.archiefpunt.be/archieven kun je bijvoorbeeld alle archieven ophalen. De resultaten worden per 20 per pagina weergegeven. Onderaan de pagina staan links om de rest van de resultaten te raadplegen.

Gefilterde zoekopdracht

De API biedt twee URL-paden met elk hun eigen zoekdomein.

1. _search om gefilterd entiteiten op te zoeken.
2. _codetable om gefilterd codetabellen te doorzoeken.

De syntax van een gefilterde zoekopdracht is:

https://data.archiefpunt.be/{{PAD}}?query={{INDEX}}:{{ZOEKTERM}}

Wildcard zoeken

Je kunt ook asterisken (*) gebruiken als wildcard in zoekopdrachten in _search. Dit wordt aangeduid als "wildcard-zoeken" of "jokerteken-zoeken". Het asterisk-teken fungeert als een wildcard en kan elke combinatie van tekens vervangen, waardoor je flexibeler kunt zoeken.

Stel dat je in een zoekopdracht documenten met de term "boek" als onderwerp wil vinden, maar je bent ook geïnteresseerd in varianten zoals "boeken", "boekje", enzovoort. Met behulp van een asterisk als wildcard kun je een bredere zoekopdracht uitvoeren. Je kan asterisken voor en/of achteraan je zoekterm plaatsen.

Bij het doorzoeken in _codetable wordt automatisch een wildcard-zoekopdracht uitgevoerd, dus je hoeft zelf geen asterisken toe te voegen.

Voorbeelden van zoekopdrachten

De zoekopdracht https://data.archiefpunt.be/_search?query=onderwerp:boek*, levert bijvoorbeeld volgende entiteiten op, die een onderwerp met "boek" bevatten:

De zoekopdracht https://data.archiefpunt.be/_codetable?query=onderwerp:boek, levert bijvoorbeeld volgende waarden met betrekking tot "boek" uit de codetabel "onderwerp" op:

Search

Via _search kun je entiteiten in de databank op te zoeken. Het basisendpoint hiervoor is https://data.archiefpunt.be/_search. Als je hulp of voorbeelden nodig hebt tijdens het opzoeken, kun je altijd terecht op https://data.archiefpunt.be/_search/help.

Beschikbare indexen en voorbeelden

• Any - deze index zoekt op alle velden - https://data.archiefpunt.be/_search?query=any:gent
• Beheerder - https://data.archiefpunt.be/_search?query=beheerder:dirk
• Beschrijvingsniveau -
• Datering systematisch -
• Geografie - https://data.archiefpunt.be/_search?query=geografie:antwerpen
• ID - https://data.archiefpunt.be/_search?query=id:7695-4915-D92F-1960-BCA125202AE9
• Identificatienummer - https://data.archiefpunt.be/_search?query=identificatienummer:BE/361888/JA
• Materiaal -
• Onderwerp - https://data.archiefpunt.be/_search?query=onderwerp:*water*
• Record type -
• Samensteller - https://data.archiefpunt.be/_search?query=samensteller:maria
• Titel - https://data.archiefpunt.be/_search?query=titel:rome 

Codetable

Via _codetable kun je codetabellen in de databank doorzoeken. Het basisendpoint hiervoor is https://data.archiefpunt.be/_codetable. Als je hulp of voorbeelden nodig hebt tijdens het opzoeken, kun je altijd terecht op https://data.archiefpunt.be/_codetable/help.

Beschikbare indexen en voorbeelden

• Any - deze index zoekt in alle codetabellen -
• Aangroei - https://data.archiefpunt.be/_codetable?query=aangroei:dynamisch
• Beschrijvingsniveau - https://data.archiefpunt.be/_codetable?query=beschrijvingsniveau:reeks
• Functie -
• Gebruiksgroep -
• ID - https://data.archiefpunt.be/_codetable?query=id:E04B-5382-F907-A870-BF4C1550CTON
• Materiaalsoort - https://data.archiefpunt.be/_codetable?query=materiaalsoort:papier
• Onderwerp - https://data.archiefpunt.be/_codetable?query=onderwerp:muziek
• Ordeningsstatus - https://data.archiefpunt.be/_codetable?query=ordeningsstatus:niet%20geordend
• Periode - https://data.archiefpunt.be/_codetable?query=periode:18de
• Raadplegingsstatus - https://data.archiefpunt.be/_codetable?query=raadplegingsstatus:vrij%20raadpleegbaar
• Rechtenstatus - https://data.archiefpunt.be/_codetable?query=rechtenstatus:cc0
• Rol beheerder - https://data.archiefpunt.be/_codetable?query=rol_beheerder:bewaarinstelling
• Rol samensteller - https://data.archiefpunt.be/_codetable?query=rol_samensteller:verzamelaar
• Taal - https://data.archiefpunt.be/_codetable?query=taal:nl
• Type agent - https://data.archiefpunt.be/_codetable?query=type_agent:persoon
• Type concept - 
• Type identificatienummer - https://data.archiefpunt.be/_codetable?query=type_identificatienummer:inventarisnummer
• Type naam - https://data.archiefpunt.be/_codetable?query=type_naam:voorkeursnaam
• Type vergelijking - https://data.archiefpunt.be/_codetable?query=type_vergelijking:conditie%20en%20compleetheid
• Type waarde - https://data.archiefpunt.be/_codetable?query=type_waarde:wetenschappelijk