Skip to content

Commit

Permalink
Merge pull request #154 from Geonovum/fixes
Browse files Browse the repository at this point in the history
Fixes
  • Loading branch information
skornsekj authored May 30, 2024
2 parents a2c654a + 4752b54 commit 3878d45
Show file tree
Hide file tree
Showing 45 changed files with 98 additions and 59 deletions.
2 changes: 1 addition & 1 deletion 005-Termen_en_definities.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Een <b>dataset</b> is een verzameling van samenhangende gegevens, die beheerd of
Elke <b>distributie</b> is de werkelijke data van de dataset in een bepaald formaat of een bepaalde aanbiedingsvorm, die als bestand beschikbaar is voor hergebruik.
<br/>
<br/>
Services die toegang geven tot een of meer datasets of processing functies, zijn een <b>dataservice</b>.
Services die toegang geven tot een of meer datasets of processing functies, zijn een <b>Data Service</b>.
<br/>
<br/>
Een <b>dataset serie</b> is een verzameling van datasets die een aantal gezamenlijke kenmerken heeft.
Expand Down
2 changes: 1 addition & 1 deletion 008-DCAT_als_universeel_vocabulaire.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Het DCAT vocabulaire bestaat uit klassen en eigenschappen.
<br/>
<br/>
- <b>Klassen beschrijven dingen</b>:
Ze hebben niet allemaal een URI, maar het wordt aanbevolen om ze van een URI te voorzien. Een klasse beschrijft (complexe) dingen met vergelijkbare characteristieken zoals personen, organisaties, datasets of API's.
Een klasse beschrijft (complexe) dingen met vergelijkbare characteristieken zoals personen, organisaties, datasets of API's.
- <b>Klassen hebben eigenschappen</b>: De eigenschappen zijn de attributen die deze dingen beschrijven. Sommige eigenschappen komen in meer dan één klasse voor, een titel bijvoorbeeld is een veel voorkomend attribuut. Andere eigenschappen zijn zeer gespecialiseerd, zoals een bestandsformaat dat alleen zinvol is voor een gegevensbestand.
- <b>Eigenschappen kunnen eenvoudig of complex zijn</b>: sommige eigenschappen worden direct beschreven in bijvoorbeeld door mensen leesbare tekst of een datum (deze eigenschappen zijn ookwel owl:DatatypeProperty) en andere eigenschappen bevatten relaties naar andere objecten (een owl:ObjectProperty).

Expand Down
7 changes: 5 additions & 2 deletions 009-Overzicht_Klassen.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
## Overzicht Klassen {#1086A1F8}
Het volgende diagram geeft een overzicht van de basis functionaliteit van [[DCAT-3.0]] en dient als startblok voor het begrijpen van de constructie. LET OP, er zijn dus meer klassen, eigenschappen en relaties dan weergegeven zoals te zien in Klassen.
<figure><img src='media/image3.svg' alt='Graphic 21501807' style='width: 100%;'></img>
<figcaption>[[DCAT-3.0]] In het kort. Hier moet nog DatasetSeries worden toegevoegd.</figcaption></figure>
<figure><img src='media/overzicht klassen.png' alt='Afbeelding met tekst' style='width: 100%;'></img>

<figcaption> Overzicht klassen</figcaption></figure>



34 changes: 33 additions & 1 deletion 013-Ondersteuning_voor_meertaligheid.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,38 @@
## Ondersteuning voor meertaligheid {#10B7B8F1}
Alle eigenschappen die voor mensen leesbare tekst bevatten (de range literal met een string waarde hebben) zoals bijvoorbeeld <code>dct:title</code> , <code>dct:description</code>, en <code>dcat:keyword </code>kunnen waardes in verschillende talen bevatten. Voor elke taal wordt de eigenschap herhaald met de toevoeging van een language tag om aan te geven in welke taal de waarde geschreven is.
Alle eigenschappen die voor mensen leesbare tekst bevatten (de range literal met een string waarde hebben) zoals bijvoorbeeld <code>dct:title</code> , <code>dct:description</code> en <code>dcat:keyword </code>kunnen waardes in verschillende talen bevatten. Voor elke taal wordt de eigenschap herhaald met de toevoeging van een language tag om aan te geven in welke taal de waarde geschreven is.
<br/>
Maak bij het gebruik van ondersteunende klassen, zoals bijvoorbeeld voor <code>dcat:contactPoint</code> één object aan en herhaal voor elke taal de eigenschap met de toevoeging van een language tag.
<br/>
Daarvoor wordt een waarde uit de waardelijst voor language toegepast: [ISO 639-1 (two-letter)](https://id.loc.gov/vocabulary/iso639-1.html)

Voorbeeld meertaligheid

<aside class='example'>

```turtle
exampleMS:1T2p3o4B a dcat:Dataset;
dct:title "Naam van de dataset"@nl;
dct:title "Title of the dataset"@en;
dcat:contactPoint [
a <https://json-ld.org/playground/Organization> ;
vcard:fn "Mijn Organisatie"@nl ;
vcard:fn "My Organization"@en ;
vcard:hasEmail <mailto:[email protected]> ;
vcard:hasURL "http://mijnorganisatie.org/" ;
vcard:organization-name "Mijn Organisatie"@nl ;
vcard:organization-name "My Organization"@en
] ;
dct:creator [
dct:type <http://purl.org/adms/publishertype/LocalAuthority> ;
a foaf:Agent ;
foaf:name "Mijn Organisatie"@nl;
foaf:name "My Organization"@en
] ;
dcat:keyword "trefwoord 1"@nl;
dcat:keyword "trefwoord 2"@nl;
dcat:keyword "keyword 1"@en;
dcat:keyword "keyword 2"@en;
.
```
2 changes: 1 addition & 1 deletion 151-Waardelijsten.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ In de onderstaande tabel worden eigenschappen opgesomd met gecontroleerde waarde
<td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'></td>
</tr>
<tr><td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'><p id='2B0214B7'>dcat:theme</td>
<td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'><p id='09E17558'>Dataset, Dataservice, Catalogue</td>
<td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'><p id='09E17558'>Dataset, Data Service, Catalogue</td>
<td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'><p id='295F61AD'><a href='https://publications.europa.eu/resource/authority/data-theme' target='_blank'>Dataset Theme Vocabulary</a></td>
<td align='left' style='border-top: 0.5pt solid #000000; border-left: 0.5pt solid #000000; border-bottom: 0.5pt solid #000000; border-right: 0.5pt solid #000000; background-color: none;'></td>
</tr>
Expand Down
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalog/prop/description.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Deze eigenschap bevat een beschrijving van de inhoud van de catalogus. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de catalogue wordt onder andere bepaald door de kwaliteit van de beschrijving. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.

Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie meertaligheid voor het omgaan met verschillende talen.
Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie <a href='https://geonovum.github.io/DCAT-AP-NL30/#10B7B8F1' target='_blank'>meertaligheid</a> voor het omgaan met verschillende talen.
4 changes: 2 additions & 2 deletions doc/klassen/dcatCatalog/prop/geographical_coverage.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
Het geografische gebied waarop de gegevens in de catalogus betrekking hebben. De ruimtelijke dekking van een catalog kan worden gecodeerd als een <code>dcterms:Location</code>, of kan kan worden aangegeven met behulp van een URI-referentie (link) naar een bron die een locatie beschrijft.
Het geografische gebied waarop de gegevens in de catalogus betrekking hebben. De ruimtelijke dekking van een catalogus kan worden gecodeerd als een <code>dcterms:Location</code>, of kan kan worden aangegeven met behulp van een URI-referentie (link) naar een bron die een locatie beschrijft.
<br>
<br>
Met <code>dcterms:Location</code> kunnen de eigenschappen bounding box, centroide of geometry worden beschreven. De coördinaten dienen te worden weergegeven volgens referentiesysteem WGS 84.
<br>
<br>
Voor de bounding box (Bbox) zijn als coördinaten de meest westelijke, oostelijke, noordelijke en zuidelijke coördinaat uit de horizontale dekking van de catalog weergegeven in latitude en longitude in decimale graden (noord en oost als positieve waarden).
Voor de bounding box (Bbox) zijn als coördinaten de meest westelijke, oostelijke, noordelijke en zuidelijke coördinaat uit de horizontale dekking van de catalogus weergegeven in latitude en longitude in decimale graden (noord en oost als positieve waarden).
<br>
<br>
Voor de invulling van deze eigenschap met een gebiedsnaam, moet als mogelijk een waarde uit <a href='http://publications.europa.eu/resource/authority/continent/' target='_blank'>EU Vocabularies Continents Named Authority List</a>, <a href='http://publications.europa.eu/resource/authority/country' target='_blank'>EU Vocabularies Countries Named Authority List</a>, <a href='http://publications.europa.eu/resource/authority/place/' target='_blank'>EU Vocabularies Places Named Authority List</a> worden gebruikt. Als de waarde daarin niet aanwezig is moet een URI uit <a href='http://www.geonames.org/' target='_blank'>Geonames</a> worden gebruikt.
Expand Down
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalog/prop/licence.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
De licentie waaronder de catalogus (met resource beschrijvingen) beschikbaar wordt gesteld. In de beschrijving van een distributie of dataservice wordt de licentie opgenomen die geldt voor de resource zelf.
De licentie waaronder de catalogus (met resource beschrijvingen) beschikbaar wordt gesteld. In de beschrijving van een distributie of Data Service wordt de licentie opgenomen die geldt voor de resource zelf.
<br/>
<br/>
<aside class='note'><p class='space-after' id='accessURL-1'>Hiervoor zal nog een waardelijst beschikbaar worden gesteld. Met daarin CC-licenties en de waarde 'niet-open'.<aside>
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalog/prop/title.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@ De naam van de beschreven catalogus
<br/>
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.

Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie meertaligheid voor het omgaan met verschillende talen.
Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie <a href='https://geonovum.github.io/DCAT-AP-NL30/#10B7B8F1' target='_blank'>meertaligheid</a> voor het omgaan met verschillende talen.
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalogRecord/prop/application_profile.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschrijving van de dataset of dataservice in de catalogus voldoet.
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschrijving van de dataset of Data Service in de catalogus voldoet.
<br/>
<br/>
Gebruik de referentie naar de officiële publicatie van de standaard of specificatie.
Expand Down
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalogRecord/prop/change_type.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
De status van het catalogusrecord in de context van de lifecycle van de dataset en dataservice beschrijvingen.
De status van het catalogusrecord in de context van de lifecycle van de dataset en Data Service beschrijvingen.
2 changes: 1 addition & 1 deletion doc/klassen/dcatCatalogRecord/prop/primary_topic.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
Een verwijzing naar de dataset of dataservice die in het record wordt beschreven.
Een verwijzing naar de dataset of Data Service die in het record wordt beschreven.
6 changes: 3 additions & 3 deletions doc/klassen/dcatDataService/dcatDataService.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Een gegevensdienst of dataservice is een computer service waar gegevens opgevraagd worden aan de hand van specificaties in een aanvraag. De gegevens die voldoen aan de meegegeven specificatie worden als antwoord teruggestuurd. Webservices zoals REST/JSON, WMS of XML interfaces zijn voorbeelden van <code>dcat:DataService</code>. Merk op dat als de specificatie slechts een deel van de gegevens beschrijft, alleen desbetreffende subset wordt opgestuurd. Ook is het mogelijk dat een dataservice niet één, maar meerdere datasets ontsluit.
Dataservice zijn speciaal bedoeld voor geautomatiseerde koppelingen tussen systemen, hoewel ze ook door - meestal technisch onderlegde - mensen gebruikt kunnen worden.
De dataservice klasse is geïntroduceerd in versie 2 van DCAT. Het biedt uitgebreidere mogelijkheden om geautomatiseerde toegang tot gegevens te beschrijven dan mogelijk is in de klasse <code>dcat:Distributie</code>. In deze nieuwe versie van het toepassingsprofiel is de dataservice klasse optioneel.
Een gegevensdienst of Data Service is een computer service waar gegevens opgevraagd worden aan de hand van specificaties in een aanvraag. De gegevens die voldoen aan de meegegeven specificatie worden als antwoord teruggestuurd. Webservices zoals REST/JSON, WMS of XML interfaces zijn voorbeelden van <code>dcat:DataService</code>. Merk op dat als de specificatie slechts een deel van de gegevens beschrijft, alleen desbetreffende subset wordt opgestuurd. Ook is het mogelijk dat een Data Service niet één, maar meerdere datasets ontsluit.
Data Services zijn speciaal bedoeld voor geautomatiseerde koppelingen tussen systemen, hoewel ze ook door - meestal technisch onderlegde - mensen gebruikt kunnen worden.
De DataService klasse is geïntroduceerd in versie 2 van DCAT. Het biedt uitgebreidere mogelijkheden om geautomatiseerde toegang tot gegevens te beschrijven dan mogelijk is in de klasse <code>dcat:Distributie</code>. In deze nieuwe versie van het toepassingsprofiel is de DataService klasse optioneel.
2 changes: 1 addition & 1 deletion doc/klassen/dcatDataService/prop/HVD_Category.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Deze eigenschap bevat de HVD-categorie waartoe de datasets die in de dataservice worden ontsloten, behoort, als die dataset onder de High-Value Datasets uitvoeringsverordening valt.
Deze eigenschap bevat de HVD-categorie waartoe de datasets die in de Data Service worden ontsloten, behoort, als die dataset onder de High-Value Datasets uitvoeringsverordening valt.
<br/>
<br/>
Gebruik hiervoor een waarde uit <a href='https://op.europa.eu/en/web/eu-vocabularies/dataset/-/resource?uri=http://publications.europa.eu/resource/dataset/high-value-dataset-category' target='_blank'>EU Vocabularies HVD Categories</a>.
Expand Down
2 changes: 1 addition & 1 deletion doc/klassen/dcatDataService/prop/access_rights.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Deze eigenschap bevat informatie die aangeeft of de dataservice openbaar toegankelijk is, toegangsbeperkingen heeft of niet openbaar is.
Deze eigenschap bevat informatie die aangeeft of de Data Service openbaar toegankelijk is, toegangsbeperkingen heeft of niet openbaar is.
<br/>
<br/>
Een waarde uit <a href='http://publications.europa.eu/resource/authority/access-right' target='_blank'>Access Rights Named Authority List</a> is verplicht. Gebruik één van de volgende waarden: public; restricted; non-public.
2 changes: 1 addition & 1 deletion doc/klassen/dcatDataService/prop/applicable_legislation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de dataservice verplicht stelt.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de Data Service verplicht stelt.
Er kunnen meerdere wetgevingen op de dataset van toepassing zijn. Denk aan High-Value Datasets, INSPIRE, kaderrichtlijn water etc.
<br/>
<br/>
Expand Down
6 changes: 3 additions & 3 deletions doc/klassen/dcatDataService/prop/application_profile.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschreven dataservice voldoet. Bijvoorbeeld een API features standaard http://www.opengis.net/def/interface/ogcapi-features.
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschreven Data Service voldoet. Bijvoorbeeld een API features standaard http://www.opengis.net/def/interface/ogcapi-features.
<br/>
<br/>
Gebruik de referentie naar de officiële publicatie van de standaard of specificatie.
<br/>
<br/>
Deze eigenschap is verplicht, als de dataservice onder de High-Value Datasets uitvoeringsverordening valt.
Deze eigenschap is verplicht, als de Data Service onder de High-Value Datasets uitvoeringsverordening valt.
<br/>
<br/>
De standaard waarnaar hier wordt verwezen, behoort de dataservice te beschrijven en niet de bijbehorende dataset. De dataservice voldoet bijvoorbeeld aan de OGC API-features standaard, terwijl de bijbehorende dataset voldoet aan het INSPIRE Address dataspecificatie.
De standaard waarnaar hier wordt verwezen, behoort de Data Service te beschrijven en niet de bijbehorende dataset. De Data Service voldoet bijvoorbeeld aan de OGC API-features standaard, terwijl de bijbehorende dataset voldoet aan het INSPIRE Address dataspecificatie.
2 changes: 1 addition & 1 deletion doc/klassen/dcatDataService/prop/contact_point.md
Original file line number Diff line number Diff line change
@@ -1 +1 @@
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de dataservice. Dit element bevat het e-mailadres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de Data Service. Dit element bevat het e-mailadres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
2 changes: 1 addition & 1 deletion doc/klassen/dcatDataService/prop/creator.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
De organisatie die verantwoordelijk is voor het creëren van de beschreven dataservice. Gebruik bij voorkeur een URI of anders een waarde uit een organisatienamenlijst. Als dat niet mogelijk is, gebruik de volledig uitgeschreven naam van de verantwoordelijke organisatie. De afkorting kan toegevoegd worden aan de organisatienaam.
De organisatie die verantwoordelijk is voor het creëren van de beschreven Data Service. Gebruik bij voorkeur een URI of anders een waarde uit een organisatienamenlijst. Als dat niet mogelijk is, gebruik de volledig uitgeschreven naam van de verantwoordelijke organisatie. De afkorting kan toegevoegd worden aan de organisatienaam.
<br/>
<br/>
Waardelijsten die gebruikt kunnen worden zijn bijvoorbeeld <a href='https://organisaties.overheid.nl/' target='_blank'>Register Overheid-Organisaties</a>, <a href='https://organisaties.overheid.nl/' target='_blank'>TOOI waardelijsten (relevante lijsten met overheids-organisaties)</a>, <a href='https://ror.org/' target='_blank'>Research Organization Registry (ROR)</a> of een waardelijst conform de <a href='https://semiceu.github.io/Core-Business-Vocabulary/releases/2.1.0/' target='_blank'>Core Business Vocabulary (organisaties)</a>.
4 changes: 2 additions & 2 deletions doc/klassen/dcatDataService/prop/description.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
Deze eigenschap bevat een beschrijving van de inhoud van de dataservice. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de dataservice wordt onder andere bepaald door de kwaliteit van de beschrijving. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.
Deze eigenschap bevat een beschrijving van de inhoud van de Data Service. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de Data Service wordt onder andere bepaald door de kwaliteit van de beschrijving. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.

Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie meertaligheid voor het omgaan met verschillende talen.
Deze eigenschap kan alleen worden herhaald om de waarde in een andere taal weer te geven. Zie <a href='https://geonovum.github.io/DCAT-AP-NL30/#10B7B8F1' target='_blank'>meertaligheid</a> voor het omgaan met verschillende talen.
4 changes: 2 additions & 2 deletions doc/klassen/dcatDataService/prop/documentation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Een pagina of document over de dataservice met aanvullende informatie.
Een pagina of document over de Data Service met aanvullende informatie.
<br/>
<br/>
De informatie over de kwaliteit van de dienstverlening wordt beschouwd als onderdeel van de generieke documentatie van een dataservice. Voor High-Value Datasets moet dit verplicht worden opgenomen.
De informatie over de kwaliteit van de dienstverlening wordt beschouwd als onderdeel van de generieke documentatie van een Data Service. Voor High-Value Datasets moet dit verplicht worden opgenomen.
Loading

0 comments on commit 3878d45

Please sign in to comment.