diff --git a/CHANGELOG.md b/CHANGELOG.md index 92a2da3..ab3c905 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,8 @@ * [Website] Fix links to DCAT-AP.PLU documentation * [Deployment] Set draft version for development * [Spec] Replace `plu:procedureStartDate` (type `xsd:dateTime`) with `plu:procedurePeriod` (type `dct:PeriodOfTime`) +* [Spec] Add new attribute `dct:title` to `plu:ProcessStep` +* [API] Remove `source` query parameter from `POST`/`PUT`/`DELETE` endpoints for records ## 2024-02-28 - 0.1.4 diff --git a/docker/Dockerfile b/docker/Dockerfile index 856ec87..2d49f89 100644 --- a/docker/Dockerfile +++ b/docker/Dockerfile @@ -6,7 +6,7 @@ ENV DCATAPPLU_VERSION=../drafts/0.0.1-draft-0.1 RUN addgroup -S --gid 1000 lighttpd \ && adduser -S -G lighttpd --uid 1000 lighttpd -RUN apk add --update --no-cache lighttpd=${LIGHTTPD_VERSION} curl \ +RUN apk add --update --no-cache lighttpd=${LIGHTTPD_VERSION} \ && rm -rf /var/cache/apk/* \ && chgrp lighttpd /usr/sbin/lighttpd diff --git a/drafts/0.0.1-draft-0.1/api-plu.yml b/drafts/0.0.1-draft-0.1/api-plu.yml index c3a4264..706dea8 100644 --- a/drafts/0.0.1-draft-0.1/api-plu.yml +++ b/drafts/0.0.1-draft-0.1/api-plu.yml @@ -241,7 +241,6 @@ paths: operationId: postRecord parameters: - $ref: '#/components/parameters/collectionId' - - $ref: '#/components/parameters/source' requestBody: required: true content: @@ -301,7 +300,6 @@ paths: parameters: - $ref: '#/components/parameters/collectionId' - $ref: '#/components/parameters/recordId' - - $ref: '#/components/parameters/source' requestBody: required: true content: @@ -333,7 +331,6 @@ paths: parameters: - $ref: '#/components/parameters/collectionId' - $ref: '#/components/parameters/recordId' - - $ref: '#/components/parameters/source' responses: '200': $ref: '#/components/responses/200Success' @@ -359,14 +356,6 @@ components: schema: type: string example: f08a255e-2c11-49dd-bdf9-88a0dcbe2aa6 - source: - name: source - in: query - description: The mandatory source parameter denotes the origin point of the dataset. It influences the merging strategy for competing datasets. Interpreted values are `cockpit`, `cockpitpro`, `beteiligungsdb`. - required: true - schema: - type: string - example: cockpit q: name: q in: query @@ -885,6 +874,13 @@ components: xml: prefix: dct name: temporal + title: + description: Title of the processstep + type: string + example: Titel des Verfahrensschrittes + xml: + prefix: dct + name: title distribution: description: A distribution referenced by the process step type: array diff --git a/drafts/0.0.1-draft-0.1/doc-plu.html b/drafts/0.0.1-draft-0.1/doc-plu.html index 2edf22c..4cbd9e7 100644 --- a/drafts/0.0.1-draft-0.1/doc-plu.html +++ b/drafts/0.0.1-draft-0.1/doc-plu.html @@ -34,7 +34,7 @@ <section id="abstract" class="informative"> <h2 id="introduction">Zusammenfassung</h2> <p>Die vorliegende Spezifikation eines Metadatenmodells wurde für die Beschreibung von raumbezogenen Planwerken und Beteiligungsverfahren zu raumbezogenen Planwerken entwickelt, mit dem Ziel, diese über ein Metadaten-Informationssystem recherchierbar und editierbar machen zu können. - Als Basis dienen die Standards von DCAT-AP sowie DCAT-AP.de. Soweit Begriffe aus existierenden Vokabularen mit adequaten Bedeutungen existieren, wurden diese verwendet, wie z.B. dct:title und foaf:homepage. Sofern keine passenden Begriffe vorhanden waren, wurden eigene Begriffe ergänzt, um die speziellen Sachverhalte bei raumbezogenen Planwerken abbilden zu können, z.B. plu:planType für die Art des raumbezogenen Planwerkes. + Als Basis dienen die Standards von DCAT-AP sowie DCAT-AP.de. Soweit Begriffe aus existierenden Vokabularen mit adäquaten Bedeutungen existieren, wurden diese verwendet, wie z.B. dct:title und foaf:homepage. Sofern keine passenden Begriffe vorhanden waren, wurden eigene Begriffe ergänzt, um die speziellen Sachverhalte bei raumbezogenen Planwerken abbilden zu können, z.B. plu:planType für die Art des raumbezogenen Planwerkes. </p> </section> @@ -55,10 +55,10 @@ <h2>Definitionen und Terminologie</h2> <section id="namespaces"> <h3>Verwendete Spezifikationen</h3> - <p>Das vorliegende Metadatenmodell baut auf das europäische Metadatenaustauschschema DCAT-AP auf und erweitert dieses mit einzelnen Klassen und Eigenschaften. In DCAT bzw. DCAT-AP wird auf Klassen und Eigenschaften vieler anderer Vokabulare zurückgegriffen, insbesondere Dublin Core DCTERMS. Weiterhin wurde für den deutschen Nutzungskontext die standardkonforme Anpassung DCAT-AP.de entwickelt. Diese hat den Zweck des Austauschs von Metadaten offener Verwaltungsdaten für deutsche Open Data-Portale (https://www.dcat-ap.de). Im vorliegenden Modell wird, soweit vorhanden, auf Klassen und Eigenschaften zurückgegriffen, wie sie in der aktuellen Spezifikation dcat-ap.de definiert sind.</p> - <p>Namensräume und Prefixe auf die im vorliegenden Datenmodell zurückgegriffen wird, sind in der folgenden Tabelle aufgelistet.</p> + <p>Das vorliegende Metadatenmodell baut auf das europäische Metadatenaustauschschema DCAT-AP auf und erweitert dieses mit einzelnen Klassen und Eigenschaften. In DCAT bzw. DCAT-AP wird auf Klassen und Eigenschaften vieler anderer Vokabulare zurückgegriffen, insbesondere Dublin Core DCTERMS. Weiterhin wurde für den deutschen Nutzungskontext die standardkonforme Anpassung DCAT-AP.de entwickelt. Diese hat den Zweck des Austauschs von Metadaten offener Verwaltungsdaten für deutsche Open Data-Portale (https://www.dcat-ap.de). Im vorliegenden Modell wird, soweit vorhanden, auf Klassen und Eigenschaften zurückgegriffen, wie sie in der aktuellen Spezifikation DCAT-AP.de definiert sind.</p> + <p>Namensräume und Präfixe auf die im vorliegenden Datenmodell zurückgegriffen wird, sind in der folgenden Tabelle aufgelistet.</p> <table id="table-namespaces"> - <thead><tr><th>Prefix</th><th>Namensraum</th></tr></thead> + <thead><tr><th>Präfix</th><th>Namensraum</th></tr></thead> <tbody> <tr><td><code>adms</code></td><td><code>https://www.w3.org/ns/adms#</code></td></tr> <tr><td><code>dcat</code></td><td><code>http://www.w3.org/ns/dcat#</code></td></tr> @@ -83,8 +83,8 @@ <h2>UML-Diagramm</h2> <p>Das UML-Diagramm des DCAT-PLU-Datenmodells.</p> <figure id="pic-id-uml"> - <a href="DCAT-AP-PLU.JPG" target="_blank"><img src="DCAT-AP-PLU.JPG" alt="UML-Diagramm aller DCAT-AP-Klassen einschließlich der DCAT-PLU Erweiterungen " width="1907" height="1684"></a> - <figcaption class="fig-title">UML-Diagramm der verwendeten DCAT-AP-Klassen sowie der DCAT-PLU Erweiterungen</figcaption> + <a href="DCAT-AP-PLU.JPG" target="_blank"><img src="DCAT-AP-PLU.JPG" alt="UML-Diagramm aller DCAT-AP-Klassen einschließlich der DCAT-AP.PLU Erweiterungen " width="1907" height="1684"></a> + <figcaption class="fig-title">UML-Diagramm der verwendeten DCAT-AP-Klassen sowie der DCAT-AP.PLU Erweiterungen</figcaption> </figure> </section> @@ -173,7 +173,7 @@ <h4 id="property-catalog-update-date">Eigenschaft: Veränderungsdatum</h4> <thead><tr><th>URI:</th><th><a href="http://purl.org/dc/terms/modified">dct:modified</a></th></tr></thead> <tbody> <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> - <tr><td class="prop">Definition:</td><td>Datum, an dem der Katalog zuletzt verändert, aktualisiert oder modifiziert wrude.</td></tr> + <tr><td class="prop">Definition:</td><td>Datum, an dem der Katalog zuletzt verändert, aktualisiert oder modifiziert wurde.</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal"><code>rdfs:Literal</code> als <code>xsd:date</code> oder <code>xsd:dateTime</code></a> </tbody> </table> @@ -375,7 +375,7 @@ <h4 id="property-other-identifier">Eigenschaft: Katalogübergreifender Identifik <thead><tr><th>URI:</th><th><a href="http://purl.org/dc/terms/identifier"><code>adms:identifier</code></a></th></tr></thead> <tbody> <tr><td>Verbindlichkeit:</td><td>Empfohlen</td></tr> - <tr><td>Definition:</td><td>Diese Eigenschaft verweist auf eine katalogübergreifende ID des Datensatzes und setzt sich aus der ID der datenhaltenden Stelle (siehe entsprechende <a href="#codelist-pluAuthority">Codeliste</a>) und der ID des Datensatzes (dct:identifier, eine uuid) zusammen.</td></tr> + <tr><td>Definition:</td><td>Diese Eigenschaft verweist auf eine katalogübergreifende ID des Datensatzes und setzt sich aus der ID der datenhaltenden Stelle (siehe entsprechende <a href="#codelist-pluAuthority">Codeliste</a>) und der ID des Datensatzes (dct:identifier, eine UUID) zusammen.</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal"><code>adms:Identifier</code></a></td></tr> <tr><td class="prop">Anwendungshinweis:</td><td>Beispiel für die Angabe eines <code>adms:identifier</code><br> <code>https://specs.diplanung.de/resource/authority#hh/abde-efgh-0123-4567</code></td></tr> </tbody> @@ -587,7 +587,7 @@ <h4 id="property-dev-freeze">Eigenschaft: Veränderungssperre</h4> <tr><td class="prop">Verbindlichkeit:</td><td>Optional</td></tr> <tr><td class="prop">Definition:</td><td>Zeitraum einer Veränderungssperre</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td>dct:PeriodOfTime</td></tr> - <tr><td class="prop">Anwendungshinweis:</td><td>Diese Eigenschaft beschreibt den Zeitraum, in dem eine Veränderugssperre wirksam ist.</td></tr> + <tr><td class="prop">Anwendungshinweis:</td><td>Diese Eigenschaft beschreibt den Zeitraum, in dem eine Veränderungssperre wirksam ist.</td></tr> </tbody> </table> </section> @@ -615,7 +615,7 @@ <h3 id="class-distribution">Klasse: Distribution</h3> <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> <tr><td class="prop">Definition:</td><td>Eine Repräsentation eines Datensatzes in einem bestimmten Format</td></tr> <tr><td class="prop">Anwendungshinweis:</td><td>Die Distribution stellt die generelle Verfügbarkeit eines Datensatzes dar aber beinhaltet nicht zwangsweise eine Zugangsmöglichkeit zu den Daten wie z.B.durch direkten Download, <abbr title="Application Programming Interface">API</abbr>, oder durch eine Internetseite. - Die Benutzung der Eigenschaft <code>dcat:downloadURL</code> zeigt eine direkt herunterladebare Distribution an.</td></tr> + Die Benutzung der Eigenschaft <code>dcat:downloadURL</code> zeigt eine direkt herunterladbare Distribution an.</td></tr> </tbody> </table> @@ -631,7 +631,7 @@ <h4 id="property-distribution-access-url">Eigenschaft: access URL</h4> <p>Die mit der Zugangs-URL erreichbare Ressource kann Informationen zur Verfügung stellen, wie die Distribution erreicht werden kann oder direkt auf eine Datei verweisen, die die Daten im angegebenen Format beinhaltet.</p> <p><code>dcat:accessURL</code> sollte für die URL eines Services oder eines Ortes benutzt werden, der Zugang zu dieser Distribution bietet, typischerweise durch ein digitales Formular, eine Anfrage oder einen API Abruf.</p> - <p><code>dcat:downloadURL</code> ist für direkte Links zu herunterladbaren Ressourcen zu beforzugen.</td></tr> + <p><code>dcat:downloadURL</code> ist für direkte Links zu herunterladbaren Ressourcen zu bevorzugen.</td></tr> </tbody> </table> </section> @@ -730,7 +730,7 @@ <h4 id="property-distribution-format">Eigenschaft: Format</h4> <section id="Property:distribution_temporal"> <h4 id="property-distribution-temporal">Eigenschaft: Zeitbezug</h4> <table class="definition"> - <thead><tr><th>URI:</th><th>dct:periodOfTime</th></tr></thead> + <thead><tr><th>URI:</th><th>dct:PeriodOfTime</th></tr></thead> <tbody> <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> <tr><td class="prop">Definition:</td><td>Zeitraum, in dem die Distribution zur Verfügung steht oder Zeitpunkt, ab dem oder bis zu dem die Distribution zur Verfügung steht.</td></tr> @@ -748,7 +748,7 @@ <h4 id="property-distribution-map-layer-names">Eigenschaft: Bezeichnung Kartenla <tr><td class="prop">Verbindlichkeit:</td><td>Optional</td></tr> <tr><td class="prop">Definition:</td><td>Bezeichnung der Kartenlayer</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal"><code>rdfs:Literal</code></a></td></tr> - <tr><td class="prop">Anwendungshinweis:</td><td>Mit dieser Eigenschaft können die Bezeichnungen einzelner Kartenlayer durch eine Liste von komma-separierten Layernamen mitgegeben werden, wenn die Distribution z.B. einen WMS darstellt.</td></tr> + <tr><td class="prop">Anwendungshinweis:</td><td>Mit dieser Eigenschaft können die Bezeichnungen einzelner Kartenlayer durch eine Liste von Komma-separierten Layernamen mitgegeben werden, wenn die Distribution z.B. einen WMS darstellt.</td></tr> </tbody> </table> </section> @@ -766,7 +766,7 @@ <h3 id="class-process-step">Klasse: Verfahrensschritt</h3> </tbody> </table> - <section id="Property:resource_identifier"> <!--Brauch ich das für den Prozesschritt?--> + <section id="Property:resource_identifier"> <!--Brauch ich das für den Prozessschritt?--> <h4 id="property-identifier">Eigenschaft: Identifikator</h4> <table class="definition"> <thead><tr><th>URI:</th><th><a href="http://purl.org/dc/terms/identifier">dct:identifier</a></th></tr></thead> @@ -779,15 +779,28 @@ <h4 id="property-identifier">Eigenschaft: Identifikator</h4> </table> </section> + <section id="Property:processStep_title"> + <h4 id="property-process-step-title">Eigenschaft: Titel</h4> + <table class="definition"> + <thead><tr><th>URI:</th><th><a href="http://purl.org/dc/terms/title">dct:title</a></th></tr></thead> + <tbody> + <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> + <tr><td class="prop">Definition:</td><td>Name / Bezeichnung des Verfahrensschrittes als Freitext</td></tr> + <tr><td class="prop">Typ/Wertebereich:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Literal"><code>rdfs:Literal</code></a></td></tr> + <tr><td class="prop">Anwendungshinweis:</td><td>Der Titel des Verfahrensschrittes, falls er sich vom Titel des übergeordneten Planverfahrens unterscheidet.</td></tr> + </tbody> + </table> + </section> + <section id="Property:processStepType"> - <h4 id="property-process-step-type">Eigenschaft: Art des Prozesschrittes</h4> + <h4 id="property-process-step-type">Eigenschaft: Art des Prozessschrittes</h4> <table class="definition"> <thead><tr><th>URI:</th><th>plu:processStepType</th></tr></thead> <tbody> <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> - <tr><td class="prop">Definition:</td><td>Art des Prozesschrittes bei raumbezogenen Planwerken und Beteiligungsverfahren</td></tr> + <tr><td class="prop">Definition:</td><td>Art des Prozessschrittes bei raumbezogenen Planwerken und Beteiligungsverfahren</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td><a href="http://www.w3.org/2000/01/rdf-schema#Resource"><code>rdfs:Resource</code></a></td></tr> - <tr><td class="prop">Anwendungshinweis:</td><td>Mit dieser Eigenschaft wird die Art des Prozessschrittes bei raumbezogenen Planwerken und Beteiligungsverfahren beschrieben. Die Arten von Prozesschritten sind durch eine <a href="#codelist-pluProcessStepType">Codeliste</a> definiert. Der zu verwendende IRI in der rdf:resource setzt sich zusammen aus <code>https://specs.diplanung.de/resource/processStepType#</code> und dem gewünschten Codelistenwert.</td></tr> + <tr><td class="prop">Anwendungshinweis:</td><td>Mit dieser Eigenschaft wird die Art des Prozessschrittes bei raumbezogenen Planwerken und Beteiligungsverfahren beschrieben. Die Arten von Prozessschritten sind durch eine <a href="#codelist-pluProcessStepType">Codeliste</a> definiert. Der zu verwendende IRI in der rdf:resource setzt sich zusammen aus <code>https://specs.diplanung.de/resource/processStepType#</code> und dem gewünschten Codelistenwert.</td></tr> </tbody> </table> </section> @@ -808,12 +821,12 @@ <h4 id="property-process-step-distribution">Eigenschaft: Distribution</h4> <section id="Property:temporal"> <h4 id="property-temporal">Eigenschaft: Zeitbezug</h4> <table class="definition"> - <thead><tr><th>URI:</th><th>dct:periodOfTime</th></tr></thead> + <thead><tr><th>URI:</th><th>dct:PeriodOfTime</th></tr></thead> <tbody> <tr><td class="prop">Verbindlichkeit:</td><td>Empfohlen</td></tr> - <tr><td class="prop">Definition:</td><td>Zeitraum, in dem der Prozesschritt stattfindet.</td></tr> + <tr><td class="prop">Definition:</td><td>Zeitraum, in dem der Prozessschritt stattfindet.</td></tr> <tr><td class="prop">Typ/Wertebereich:</td><td>dct:temporal</td></tr> - <tr><td class="prop">Anwendungshinweis:</td><td>Über diese Eigenschaft kann der Zeitraum, in dem der Prozesschritt stattfindet, definiert werden, falls es sich um einen zeitgebundenen Prozessschritt handelt.</td></tr> + <tr><td class="prop">Anwendungshinweis:</td><td>Über diese Eigenschaft kann der Zeitraum, in dem der Prozessschritt stattfindet, definiert werden, falls es sich um einen zeitgebundenen Prozessschritt handelt.</td></tr> </tbody> </table> </section> diff --git a/drafts/0.0.1-draft-0.1/shacl/dcat-ap-plu_shacl-shapes.ttl b/drafts/0.0.1-draft-0.1/shacl/dcat-ap-plu_shacl-shapes.ttl index 0d9b23c..95b4ca9 100644 --- a/drafts/0.0.1-draft-0.1/shacl/dcat-ap-plu_shacl-shapes.ttl +++ b/drafts/0.0.1-draft-0.1/shacl/dcat-ap-plu_shacl-shapes.ttl @@ -560,6 +560,10 @@ sh:path dct:temporal ; sh:class dct:PeriodOfTime ; sh:maxCount 1 ; + ], [ + sh:path dct:title ; + sh:nodeKind sh:Literal ; + sh:maxCount 1 ; ] ; # optional sh:property [