Merge branch 'develop' of https://github.com/wemove/dcat-ap-plu into …

…develop

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
 

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
 

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

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>

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 [