Draft: Linguistic improvements to specification

README.md

@@ -20,14 +20,14 @@ The __Dataspace Protocol__ is a set of specifications designed to facilitate int
 Sharing data between autonomous entities requires the provision of metadata to facilitate the transfer of [Datasets](./model/terminology.md#dataset) by making use of a data transfer (or application layer) protocol.
 The __Dataspace Protocol__ defines how this metadata is provisioned:
 
-1. How [Datasets](./model/terminology.md#dataset) are deployed as [DCAT Catalogs](https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog) and usage control is expressed as [ODRL Policies](https://www.w3.org/TR/odrl-model/).
+1. How [Datasets](./model/terminology.md#dataset) are deployed as [Catalogs](https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog) in terms of the DCAT Data Catalog Vocabulary, and how usage control is expressed as [Policies](https://www.w3.org/TR/odrl-model/) in the ODRL Open Digital Rights Language.
 2. How [Agreements](./model/terminology.md#agreement) that govern data usage are syntactically expressed and electronically negotiated.
 3. How [Datasets](./model/terminology.md#dataset) are accessed using [Transfer Process Protocols](./model/terminology.md#transfer-process-protocol).
 
-These specifications build on protocols located in the [ISO OSI model (ISO/IEC 7498-1:1994)](https://www.iso.org/standard/20269.html) layers, like HTTPS.
+These specifications build on protocols located in the [ISO OSI model (ISO/IEC 7498-1:1994)](https://www.iso.org/standard/20269.html) layers, such as HTTPS.
 The purpose of this specification is to define interactions between systems independent of such protocols, but describing how to implement it in an unambiguous and extensible way.
 To do so, the messages that are exchanged during the process are described in this specification and the states and their transitions are specified as state machines, based on the key terms and concepts of a [Dataspace](./model/terminology.md#dataspace).
-On this foundation the bindings to data transfer protocols, like HTTPS, are described.
+On this foundation the bindings to data transfer protocols, such as HTTPS, are described.
 
 The specifications are organized into the following documents:
 
@@ -58,9 +58,9 @@ While most interactions take place between [Connectors](./model/terminology.md#c
 The figure below provides an overview on the context of this specification.
 
 An [Identity Provider](./model/terminology.md#identity-provider) realizes the required interfaces and provides required information to implement the Trust Framework of a [Dataspace](./model/terminology.md#dataspace).
-The validation of the identity of a given [Participant Agent](./model/terminology.md#participant-agent) and the validation of additional claims is a fundamental mechanism. The structure and content of such claims and identities may, however, vary between different [Dataspaces](./model/terminology.md#dataspace), as well as the structure of such an [Identity Provider](./model/terminology.md#identity-provider), e.g. a centralized system, a decentralized system or a federated system. Other specifications, like the Identity and Trust Protocol ([IATP](https://github.com/eclipse-tractusx/identity-trust)), define the respective functions.
+The validation of the identity of a given [Participant Agent](./model/terminology.md#participant-agent) and the validation of additional claims is a fundamental mechanism. The structure and content of such claims and identities may, however, vary between different [Dataspaces](./model/terminology.md#dataspace), as well as the structure of such an [Identity Provider](./model/terminology.md#identity-provider), e.g. a centralized system, a decentralized system or a federated system. Other specifications, such as the Identity and Trust Protocol ([IATP](https://github.com/eclipse-tractusx/identity-trust)), define the respective functions.
 
-A [Connector](./model/terminology.md#connector--data-service-) will implement additional internal functionalities, like monitoring or policy engines, as appropriate. It is not covered by this specification if a [Connector](./model/terminology.md#connector--data-service-) implements such or how.
+A [Connector](./model/terminology.md#connector--data-service-) will implement additional internal functionalities, such as monitoring or policy engines, as appropriate. It is not covered by this specification if a [Connector](./model/terminology.md#connector--data-service-) implements such or how.
 
 The same applies for the actual data that is transferred between the systems. While this document does not define the transport protocol, the structure, syntax or semantics of the data, a specification for those aspects is required and subject to the agreements of the [Participants](./model/terminology.md#participant) or the [Dataspace](./model/terminology.md#dataspace).
 

catalog/message/example/catalog.json

@@ -38,36 +38,39 @@
       ],
       "odrl:hasPolicy": [
         {
+          "@id": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88",
           "@type": "odrl:Offer",
-          "dspace:providerId": "http://example.com/Provider",
+          "odrl:assigner": "http://example.com/Provider",
           "odrl:permission": [
             {
               "odrl:action": "odrl:use",
               "odrl:constraint": [
                 {
                   "odrl:leftOperand": "odrl:spatial",
-                  "odrl:operator": "odrl:EQ",
-                  "odrl:rightOperand": "odrl:EU"
+                  "odrl:operator": "odrl:eq",
+                  "odrl:rightOperand": "http://example.org/EU"
                 }
               ],
-              "odrl:duty": []
+              "odrl:duty": {
+                "odrl:action": "cc:Attribution"
+              }
             }
-          ],
-          "odrl:prohibition": [],
-          "odrl:obligation": []
+          ]
         }
       ],
-      "dcat:distribution": {
-        "@type": "dcat:Distribution",
-        "dct:format": "dspace:s3+push",
-        "dcat:accessService": [
-          {
-            "@id": "urn:uuid:4aa2dcc8-4d2d-569e-d634-8394a8834d77",
-            "@type": "dcat:DataService",
-            "dcat:endpointURL": "https://provider-a.com/connector"
-          }
-        ]
-      }
+      "dcat:distribution": [
+        {
+          "@type": "dcat:Distribution",
+          "dct:format": "dspace:s3+push",
+          "dcat:accessService": [
+            {
+              "@id": "urn:uuid:4aa2dcc8-4d2d-569e-d634-8394a8834d77",
+              "@type": "dcat:DataService",
+              "dcat:endpointURL": "https://provider-a.com/connector"
+            }
+          ]
+        }
+      ]
     }
   ]
 }

catalog/message/example/dataset-request-message.json

@@ -1,5 +1,5 @@
 {
   "@context":  "https://w3id.org/dspace/2024/1/context.json",
   "@type": "dspace:DatasetRequestMessage",
-  "dspace:dataset": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88"
+  "dspace:dataset": "urn:uuid:3afeadd8-ed2d-569e-d634-8394a8836d57"
 }

catalog/message/example/dataset.json

@@ -12,9 +12,10 @@
   "dcat:keyword": [
     "traffic"
   ],
-  "odrl:hasPolicy": {
+  "odrl:hasPolicy": [ {
     "@type": "odrl:Offer",
     "@id": "urn:uuid:2828282:3dd1add8-4d2d-569e-d634-8394a8836a88",
+    "odrl:assigner": "urn:tsdshhs636378",
     "odrl:permission": [
       {
         "odrl:action": "odrl:use",
@@ -27,7 +28,7 @@
         ]
       }
     ]
-  },
+  } ],
   "dcat:distribution": [
     {
       "@type": "dcat:Distribution",
@@ -42,4 +43,4 @@
       ]
     }
   ]
-}
+}

catalog/message/schema/catalog-schema.json

@@ -13,7 +13,7 @@
             "type": "object",
             "allOf": [
                 {
-                    "$ref": "https://w3id.org/dspace/2024/1/catalog/dataset-schema.json#/definitions/Dataset"
+                    "$ref": "https://w3id.org/dspace/2024/1/catalog/dataset-schema.json#/definitions/AbstractDataset"
                 },
                 {
                     "properties": {
@@ -49,9 +49,11 @@
                 }
             ],
             "required": [ "@context", "@type" ],
-            "not": {
-                "required": [ "odrl:hasPolicy" ]
-            }
+            "anyOf" : [
+                {
+                    "not" : { "required" : [ "odrl:hasPolicy" ] }
+                }
+            ]
         }
     }
 }

catalog/message/schema/dataset-schema.json

@@ -9,7 +9,7 @@
     ],
     "$id": "https://w3id.org/dspace/2024/1/catalog/dataset-schema.json",
     "definitions": {
-        "Dataset": {
+        "AbstractDataset": {
             "type": "object",
             "allOf": [
                 {
@@ -33,6 +33,14 @@
                         }
                     }
                 }
+            ]
+        },
+        "Dataset": {
+            "type": "object",
+            "allOf": [
+                {
+                    "$ref": "#/definitions/AbstractDataset"
+                }
             ],
             "required": [
                 "odrl:hasPolicy"
@@ -164,4 +172,4 @@
             "required": [ "@value", "@language" ]
         }
     }
-}
+}

catalog/message/shape/dataset-request-message-shape.ttl

@@ -32,10 +32,9 @@ dspace_shapes:DatasetRequestMessageShape
 	sh:property [
 		a sh:PropertyShape ;
 		sh:path dspace:dataset ;
-		sh:class dcat:Dataset ;
 		sh:minCount 1 ;
 		sh:maxCount 1 ;
 		sh:severity sh:Violation ;
-		sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/catalog-request-message-shape.ttl> (DatasetRequestMessage): An dspace:dataset property must point to one dcat:Dataset."@en ;
+		sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dataset-request-message-shape.ttl> (DatasetRequestMessage): There must be exactly one dspace:dataset property."@en ;
 	] ;
 .

catalog/message/shape/dataset-shape.ttl

@@ -60,19 +60,19 @@ dspace_shapes:DatasetShape
     sh:property [
         a sh:PropertyShape ;
         sh:path dct:title ;
-        sh:datatype xsd:string ;
+        sh:datatype rdf:langString ;
         sh:minCount 0;
         sh:severity sh:Violation ;
-        sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dataset-shape.ttl> (DatasetShape): A dct:title property must point to a xsd:string field."@en ;
+        sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dataset-shape.ttl> (DatasetShape): A dct:title property must point to a language tagged field."@en ;
     ] ; 
 
     sh:property [
         a sh:PropertyShape ;
         sh:path odrl:hasPolicy ;
-        sh:class odrl:Policy ;
+	sh:class odrl:Offer ;
         sh:severity sh:Violation ;
         sh:minCount 0;
         sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dataset-shape.ttl> (DatasetShape): An odrl:hasPolicy property must point to an odrl:Policy."@en ;
     ] ;
 
-.
+.

catalog/message/shape/dcat-shapes.ttl

@@ -242,17 +242,17 @@ dspace_shapes:DataServiceShape
     sh:property [
         a sh:PropertyShape ;
         sh:path dcat:endpointDescription ;
-        sh:datatype xsd:string ;
+        sh:datatype xsd:anyURI ;
         sh:severity sh:Violation ;
         sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dcat-shapes.ttl> (DataServiceShape): A dcat:endpointDescription property must point to a xsd:string field."@en ;
     ] ;  
 
     sh:property [
         a sh:PropertyShape ;
         sh:path dcat:endpointURL ;
-        sh:datatype xsd:string ;
+        sh:datatype xsd:anyURI ;
         sh:severity sh:Violation ;
-        sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dcat-shapes.ttl> (DataServiceShape): A dcat:endpointURL property must point to a xsd:string field."@en ;
+        sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dcat-shapes.ttl> (DataServiceShape): A dcat:endpointURL property must point to a xsd:anyURI field."@en ;
     ] ;  
 
     sh:property [
@@ -264,4 +264,4 @@ dspace_shapes:DataServiceShape
         sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/dcat-shapes.ttl> (DataServiceShape): A dcat:servesDataset property must point to a dcat:Dataset."@en ;
     ] ;
 
-.
+.

common/schema/context.json

@@ -55,7 +55,7 @@
     "odrl:leftOperand": { "@type": "@id" },
     "odrl:operator": { "@type": "@id" },
     "odrl:rightOperandReference": { "@type": "@id" },
-    "odrl:profile": { "@container": "@set" }
+    "odrl:profile": { "@container": "@set" },
     "odrl:assigner": { "@type": "@id" },
     "odrl:assignee": { "@type": "@id" }
   }

model/model.md

@@ -4,7 +4,7 @@
 
 The following sections outline the Dataspace Information Model, which form the foundation of this specification.
 Some aspects of this section describe additional concepts of Dataspaces and provide context for the Dataspace Protocol,
-those are considered as non-normative. Further information on the functional requirements of a Dataspace can be found  for example in
+those are considered as non-normative. Further information on the functional requirements of a Dataspace can be found, for example, in
 the [IDSA Rulebook](https://docs.internationaldataspaces.org/idsa-rulebook).
 
 ### 2.1 Dataspace Entity Relationships
@@ -13,7 +13,7 @@ the [IDSA Rulebook](https://docs.internationaldataspaces.org/idsa-rulebook).
 
 In a broader context, the Dataspace Protocol enables the interaction between participants of
 a Dataspace. This may require additional concepts, which are not in the scope of this specification.
-The definitions below are therefore informative and not-normative.
+The definitions below are therefore informative and non-normative.
 The relationships between the primary [Dataspace](./terminology.md#dataspace) entities are defined as follows:
 
 ![](./m.dataspace.relationships.png)

model/terminology.md

@@ -80,7 +80,7 @@ A technology system that performs operations on behalf of a [Participant](#parti
 
 ### Policy
 
-A set of rules, duties, and obligations that define the terms of use for a [Dataset](#dataset). Also referred to as "Usage Policy".
+A set of rules, duties, and obligations that define the terms of use for a [Dataset](#dataset). Also referred to as “Usage Policy”.
 
 ### Provider
 

negotiation/message/example/contract-agreement-message.json

@@ -19,5 +19,5 @@
       }]
     }]
   },
-  "dspace:callbackAddress": "https://......"
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/example/contract-offer-message.json

@@ -18,5 +18,5 @@
       }]
     }]
   },
-  "dspace:callbackAddress": "https://......"
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/example/contract-offer-message_initial.json

@@ -5,7 +5,11 @@
   "dspace:offer": {
     "@type": "odrl:Offer",
     "@id": "urn:uuid:d526561f-528e-4d5a-ae12-9a9dd9b7a518",
-    "target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88"
+    "odrl:assigner": "urn:tsdshhs636378",
+    "target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88",
+    "odrl:permission": [{
+      "odrl:action": "odrl:use"
+    }]
   },
-  "dspace:callbackAddress": "https://......"
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/example/contract-request-message.json

@@ -4,6 +4,8 @@
   "dspace:providerPid": "urn:uuid:a343fcbf-99fc-4ce8-8e9b-148c97605aab",
   "dspace:consumerPid": "urn:uuid:32541fe6-c580-409e-85a8-8a9a32fbe833",
   "dspace:offer": {
+    "@type": "odrl:Offer",
+    "@id": "urn:uuid:d526561f-528e-4d5a-ae12-9a9dd9b7a815",
     "odrl:target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88",
     "odrl:assigner": "urn:tsdshhs636378",
     "odrl:assignee": "urn:jashd766",
@@ -16,5 +18,5 @@
       }]
     }]
   },
-  "dspace:callbackAddress": "https://......"
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/example/contract-request-message_initial.json

@@ -5,7 +5,11 @@
   "dspace:offer": {
     "@type": "odrl:Offer",
     "@id": "urn:uuid:2828282:3dd1add8-4d2d-569e-d634-8394a8836a89",
-    "odrl:target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88"
+    "odrl:target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88",
+    "odrl:assigner": "urn:tsdshhs636378",
+    "odrl:permission": [{
+      "odrl:action": "odrl:use"
+    }]
   },
-  "dspace:callbackAddress": "https://......"
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/example/contract.agreement.message.http.transfer.json

@@ -4,7 +4,7 @@
   "dspace:providerPid": "urn:uuid:a343fcbf-99fc-4ce8-8e9b-148c97605aab",
   "dspace:consumerPid": "urn:uuid:32541fe6-c580-409e-85a8-8a9a32fbe833",
   "dspace:agreement": {
-    "@id": "some-other-id",
+    "@id": "urn:uuid:e8dc8655-44c2-46ef-b701-4cffdc2faa44",
     "@type": "odrl:Agreement",
     "odrl:target": "urn:uuid:3dd1add8-4d2d-569e-d634-8394a8836a88",
     "odrl:assignee": "...",
@@ -39,5 +39,6 @@
         ]
       }
     ]
-  }
+  },
+  "dspace:callbackAddress": "https://example.com/callback"
 }

negotiation/message/schema/contract-offer-message-schema.json

@@ -36,4 +36,4 @@
 			"required": [ "@context", "@type", "dspace:providerPid", "dspace:offer", "dspace:callbackAddress" ]
 		}
 	}
-}
+}

negotiation/message/schema/contract-request-message-schema.json

@@ -36,4 +36,4 @@
 			"required": [ "@context", "@type", "dspace:consumerPid", "dspace:offer", "dspace:callbackAddress" ]
 		}
 	}
-}
+}

negotiation/message/schema/contract-schema.json

@@ -68,8 +68,7 @@
                 "odrl:assignee": {
                     "type": "string"
                 }
-            },
-            "not": { "required": [ "odrl:target" ] }
+            }
         },
         "MessageOffer": {
             "type": "object",
@@ -153,7 +152,7 @@
             "required": [
                 "@type",
                 "@id",
-                "@target",
+                "odrl:target",
                 "odrl:assignee", 
                 "odrl:assigner"
             ]

negotiation/message/shape/contract-agreement-message-shape.ttl

@@ -60,10 +60,10 @@ dspace_shapes:ContractAgreementMessageShape
 	sh:property [
 		a sh:PropertyShape ;
         sh:path dspace:callbackAddress ;
-        sh:datatype xsd:string ;
+        sh:datatype xsd:anyURI ;
 		sh:maxCount 1 ;
 		sh:minCount 1 ;
 		sh:severity sh:Violation ;
-		sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/contract-agreement-message-shape.ttl> (ContractAgreementMessageShape): An dspace:callbackAddress property must point to exactly one xsd:string value."@en ;
+		sh:message "<https://raw.githubusercontent.com/International-Data-Spaces-Association/ids-specification/master/schemas/contract-agreement-message-shape.ttl> (ContractAgreementMessageShape): An dspace:callbackAddress property must point to exactly one xsd:anyURI value."@en ;
 	]
 .