nl-digigo / NLCS

Technische documentatie en issues NLCS
Creative Commons Attribution 4.0 International
4 stars 0 forks source link

Handvaten bieden voor developers om sparql-query's te gebruiken #200

Closed ElisabethKloren closed 5 months ago

ElisabethKloren commented 11 months ago

Handvaten bieden voor developers om sparql-query's te gebruiken, voor instappende developers in de linked data wereld?

ElisabethKloren commented 11 months ago

Hulp gevraagd aan mijn technische collega's Ik testte onze query’s die hier staan in https://data.europa.eu/sparql maar dat werkte niet met deze static URL: https://hub.laces.tech/digitalbuildingdata/nlcs/acceptance/nlcs-acceptatie/versions/v5_0 of deze dynamic url https://hub.laces.tech/digitalbuildingdata/nlcs/acceptance/nlcs-acceptatie.

ElisabethKloren commented 11 months ago

Redmer zegt:

  1. Het SPARQL endpoint van Data.Europa doorzoekt alleen hun eigen database; de Default Data Set Name (Graph IRI) die erboven staat gebruik je niet om een ander endpoint aan te spreken.
  2. In plaats daarvan maak ik gebruik van YasGUI, een openbron SPARQL query editor in je browser.
  3. Met YasGUI kun je wel een SPARQL-API-endpoint aangeven.
  4. Het SPARQL/API-endpoint van de Laces repo's is https://hub.laces.tech/digitalbuildingdata/nlcs/acceptance/nlcs-acceptatie/versions/v5_0/sparql of https://hub.laces.tech/digitalbuildingdata/nlcs/acceptance/nlcs-acceptatie/sparql. Dus nog met /sparql achter de repo-naam.
  5. Er is geen authenticatie nodig.
  6. Resultaat: https://api.triplydb.com/s/Kp7yXCJS0. Deze query is QueryLijntypes.rq uit de GitHub-repo. Je kunt je SPARQL query als POST of als GET versturen naar Laces, zie https://www.w3.org/TR/2013/REC-sparql11-protocol-20130321/#query-via-get e.v. of hoe een softwarelibrary dat doet. Laces ondersteunt een subset van de querytypen, te controleren via https://docs.laces.tech/ldp/12.0.0/querying.html.
ElisabethKloren commented 11 months ago

Gebruiker vraagt: Maar toch alvast vraag, ik zou een query willen maken om een lijsje met de Discipline’s op te halen. Kan ik ergens de inhoud van de database bekijken? Hoe weet ik wat de ‘kolomnamen’ zijn?

ElisabethKloren commented 11 months ago

Redmer zegt: Er zijn geen kolomnamen per se, maar je kunt wel exploratieve vragen stellen om jezelf een indruk te geven van welke predicaten, welke klassen voorkomen: • SELECT DISTINCT ?class WHERE { [] rdf:type ?class . } • SELECT DISTINCT ?predicate ?type WHERE { [] ?predicate ?value . bind( datatype(?value) as ?type ) } • en met SELECT * WHERE { ?s ?p ?o . filter( regex( ?o , "discipline", "i" ) ) } • zie je dat http://data.digigo.nu/nlcs/def/80937c13-db4f-462d-9a5e-46049f51b886 de IRI is van de klasse Discipline. Als je door de gehele ontologie als bestand wil browsen, via de API-beschrijving van Laces is te vinden hoe je die ophaalt. Ook kun je bijv. Ontodia gebruiken om grafisch te browsen, die heb ik hier https://jsfiddle.net/mgdL5p3w/3/ geconfigureerd.

Als je nog niet zoveel weet van SPARQL zijn er verschillende cursussen online en in het echt. Of je leest het uitstekende introductieboek DuCharme, Bob (2013). Learning SPARQL (2nd Ed.). O'Reilly: Californië; en de bijbehorende website http://www.learningsparql.com/. SPARQL is een krachtige querytaal, maar je haalt er pas uit wat erin zit als je weet hoe RDF modelleert.

ElisabethKloren commented 11 months ago

Gebruiker zegt: Ik probeer met Ontodia het NLCS datamodel te bekijken. Kom er heel klein beetje uit.

Ik heb de Statussen eruit kunnen halen, iets wat herkenbaar is voor mij. Maar zie nog niet de ID en de Weergave_als, properties die horen bij Status? Of is er een class Status?

ElisabethKloren commented 11 months ago

Uitgewerkt naar handleiding