diff --git a/README.md b/README.md index 53ec133..f6ee42a 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# RML Fields specification +# RML logical Views specification -Specification of RML fields +Specification of RML logical views ## Quickstart diff --git a/spec/section/abstract.md b/spec/section/abstract.md index 1baff85..a2c620a 100644 --- a/spec/section/abstract.md +++ b/spec/section/abstract.md @@ -1,7 +1,7 @@ ## Abstract {#abstract} -RML fields is an extension of the RDF Mapping Language (RML) that increases the language’s capability to construct RDF datasets from nested input data. +RML logical views is an extension of the RDF Mapping Language (RML) that increases the language’s capability to construct RDF datasets from nested input data. -This document describes RML fields through definitions and examples. +This document describes RML logical views through definitions and examples. The version of this document is *Unreleased*. diff --git a/spec/section/collections.md b/spec/section/collections.md index 6eafa4b..ab998f8 100644 --- a/spec/section/collections.md +++ b/spec/section/collections.md @@ -1 +1 @@ -## Generating collections with RML fields {#collections} \ No newline at end of file +## Generating collections with RML logical views {#collections} diff --git a/spec/section/fields.md b/spec/section/fields.md index 9ca15c4..dc9813c 100644 --- a/spec/section/fields.md +++ b/spec/section/fields.md @@ -10,9 +10,9 @@ In this example a [=field=] with [=declared name=] "name" is declared on the [=l ```turtle :jsonView a rml:LogicalView ; - rml:logicalSource :jsonSource ; + rml:onLogicalSource :jsonSource ; rml:field [ - rml:name "name" ; + rml:fieldName "name" ; rml:reference "$.name" ; ] . ``` @@ -92,7 +92,7 @@ In this example a [=field=] with [=declared name=] "item" is added to the [=logi ```turtle :jsonView a rml:LogicalView ; - rml:logicalSource :jsonSource ; + rml:onLogicalSource :jsonSource ; rml:field [ rml:fieldName "name" ; rml:reference "$.name" ; @@ -264,7 +264,7 @@ A [=field reference=] can be used in [expression maps](http://w3id.org/rml/core/ ```turtle :jsonView a rml:LogicalView ; - rml:logicalSource :jsonSource ; + rml:onLogicalSource :jsonSource ; rml:field [ rml:fieldName "name" ; rml:reference "$.name" ; diff --git a/spec/section/joins.md b/spec/section/joins.md index 3814ad8..009ed8f 100644 --- a/spec/section/joins.md +++ b/spec/section/joins.md @@ -1,17 +1,17 @@ -## Joins {#joins} +## Logical view joins {#viewjoins} -A join (`rml:Join`) is an operation that extends the logical iteration of one logical view (the child logical view) with fields from another logical view (the parent logical view). +A logical view join (`rml:LogicalViewJoin`) is an operation that extends the logical iteration of one logical view (the child logical view) with fields from another logical view (the parent logical view). -A [=join=] (`rml:Join`) MUST contain: +A [=logical view join=] (`rml:LogicalViewJoin`) MUST contain: - exactly one parent logical view property (`rml:parentLogicalView`), whose value is a [=logical view=] (`rml:LogicalView`) that supplies the additional fields. - at least one join condition property (`rml:joinCondition`), whose value is a [=join condition=] that describe which values are compared to join the two logical views. - at least one field property (`rml:field`), whose value is a [=field=] (`rml:Field`) . This field MAY only contain references to fields that exists in the parent logical view. -| Property | Domain | Range | -|-------------------------|------------|---------------------| -| `rml:parentLogicalView` | `rml:Join` | `rml:LogicalView` | -| `rml:joinCondition` | `rml:Join` | `rml:JoinCondition` | -| `rml:field` | `rml:Join` | `rml:Field` | +| Property | Domain | Range | +|-------------------------|-----------------------|---------------------| +| `rml:parentLogicalView` | `rml:LogicalViewJoin` | `rml:LogicalView` | +| `rml:joinCondition` | `rml:LogicalViewJoin` | `rml:JoinCondition` | +| `rml:field` | `rml:LogicalViewJoin` | `rml:Field` | ### Join conditions @@ -81,7 +81,8 @@ If no match is found for a logical iteration, the logical iteration is removed f Pano: If there are more than one join, what is the order of execution? -### Join examples +### Logical view join examples + @@ -90,6 +91,7 @@ Els: TODO add example with 2 joins??? ### Left join +