diff --git a/shacl12-sparql/index.html b/shacl12-sparql/index.html index 05b81990..efab629d 100644 --- a/shacl12-sparql/index.html +++ b/shacl12-sparql/index.html @@ -235,6 +235,7 @@

Terminology

focus graph, conform, failure, + validation result, SHACL instance, SHACL subclass, SHACL type, @@ -582,8 +583,8 @@

An Example SPARQL-based Constraint

The SPARQL query returns result set solutions for all bindings of the variable value that violate the constraint. - There is a validation result for each solution in that result set, applying the mapping rules explained later. - In this example, each validation result will have the binding for the variable this as the sh:focusNode, + There is a validation result for each solution in that result set, applying the mapping rules explained later. + In this example, each validation result will have the binding for the variable this as the sh:focusNode, ex:germanLabel as sh:resultPath and the violating value as sh:value.

@@ -781,7 +782,7 @@

Validation with SPARQL-based Constraints

TEXTUAL DEFINITION
Let $sparql be a value of sh:sparql. - There are no validation results if the SPARQL-based constraint has true + There are no validation results if the SPARQL-based constraint has true as a value for the property sh:deactivated. Otherwise, execute the SPARQL query specified by the SPARQL-based constraint $sparql pre-binding the variable this as described in . @@ -790,8 +791,8 @@

Validation with SPARQL-based Constraints

position of a triple pattern with a valid SPARQL surface syntax string of the SHACL property path specified via sh:path at the property shape. - There is one validation result for each solution that does not have true as the binding for the variable failure. - These validation results MUST have the property values explained in . + There is one validation result for each solution that does not have true as the binding for the variable failure. + These validation results MUST have the property values explained in . A failure MUST be produced if and only if one of the solutions has true as the binding for failure.
@@ -807,7 +808,7 @@

Pre-bound variable $this in SPARQL Constraints

Mapping of Solution Bindings to Result Properties

- The property values of the validation result nodes are derived by the following rules, through a combination of result solutions and the values of the constraint itself. + The property values of the validation result nodes are derived by the following rules, through a combination of result solutions and the values of the constraint itself. The rules are meant to be executed from top to bottom, so that the first bound value will be used.

@@ -1301,7 +1302,7 @@

Validation with SPARQL-based Constraint Components

MUST be pre-bound as a variable that has the parameter name as its name.

- The production rules for the validation results are identical to those for SPARQL-based constraints, + The production rules for the validation results are identical to those for SPARQL-based constraints, using the solutions QS as produced above.

@@ -1311,12 +1312,12 @@

Validation with SPARQL-based Constraint Components

Annotation Properties

This section extends the general mechanism - to produce validation results using SPARQL-based constraints or + to produce validation results using SPARQL-based constraints or constraint components.

Implementations that support this feature make it possible to inject annotation properties - into the validation result nodes created for each solution produced by the SELECT queries of a + into the validation result nodes created for each solution produced by the SELECT queries of a SPARQL-based constraint or constraint component. Any such annotation property needs to be declared via a value of sh:resultAnnotation at the subject of the sh:select or sh:ask triple. @@ -1370,7 +1371,7 @@

Annotation Properties

If a variable name could be determined, then the SHACL processor copies the binding for the given variable as a value for the property specified using sh:annotationProperty - into the validation result that is being produced for the current solution. + into the validation result that is being produced for the current solution. If the variable has no binding in the result set solution, then the values of sh:annotationValue are used, if present.

@@ -1884,7 +1885,7 @@

sh:minExclusive (etc)

The following query expresses a potential SPARQL-based validator for sh:minExclusive. The SPARQL expression produces an error if the value node cannot be compared to the specified range, for example when someone compares a string with an integer. - If the comparison cannot be performed, then there is a validation result. + If the comparison cannot be performed, then there is a validation result. This is different from, say, a plain SPARQL query, in which such errors would silently not lead to any results.