AAT (NL) WO2-thesaurus (NL) AAT-service (En) Adlib Gebruikersgroep

Webservice van de Adlib Gebruikersgroep

Adlib is software voor collectie-registratie. De Alib Gebruikersgroep is een vereniging van mensen en instellingen die gebruik maken van die software.

Getty Vocabularies AAT in Adlib XML

Door middel van deze webservice kun je thesaurustermen in Adlib ontlenen en/of aanvullen met informatie uit de Art & Architecture Thesaurus.

De service is bedoeld als een zogenaamde Advanced External Source in Adlib. Om die te kunnen gebruiken, zijn aanpassingen in je Adlib-applicatie nodig. In dit document is beschreven hoe je die aanpassingen kunt maken.

Wat doet het?

Hoe het werkt voor gebruikers is te zien in deze video.

Wat moet je aanpassen in Adlib?

In dit document (Engels) is beschreven hoe je Adlib kunt aanpassen. Enige bekendheid met de bediening van Adlib Designer is noodzakelijk.

Hoe ziet een query-URL eruit?

De basis-URL voor de AAT-webservice is

http://service.adlibug.nl/aat/search?term=

Een zoekopdracht heet een query-URL, die ziet er zo uit:

http://service.adlibug.nl/aat/search?term=fiets

Probeer het maar! Standaard zoekt de service naar Nederlandse termen. Engels, Frans en Duits zijn ook mogelijk. Dat kun je opgeven in de query-URL:

http://service.adlibug.nl/aat/search?term=bicycle&lang=en

http://service.adlibug.nl/aat/search?term=bicyclette&lang=fr

http://service.adlibug.nl/aat/search?term=fahrrad&lang=de

In Adlib Designer geef je de external source voor je termen (bijvoorbeeld Objectnaam, Object categorie of Trefwoord) voor elk veld in tabblad Linked field properties, box External sources, veld Path to URL. Voor Nederlands geef je dit:

http://service.adlibug.nl/aat/search?term=%data%

Voor Duits zou je dit doen:

http://service.adlibug.nl/aat/search?term=%data%&lang=de

Merk op dat er geen aanhalingstekens om %data% nodig zijn, en ook geen '*' erachter om rechtstruncatie af te dwingen. Dit doet de service vanzelf al. Dus als je zoekt op 'crystol' krijg je 'crystolea', 'crystoleum' en 'crystoleums'.

Welke velden kan de service geven?

Het antwoord op deze query kan onderstaande velden bevatten.

veldnaam inhoud standaard Adlib tag
term de gevonden term ja te
source.number URL en URI4 van de term in Getty Vocabularies ja, zie 1a. tn
term.number URL en URI4 van de term in Getty Vocabularies ja, zie 1b. tn
Getty_ID URI4 van de term in Getty Vocabularies nee, zie 1c.
Getty_url URL4 van de term in Getty Vocabularies nee, zie 1c.
source 'Getty Vocabularies AAT, CC-BY license', altijd ja br
scope_note Scope note ja sn
history_note historische notitie ja hn
term_type Soort term in Getty Vocabularies nee, zie 2.
term_type_uri link naar Soort term in Getty Vocabularies nee, zie 2.
broader.term Preferred broader term van de gevonden term in Getty Vocabularies ja, zie 3. bt

noten

  1. Deze URL is een unieke, persistente identifier in de vorm van een internet-link naar het Getty ID voor de term. In welk veld zet je die?
    a. Applicatie-versie 4.5 heeft standaard een veld source.number met tag tn van het data-type Application.
    b. Applicatie-versies 3.4 en 4.2 bevatten standaard het veld term.number met tag tn, van het data-type Text. Meestal wil je een hyperlink aanklikbaar hebben, dus dan moet het data-type van dat veld Application worden.
    c. Als je ervoor kiest om in je thesaurus een aparte veldgroep aan te maken voor deze velden, dan moet je in de data dictionary het Engelstalige URL-veld Getty_ID noemen in de data dictionary.

  2. Adlib bevat een veld soort term (term.type) voor het domein van de term (bijvoorbeeld vervaardiger of materiaalsoort). In Getty Vocabularies heeft term_type eerder de functie van term status, maar de waardes daarvan komen niet overeen met die in Adlib. Daarom is dit veld wel bruikbaar ter oriƫntatie, maar minder geschikt om over te nemen in Adlib. Hetzelfde geldt voor term_type_uri.

  3. Of je Getty's Broader Preferred term al dan niet moet overnemen in je eigen thesaurus, hangt sterk af van je collectie.

  4. Gemakshalve noemen we een 'URL' human-readable, en een 'URI' machine-readable. De service geeft beiden.

Hoe werkt het?

Zie onderstaand plaatje. Het begint met een term die je invoert in een thesaurus-veld in Adlib. De service verpakt die term in een SPARQL-query-url, en stuurt die naar de AAT van het SPARQL-endpoint van Getty Vocabularies. Die geeft antwoord in json. De service zet dat antwoord om in Adlib-XML. Daarmee zijn velden in het antwoord direct bruikbaar in Adlib.

Hoe werkt de service

Colofon

Met dank aan het support team van het Getty Vocabularies Project en aan de overige leden van het bestuur van de Adlib Gebruikersgroep.

De code voor dit project is open source software, beschikbaar via Github onder een GNU General Public Licentie versie 3.0.