diff --git a/draft/index.html b/draft/index.html index 26fb207..521a0e4 100644 --- a/draft/index.html +++ b/draft/index.html @@ -523,18 +523,18 @@

Structure of a Reconciliation Query

is defined are determined by the service.
required
An optional boolean indicating if a match for the property is required for an entity to enter the list of candidates (i.e. acting like a filter or a WHERE clause in SQL) - or optional (i.e. only effecting the entity's rank in the list of candidates);
+ or optional (i.e. only effecting the entity's rank in the list of candidates). If omitted, the service SHOULD assume the requested value to be false;
matchQuantifier
-
An optional string to indicate which of the values in v to match. MUST be any (equivalent to boolean OR), all (equivalent to boolean AND), or none (equivalent to boolean NOT);
+
An optional string to indicate which of the values in v to match. MUST be any (equivalent to boolean OR), all (equivalent to boolean AND), or none (equivalent to boolean NOT). If omitted, the service SHOULD assume the requested value to be any;
matchQualifier
An optional string to indicate how to match the values in v. This can be used for general matching relations like "skos:exactMatch", "skos:closeMatch", etc. or for specific features like spatial matching with geo data (e.g. containment search with "schema:containsPlace" etc.) or custom matching on date fields (e.g. services supporting the [[EDTF]] specification could use "EDTF:Level-0" etc. To allow discovery of supported qualifiers by clients, services that support matchQualifier MUST return the supported matchQualifiers for each property - in their property suggest responses.

+ in their property suggest responses. If omitted, the matching behavior is up to the service.

- A reconciliation service that supports property assignments SHOULD provide a suggest service for discovering these properties. If the optional fields are omitted, the exact behavior ("must match all", "should match some", etc.) is up to the service. + A reconciliation service that supports property assignments SHOULD provide a suggest service for discovering these properties.

A reconciliation query batch is an array of reconciliation queries.