From 4d0058f6e2f2f8368e0333cfff11c6628a5f0d03 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 17:56:06 +0100 Subject: [PATCH 01/19] Amend core context --- md/annex-b.md | 283 +++++++++++++++++++++++++++++++++----------------- 1 file changed, 187 insertions(+), 96 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index 315e02f..6446003 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -14,20 +14,104 @@ Such definition has been tested using [i.19]. "geojson": "https://purl.org/geojson/vocab#", "id": "@id", "type": "@type", - "Attribute": "ngsi-ld:Attribute", - "AttributeList": "ngsi-ld:AttributeList", - "ContextSourceIdentity": "ngsi-ld:ContextSourceIdentity", + "Attribute": { + "@id": "ngsi-ld:Attribute", + "@context": { + "attributeName": { + "@id": "ngsi-ld:attributeName", + "@type": "@vocab" + }, + "attributeCount": "attributeCount", + "attributeTypes": { + "@id": "ngsi-ld:attributeTypes", + "@type": "@vocab" + }, + "typeNames": { + "@id": "ngsi-ld:typeNames", + "@type": "@vocab" + } + } + }, + "AttributeList": { + "@id": "ngsi-ld:AttributeList", + "@context": { + "attributeList": { + "@id": "ngsi-ld:attributeList", + "@type": "@vocab" + } + } + }, + "ContextSourceIdentity": { + "@id": "ngsi-ld:ContextSourceIdentity", + "@context": { + "contextSourceAlias": "ngsi-ld:contextSourceAlias", + "contextSourceExtras": { + "@id": "ngsi-ld:contextSourceExtras", + "@type": "@json" + }, + "contextSourceInfo": "ngsi-ld:contextSourceInfo", + "contextSourceTimeAt": { + "@id": "ngsi-ld:contextSourceTimeAt", + "@type": "DateTime" + }, + "contextSourceUptime": "ngsi-ld:contextSourceUptime" + } + }, "ContextSourceNotification": "ngsi-ld:ContextSourceNotification", "ContextSourceRegistration": "ngsi-ld:ContextSourceRegistration", "Date": "ngsi-ld:Date", "DateTime": "ngsi-ld:DateTime", "EntityMap": "ngsi-ld:EntityMap", - "EntityType": "ngsi-ld:EntityType", - "EntityTypeInfo": "ngsi-ld:EntityTypeInfo", - "EntityTypeList": "ngsi-ld:EntityTypeList", + "EntityType": { + "@id": "ngsi-ld:EntityType", + "@context": { + "attributeNames": { + "@id": "ngsi-ld:attributeNames", + "@type": "@vocab" + }, + "typeName": { + "@id": "ngsi-ld:typeName", + "@type": "@vocab" + } + } + }, + "EntityTypeInfo": { + "@id": "ngsi-ld:EntityTypeInfo", + "@context": { + "attributeDetails": "attributeDetails", + "entityCount": "ngsi-ld:entityCount", + "typeName": { + "@id": "ngsi-ld:typeName", + "@type": "@vocab" + } + } + }, + "EntityTypeList": { + "@id": "ngsi-ld:EntityTypeList", + "@context": { + "typeList": { + "@id": "ngsi-ld:typeList", + "@type": "@vocab" + } + } + }, "ExecutionResultDetails": "ngsi-ld:ExecutionResultDetails", - "Feature": "geojson:Feature", - "FeatureCollection": "geojson:FeatureCollection", + "Feature": { + "@id": "geojson:Feature", + "@context": { + "geometry": "geojson:geometry", + "properties": "geojson:properties" + } + }, + "FeatureCollection": { + "@id": "geojson:FeatureCollection", + "@context": { + "features": { + "@container": "@set", + "@id": "geojson:features" + } + } + }, "GeoProperty": "ngsi-ld:GeoProperty", "GeometryCollection": "geojson:GeometryCollection", "JsonProperty": "ngsi-ld:JsonProperty", @@ -49,27 +133,12 @@ Such definition has been tested using [i.19]. "TemporalProperty": "ngsi-ld:TemporalProperty", "Time": "ngsi-ld:Time", "VocabProperty": "ngsi-ld:VocabProperty", - "accept": "ngsi-ld:accept", - "aggrParams": "ngsi-ld:aggrParams", - "aggrMethods": "ngsi-ld:aggrMethods", - "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration", - "attributeCount": "attributeCount", - "attributeDetails": "attributeDetails", - "attributeList": { - "@id": "ngsi-ld:attributeList", - "@type": "@vocab" - }, - "attributeName": { - "@id": "ngsi-ld:attributeName", - "@type": "@vocab" - }, - "attributeNames": { - "@id": "ngsi-ld:attributeNames", - "@type": "@vocab" - }, - "attributeTypes": { - "@id": "ngsi-ld:attributeTypes", - "@type": "@vocab" + "aggrParams": { + "@id": "ngsi-ld:aggrParams", + "@context": { + "aggrMethods": "ngsi-ld:aggrMethods", + "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration" + } }, "attributes": { "@id": "ngsi-ld:attributes", @@ -80,21 +149,8 @@ Such definition has been tested using [i.19]. "@container": "@list", "@id": "geojson:bbox" }, - "cacheDuration": "ngsi-ld:cacheDuration", - "collation": "ngsi-ld:collation", "containedBy": "ngsi-ld:isContainedBy", "contextSourceAlias": "ngsi-ld:contextSourceAlias", - "contextSourceExtras": { - "@id": "ngsi-ld:contextSourceExtras", - "@type": "@json" - }, - "contextSourceInfo": "ngsi-ld:contextSourceInfo", - "contextSourceTimeAt": { - "@id": "ngsi-ld:contextSourceTimeAt", - "@type": "DateTime" - }, - "contextSourceUptime": "ngsi-ld:contextSourceUptime", - "cooldown": "ngsi-ld:cooldown", "coordinates": { "@container": "@list", "@id": "geojson:coordinates" @@ -119,18 +175,19 @@ Such definition has been tested using [i.19]. }, "description": "http://purl.org/dc/terms/description", "detail": "ngsi-ld:detail", - "endAt": { - "@id": "ngsi-ld:endAt", - "@type": "DateTime" - }, - "endTimeAt": { - "@id": "ngsi-ld:endTimeAt", - "@type": "DateTime" + "endpoint": { + "@id": "ngsi-ld:endpoint", + "@context": { + "accept": "ngsi-ld:accept", + "cooldown": "ngsi-ld:cooldown", + "notifierInfo": "ngsi-ld:notifierInfo", + "receiverInfo": "ngsi-ld:receiverInfo", + "timeout": "ngsi-ld:timeout", + "uri": "ngsi-ld:uri" + } }, - "endpoint": "ngsi-ld:endpoint", "entities": "ngsi-ld:entities", "entity": "ngsi-ld:entity", - "entityCount": "ngsi-ld:entityCount", "entityId": { "@id": "ngsi-ld:entityId", "@type": "@id" @@ -151,15 +208,19 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:expiresAt", "@type": "DateTime" }, - "features": { - "@container": "@set", - "@id": "geojson:features" - }, "format": "ngsi-ld:format", - "geoQ": "ngsi-ld:geoQ", - "geometry": "geojson:geometry", - "geoproperty": "ngsi-ld:geoproperty", - "georel": "ngsi-ld:georel", + "geoQ": { + "@id": "ngsi-ld:geoQ", + "@context": { + "coordinates": { + "@container": "@list", + "@id": "geojson:coordinates" + }, + "geometry": "geojson:geometry", + "geoproperty": "ngsi-ld:geoproperty", + "georel": "ngsi-ld:georel" + } + }, "idPattern": "ngsi-ld:idPattern", "information": "ngsi-ld:information", "instanceId": { @@ -214,7 +275,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:lastFailure", "@type": "DateTime" }, - "lastN": "ngsi-ld:lastN", "lastNotification": { "@id": "ngsi-ld:lastNotification", "@type": "DateTime" @@ -228,10 +288,29 @@ Such definition has been tested using [i.19]. "@type": "DateTime" }, "linkedMaps": "ngsi-ld:linkedMaps", - "localOnly": "ngsi-ld:localOnly", "location": "ngsi-ld:location", - "management": "ngsi-ld:management", - "managementInterval": "ngsi-ld:managementInterval", + "management": { + "@id": "ngsi-ld:management", + "@context": { + "cacheDuration": "ngsi-ld:cacheDuration", + "cooldown": "ngsi-ld:cooldown", + "localOnly": "ngsi-ld:localOnly", + "timeout": "ngsi-ld:timeout" + } + }, + "managementInterval": { + "@id": "ngsi-ld:managementInterval", + "@context": { + "endAt": { + "@id": "ngsi-ld:endAt", + "@type": "DateTime" + }, + "startAt": { + "@id": "ngsi-ld:startAt", + "@type": "DateTime" + } + } + }, "mode": "ngsi-ld:mode", "modifiedAt": { "@id": "ngsi-ld:modifiedAt", @@ -257,7 +336,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:notifiedAt", "@type": "DateTime" }, - "notifierInfo": "ngsi-ld:notifierInfo", "notUpdated": "ngsi-ld:notUpdated", "object": { "@id": "ngsi-ld:hasObject", @@ -299,7 +377,19 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:hasObjectType", "@type": "@vocab" }, - "observationInterval": "ngsi-ld:observationInterval", + "observationInterval": { + "@id": "ngsi-ld:observationInterval", + "@context": { + "endAt": { + "@id": "ngsi-ld:endAt", + "@type": "DateTime" + }, + "startAt": { + "@id": "ngsi-ld:startAt", + "@type": "DateTime" + } + } + }, "observationSpace": "ngsi-ld:observationSpace", "observedAt": { "@id": "ngsi-ld:observedAt", @@ -308,11 +398,21 @@ Such definition has been tested using [i.19]. "omit": "ngsi-ld:omit", "operations": "ngsi-ld:operations", "operationSpace": "ngsi-ld:operationSpace", - "orderBy": { - "@container": "@list", - "@id": "ngsi-ld:orderBy" + "ordering": { + "@id": "ngsi-ld:ordering", + "@context": { + "collation": "ngsi-ld:collation", + "coordinates": { + "@container": "@list", + "@id": "geojson:coordinates" + }, + "geometry": "geojson:geometry", + "orderBy": { + "@container": "@list", + "@id": "ngsi-ld:orderBy" + } + } }, - "ordering": "ngsi-ld:ordering", "pick": "ngsi-ld:pick", "previousJson": { "@id": "ngsi-ld:hasPreviousJson", @@ -343,14 +443,12 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:problemDetails", "@type": "@json" }, - "properties": "geojson:properties", "propertyNames": { "@id": "ngsi-ld:propertyNames", "@type": "@vocab" }, "q": "ngsi-ld:q", "reason": "ngsi-ld:reason", - "receiverInfo": "ngsi-ld:receiverInfo", "refreshRate": "ngsi-ld:refreshRate", "registrationId": "ngsi-ld:registrationId", "registrationName": "ngsi-ld:registrationName", @@ -383,10 +481,6 @@ Such definition has been tested using [i.19]. "@container": "@list" }, "splitEntities": "ngsi-ld:hasSplitEntities", - "startAt": { - "@id": "ngsi-ld:startAt", - "@type": "DateTime" - }, "status": "ngsi-ld:status", "stddev": { "@id": "ngsi-ld:stddev", @@ -402,40 +496,37 @@ Such definition has been tested using [i.19]. "@type": "@id" }, "sysAttrs": "ngsi-ld:sysAttrs", - "temporalQ": "ngsi-ld:temporalQ", + "temporalQ": { + "@id": "ngsi-ld:temporalQ", + "@context": { + "aggrMethods": "ngsi-ld:aggrMethods", + "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration", + "endTimeAt": { + "@id": "ngsi-ld:endTimeAt", + "@type": "DateTime" + }, + "lastN": "ngsi-ld:lastN", + "timeAt": { + "@id": "ngsi-ld:timeAt", + "@type": "DateTime" + }, + "timeproperty": "ngsi-ld:timeproperty", + "timerel": "ngsi-ld:timerel" + } + }, "tenant": { "@id": "ngsi-ld:tenant", "@type": "@id" }, "throttling": "ngsi-ld:throttling", - "timeAt": { - "@id": "ngsi-ld:timeAt", - "@type": "DateTime" - }, "timeInterval": "ngsi-ld:timeInterval", - "timeout": "ngsi-ld:timeout", - "timeproperty": "ngsi-ld:timeproperty", - "timerel": "ngsi-ld:timerel", "timesFailed": "ngsi-ld:timesFailed", "timesSent": "ngsi-ld:timesSent", "title": "http://purl.org/dc/terms/title", "triggerReason": "ngsi-ld:triggerReason", - "typeList": { - "@id": "ngsi-ld:typeList", - "@type": "@vocab" - }, - "typeName": { - "@id": "ngsi-ld:typeName", - "@type": "@vocab" - }, - "typeNames": { - "@id": "ngsi-ld:typeNames", - "@type": "@vocab" - }, "unchanged": "ngsi-ld:unchanged", "unitCode": "ngsi-ld:unitCode", "updated": "ngsi-ld:updated", - "uri": "ngsi-ld:uri", "value": "ngsi-ld:hasValue", "valueList": { "@id": "ngsi-ld:hasValueList", -- GitLab From 583b1022db965c6640a30920ef12280886a620ef Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 19:04:19 +0100 Subject: [PATCH 02/19] Correct Data type names. --- md/clause-5.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index e047313..8a0d235 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -411,9 +411,9 @@ Table: Matrix of all Attributes +--------------------------------+-----------------------------------------------------------------------+ | format | NotificationParams | +--------------------------------+-----------------------------------------------------------------------+ -| geoQ | Feature, Query, Subscription | +| geoQ | Query, Subscription | +--------------------------------+-----------------------------------------------------------------------+ -| geometry | OrderingParams, GeoParams | +| geometry | Feature, OrderingParams, GeoParams | +--------------------------------+-----------------------------------------------------------------------+ | geoproperty | GeoParams | +--------------------------------+-----------------------------------------------------------------------+ @@ -2066,11 +2066,11 @@ Table: Query data type definition +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | q | String | A valid query string as per Clause+++clause-7+++7.2.3 | 0..1 | Query that shall be matched by Entities in order to be retrieved. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -| geoQ | GeoQuery | See data type definition in Clause+++root.2.6.5.2 | 0..1 | Geoquery that shall be matched by Entities in order be retrieved. | +| geoQ | GeoParams | See data type definition in Clause+++root.2.6.5.2 | 0..1 | Geoquery that shall be matched by Entities in order be retrieved. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | scopeQ | String | See Clause+++clause-7+++7.2.5 | 0..1 | Scope query. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -| temporalQ | TemporalQuery | See data type definition in Clause+++root.2.6.7.4 | 0..1 | Temporal Query to be present only for "Query | +| temporalQ | TemporalParams | See data type definition in Clause+++root.2.6.7.4 | 0..1 | Temporal Query to be present only for "Query | | | | | | [Temporal Evolution of Entities]{.HTML-Keyboard}" operation (Clause+++clause-11+++11.3.3). | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | attrs | String[] | Attribute name as short hand strings or URIs. | 0..1 | A synonym for a combination of the *pick* and*q* members. **Deprecated** | @@ -2141,7 +2141,7 @@ Table: Query data type definition +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | splitEntities | Boolean | default decided by implementation; it should be configurable. The parameter does not apply in case | 0..1 | If _`true`_ it is assumed that single Entities are distributed between different | | | | the parameter _`local`_ is _`true`_ or the query applies to a Snapshot | | Context Brokers and/or Context Sources and this has to be taken into account when | -| | | | | applying any kind of filters (q, geoQ, scopeQ, Attributes etc.). | +| | | | | applying any kind of filters (_`q`_, _`geoQ`_, _`scopeQ`_, Attributes etc.). | | | | | | If _`false`_ it is expected that Context Broker and/or Context Source | | | | | | always have complete Entities, which allows applying filters locally. | | | | | | | @@ -2193,11 +2193,11 @@ Table: Subscription data type definition +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | q | String | A valid query string as per Clause+++clause-7+++7.2.3 | 0..1 | Query that shall be met by subscribed entities in order to trigger the notification. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -| geoQ | GeoQuery | See data type definition in Clause+++root.2.6.7.2 | 0..1 | Geoquery that shall be met by subscribed entities in order to trigger the notification. | +| geoQ | GeoParams | See data type definition in Clause+++root.2.6.7.2 | 0..1 | Geoquery that shall be met by subscribed entities in order to trigger the notification. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | scopeQ | String | See Clause+++clause-7+++7.2.5 | 0..1 | Scope query. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -| temporalQ | TemporalQuery | See data type definition in Clause+++root.2.6.7.4 | 0..1 | Temporal Query to be used **only** in *Context Registration Subscriptions* | +| temporalQ | TemporalParams | See data type definition in Clause+++root.2.6.7.4 | 0..1 | Temporal Query to be used **only** in *Context Registration Subscriptions* | | | | | | for matching [Context Source Registrations]{.HTML-Keyboard} of | | | | | | [Context Sources]{.HTML-Keyboard} providing temporal information. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ @@ -2359,7 +2359,7 @@ Table: CSourceRegistration data type definition | | | | | | | | | | | | +---------------------+--------------------------------------------+----------------------------------------------------------------------------------------------+-------------+------------------------------------------------------------------------------------------------------------------------------------------+ -| managementInterval | TimeInterval | See data type definition in Clause+++root.2.6.7.1 | 0..1 | If present, the [Context Source]{.HTML-Keyboard} can be queried for Temporal Entity Representations. | +| managementInterval | TimeIntervalParams | See data type definition in Clause+++root.2.6.7.1 | 0..1 | If present, the [Context Source]{.HTML-Keyboard} can be queried for Temporal Entity Representations. | | | | | | (If latest Entity information is also provided, a separate Context Registration is needed for this purpose). | | | | | | The _`managementInterval`_ specifies the time interval for which the [Context Source]{.HTML-Keyboard} can provide | | | | | | Entity information as specified by the _`createdAt`_, _`modifiedAt`_ and _`deletedAt`_ Temporal Properties. | @@ -2373,7 +2373,7 @@ Table: CSourceRegistration data type definition | | | The mode is assumed to be ["inclusive"]{.HTML-Code} if not explicitly defined | | | | | | | | | +---------------------+--------------------------------------------+----------------------------------------------------------------------------------------------+-------------+------------------------------------------------------------------------------------------------------------------------------------------+ -| observationInterval | TimeInterval | See data type definition in Clause+++root.2.6.7.1 | 0..1 | If present, the [Context Source]{.HTML-Keyboard} can be queried for Temporal Entity Representations. | +| observationInterval | TimeIntervalParams | See data type definition in Clause+++root.2.6.7.1 | 0..1 | If present, the [Context Source]{.HTML-Keyboard} can be queried for Temporal Entity Representations. | | | | | | (If latest Entity information is also provided, a separate Context Registration is needed for this purpose). | | | | | | The _`observationInterval`_ specifies the time interval for which the [Context Source]{.HTML-Keyboard} can provide | | | | | | Entity information as specified by the _`observedAt`_ Temporal Property. A temporal query based on the _`observedAt`_ | -- GitLab From 02075b8e3dbd608672536841817266a4bfee3b4f Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 20:15:18 +0100 Subject: [PATCH 03/19] Add type-scoped context to Notifications --- md/annex-b.md | 39 ++++++++++++++++++++++++++++++--------- 1 file changed, 30 insertions(+), 9 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index 6446003..563ee96 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -57,7 +57,21 @@ Such definition has been tested using [i.19]. "contextSourceUptime": "ngsi-ld:contextSourceUptime" } }, - "ContextSourceNotification": "ngsi-ld:ContextSourceNotification", + "ContextSourceNotification": { + "@id": "ngsi-ld:ContextSourceNotification", + "@context": { + "data": "ngsi-ld:data", + "notifiedAt": { + "@id": "ngsi-ld:notifiedAt", + "@type": "DateTime" + }, + "subscriptionId": { + "@id": "ngsi-ld:subscriptionId", + "@type": "@id" + }, + "triggerReason": "ngsi-ld:triggerReason" + } + }, "ContextSourceRegistration": "ngsi-ld:ContextSourceRegistration", "Date": "ngsi-ld:Date", "DateTime": "ngsi-ld:DateTime", @@ -122,7 +136,20 @@ Such definition has been tested using [i.19]. "MultiLineString": "geojson:MultiLineString", "MultiPoint": "geojson:MultiPoint", "MultiPolygon": "geojson:MultiPolygon", - "Notification": "ngsi-ld:Notification", + "Notification": { + "@id": "ngsi-ld:Notification", + "@context": { + "data": "ngsi-ld:data", + "notifiedAt": { + "@id": "ngsi-ld:notifiedAt", + "@type": "DateTime" + }, + "subscriptionId": { + "@id": "ngsi-ld:subscriptionId", + "@type": "@id" + } + } + }, "Point": "geojson:Point", "Polygon": "geojson:Polygon", "Property": "ngsi-ld:Property", @@ -160,7 +187,6 @@ Such definition has been tested using [i.19]. "@type": "DateTime" }, "csf": "ngsi-ld:csf", - "data": "ngsi-ld:data", "dataset": { "@id": "ngsi-ld:hasDataset", "@container": "@index" @@ -378,7 +404,7 @@ Such definition has been tested using [i.19]. "@type": "@vocab" }, "observationInterval": { - "@id": "ngsi-ld:observationInterval", + "@id": "ngsi-ld:observationInterval", "@context": { "endAt": { "@id": "ngsi-ld:endAt", @@ -486,10 +512,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:stddev", "@container": "@list" }, - "subscriptionId": { - "@id": "ngsi-ld:subscriptionId", - "@type": "@id" - }, "subscriptionName": "ngsi-ld:subscriptionName", "success": { "@id": "ngsi-ld:success", @@ -523,7 +545,6 @@ Such definition has been tested using [i.19]. "timesFailed": "ngsi-ld:timesFailed", "timesSent": "ngsi-ld:timesSent", "title": "http://purl.org/dc/terms/title", - "triggerReason": "ngsi-ld:triggerReason", "unchanged": "ngsi-ld:unchanged", "unitCode": "ngsi-ld:unitCode", "updated": "ngsi-ld:updated", -- GitLab From 3e868cec75a02ea9a8829640a05e6cbdb7ace841 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 21:48:52 +0100 Subject: [PATCH 04/19] Add notification --- md/annex-b.md | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index 563ee96..ce3d1ab 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -167,10 +167,6 @@ Such definition has been tested using [i.19]. "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration" } }, - "attributes": { - "@id": "ngsi-ld:attributes", - "@type": "@vocab" - }, "attrs": "ngsi-ld:attrs", "bbox": { "@container": "@list", @@ -234,7 +230,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:expiresAt", "@type": "DateTime" }, - "format": "ngsi-ld:format", "geoQ": { "@id": "ngsi-ld:geoQ", "@context": { @@ -356,7 +351,18 @@ Such definition has been tested using [i.19]. ] }, "ngsildConformance": "ngsi-ld:ngsildConformance", - "notification": "ngsi-ld:notification", + "notification": { + "@id": "ngsi-ld:notification", + "@context": { + "attributes": { + "@id": "ngsi-ld:attributes", + "@type": "@vocab" + }, + "format": "ngsi-ld:format", + "showChanges": "ngsi-ld:showChanges", + "sysAttrs": "ngsi-ld:sysAttrs" + } + }, "notificationTrigger": "ngsi-ld:notificationTrigger", "notifiedAt": { "@id": "ngsi-ld:notifiedAt", @@ -485,7 +491,6 @@ Such definition has been tested using [i.19]. "resultStatus": "ngsi-ld:resultStatus", "scope": "ngsi-ld:scope", "scopeQ": "ngsi-ld:scopeQ", - "showChanges": "ngsi-ld:showChanges", "snapshotId": "ngsi-ld:snapshotId", "snapshotLifetime": "ngsi-ld:snapshotLifetime", "snapshotPriority": "ngsi-ld:snapshotPriority", @@ -517,7 +522,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:success", "@type": "@id" }, - "sysAttrs": "ngsi-ld:sysAttrs", "temporalQ": { "@id": "ngsi-ld:temporalQ", "@context": { -- GitLab From 15841230fdf7e0f6167e18862167bcc2f5d8d90c Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 21:49:17 +0100 Subject: [PATCH 05/19] Add scoping to attribute table. --- md/clause-5.md | 688 +++++++++++++++++++++++++------------------------ 1 file changed, 350 insertions(+), 338 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 8a0d235..4ba8566 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -309,342 +309,353 @@ Table: Matrix of all Attributes ::: ::: TAL -+--------------------------------+-----------------------------------------------------------------------+ -| Name | Data Type using the attribute | -+================================+=======================================================================+ -| accept | Endpoint | -+--------------------------------+-----------------------------------------------------------------------+ -| aggrParams | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| aggrMethods | AggregationParams, TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| aggrPeriodDuration | AggregationParams, TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeCount | Attribute | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeDetails | EntityTypeInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeList | AttributeList | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeName | Attribute, NotUpdatedResult | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeNames | EntityType | -+--------------------------------+-----------------------------------------------------------------------+ -| attributeTypes | Attribute, EntityTypeInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| attributes | NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| attrs | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| cacheDuration | RegistrationManagementInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| collation | OrderingParams | -+--------------------------------+-----------------------------------------------------------------------+ -| containedBy | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| contextSourceAlias | ContextSourceIdentity, CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| contextSourceExtras | ContextSourceIdentity | -+--------------------------------+-----------------------------------------------------------------------+ -| contextSourceInfo | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| contextSourceTimeAt | ContextSourceIdentity | -+--------------------------------+-----------------------------------------------------------------------+ -| contextSourceUptime | ContextSourceIdentity | -+--------------------------------+-----------------------------------------------------------------------+ -| cooldown | Endpoint, RegistrationManagementInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| coordinates | GeoParams, OrderingParams | -+--------------------------------+-----------------------------------------------------------------------+ -| createdAt | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | -| | | -+--------------------------------+-----------------------------------------------------------------------+ -| createEntityMap | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| csf | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| data | CSourceNotification, Notification | -+--------------------------------+-----------------------------------------------------------------------+ -| datasetId | Property, Relationship, GeoProperty, ListProperty, | -| | ListRelationship, LanguageProperty, JsonProperty, | -| | VocabProperty, Subscription, CSourceRegistration, Query | -+--------------------------------+-----------------------------------------------------------------------+ -| deletedAt | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty, Subscription | -| | | -+--------------------------------+-----------------------------------------------------------------------+ -| description | CSourceRegistration, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| endAt | TimeIntervalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| endTimeAt | TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| endpoint | CSourceRegistration, Snapshot, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| entities | Query, RegistrationInfo, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| entity | Relationship | -+--------------------------------+-----------------------------------------------------------------------+ -| entityCount | EntityTypeInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| entityId | EntityError | -+--------------------------------+-----------------------------------------------------------------------+ -| entityList | ListRelationship | -+--------------------------------+-----------------------------------------------------------------------+ -| entityMap | EntityMap | -+--------------------------------+-----------------------------------------------------------------------+ -| entityMapLifetime | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| error | EntityError | -+--------------------------------+-----------------------------------------------------------------------+ -| errors | OperationResult | -+--------------------------------+-----------------------------------------------------------------------+ -| expandValues | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| expiresAt | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty, Subscription, | -| | CSourceRegistration, SnapshotNotification, EntityMap, Entity, | -| | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| features | FeatureCollection | -+--------------------------------+-----------------------------------------------------------------------+ -| format | NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| geoQ | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| geometry | Feature, OrderingParams, GeoParams | -+--------------------------------+-----------------------------------------------------------------------+ -| geoproperty | GeoParams | -+--------------------------------+-----------------------------------------------------------------------+ -| georel | GeoParams | -+--------------------------------+-----------------------------------------------------------------------+ -| idPattern | EntitySelector, EntityInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| information | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| instanceId | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| isActive | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| join | Query, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| joinLevel | Query, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| json | JsonProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| jsonKeys | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| jsonldContext | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| jsons | JsonProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| key | KeyValuePair | -+--------------------------------+-----------------------------------------------------------------------+ -| lang | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| languageMap | LanguageProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| languageMaps | LanguageProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| lastFailure | CSourceRegistration, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| lastN | TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| lastNotification | NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| lastSuccess | CSourceRegistration, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| lastUsedAt | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| linkedMaps | EntityMap | -+--------------------------------+-----------------------------------------------------------------------+ -| localOnly | Query, RegistrationMangementInfo, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| location | Entity, CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| management | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| managementInterval | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| mode | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| modifiedAt | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty, Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| ngsildproof | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty | -| | | -+--------------------------------+-----------------------------------------------------------------------+ -| ngsildConformance | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| notification | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| notificationTrigger | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| notifiedAt | CSourceNotification, Notification, SnapshotNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| notifierInfo | Endpoint | -+--------------------------------+-----------------------------------------------------------------------+ -| notUpdated | UpdateResult | -+--------------------------------+-----------------------------------------------------------------------+ -| object | Relationship | -+--------------------------------+-----------------------------------------------------------------------+ -| objectList | ListRelationship | -+--------------------------------+-----------------------------------------------------------------------+ -| objectLists | ListRelationship | -+--------------------------------+-----------------------------------------------------------------------+ -| objects | Relationship | -+--------------------------------+-----------------------------------------------------------------------+ -| objectType | Relationship, ListRelationship | -+--------------------------------+-----------------------------------------------------------------------+ -| observationInterval | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| observationSpace | CSourceRegistration, Entity | -+--------------------------------+-----------------------------------------------------------------------+ -| observedAt | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | -| | LanguageProperty, JsonProperty, VocabProperty | -| | | -+--------------------------------+-----------------------------------------------------------------------+ -| omit | Query, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| operations | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| operationSpace | CSourceRegistration, Entity | -+--------------------------------+-----------------------------------------------------------------------+ -| orderBy | OrderingParams | -+--------------------------------+-----------------------------------------------------------------------+ -| ordering | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| pick | Query, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| previousJson | JsonProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| previousLanguageMap | LanguageProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| previousObject | Relationship | -+--------------------------------+-----------------------------------------------------------------------+ -| previousObjectList | ListRelationship | -+--------------------------------+-----------------------------------------------------------------------+ -| previousValue | Property, GeoProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| previousValueList | ListProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| previousVocab | VocabProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| problemDetails | ExecutionResult | -+--------------------------------+-----------------------------------------------------------------------+ -| properties | Feature | -+--------------------------------+-----------------------------------------------------------------------+ -| propertyNames | RegistrationInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| q | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| reason | NotUpdatedResult | -+--------------------------------+-----------------------------------------------------------------------+ -| receiverInfo | Endpoint, Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| refreshRate | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| registrationId | NotUpdatedResult, EntityError | -+--------------------------------+-----------------------------------------------------------------------+ -| registrationName | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| relationshipNames | RegistrationInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| resultStatus | ExecutionResult | -+--------------------------------+-----------------------------------------------------------------------+ -| scope | CSourceRegistration, Entity | -+--------------------------------+-----------------------------------------------------------------------+ -| scopeQ | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| showChanges | NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotId | SnapshotNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotLifetime | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotPriority | SnapshotNotification, Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotQueries | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotQueriesDetails | Snapshot, SnapshotNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotStatus | Snapshot, SnapshotNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotTemporalQueries | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| snapshotTemporalQueriesDetails | Snapshot | -+--------------------------------+-----------------------------------------------------------------------+ -| splitEntities | Query | -+--------------------------------+-----------------------------------------------------------------------+ -| startAt | TimeIntervalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| status | CSourceRegistration, NotificationParams, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| subscriptionId | CSourceNotification, Notification | -+--------------------------------+-----------------------------------------------------------------------+ -| subscriptionName | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| success | OperationResult | -+--------------------------------+-----------------------------------------------------------------------+ -| sysAttrs | NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| temporalQ | Query, Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| temporalSnapshotQueriesDetails | SnapshotNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| tenant | CSourceRegistration | -+--------------------------------+-----------------------------------------------------------------------+ -| throttling | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| timeAt | TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| timeInterval | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ -| timeout | Endpoint, RegistrationManagementInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| timeproperty | TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| timerel | TemporalParams | -+--------------------------------+-----------------------------------------------------------------------+ -| timesFailed | CSourceRegistration, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| timesSent | CSourceRegistration, NotificationParams | -+--------------------------------+-----------------------------------------------------------------------+ -| triggerReason | CSourceNotification | -+--------------------------------+-----------------------------------------------------------------------+ -| typeList | EntityTypeList | -+--------------------------------+-----------------------------------------------------------------------+ -| typeName | EntityType, EntityTypeInfo | -+--------------------------------+-----------------------------------------------------------------------+ -| typeNames | Attribute | -+--------------------------------+-----------------------------------------------------------------------+ -| unitCode | Property, ListProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| updated | UpdateResult | -+--------------------------------+-----------------------------------------------------------------------+ -| uri | Endpoint | -+--------------------------------+-----------------------------------------------------------------------+ -| value | Property, GeoProperty, KeyValuePair | -+--------------------------------+-----------------------------------------------------------------------+ -| valueList | ListProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| valueLists | ListProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| values | Property, ListProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| valueType | Property, GeoProperty, ListProperty, | -| | LanguageProperty, JsonProperty, VocabProperty | -| | | -+--------------------------------+-----------------------------------------------------------------------+ -| vocab | VocabProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| vocabs | VocabProperty | -+--------------------------------+-----------------------------------------------------------------------+ -| watchedAttributes | Subscription | -+--------------------------------+-----------------------------------------------------------------------+ ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| Name | Data Type using the attribute | Core _`@context`_ JSON-LD Scope | ++====================================+=======================================================================+===========================================+ +| _`accept`_ | Endpoint | Property-scoped within _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`aggrParams`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped within _`aggrParams`_, | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped within _`aggrParams`_, | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeCount`_ | Attribute | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeDetails`_ | EntityTypeInfo | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeList `_ | AttributeList | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeName`_ | Attribute, NotUpdatedResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeNames `_ | EntityType | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributeTypes`_ | Attribute | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attributes`_ | NotificationParams | Property-scoped within _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`attrs`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped within _`management`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`collation`_ | OrderingParams | Property-scoped within _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`containedBy `_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`contextSourceAlias `_ | ContextSourceIdentity, CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`contextSourceExtras`_ | ContextSourceIdentity | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`contextSourceInfo`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`contextSourceTimeAt`_ | ContextSourceIdentity | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`contextSourceUptime`_ | ContextSourceIdentity | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped within _`management`_, | +| | | _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`coordinates`_ | GeoParams, OrderingParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`createdAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`createEntityMap`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`csf`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`data `_ | CSourceNotification, Notification | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`datasetId `_ | Property, Relationship, GeoProperty, ListProperty, | | +| | ListRelationship, LanguageProperty, JsonProperty, | | +| | VocabProperty, Subscription, CSourceRegistration, Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`deletedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Subscription | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`description`_ | CSourceRegistration, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`endAt`_ | TimeIntervalParams | Property-scoped within | +| | | _`managementInterval`_, | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`endTimeAt`_ | TemporalParams | Property-scoped within _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`endpoint`_ | CSourceRegistration, Snapshot, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entities`_ | Query, RegistrationInfo, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entity`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entityCount`_ | EntityTypeInfo | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entityId`_ | EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entityList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entityMap`_ | EntityMap | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`entityMapLifetime`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`error`_ | EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`errors`_ | OperationResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`expandValues`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`expiresAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Subscription, | | +| | CSourceRegistration, SnapshotNotification, EntityMap, Entity, | | +| | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`features`_ | FeatureCollection | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`format`_ | NotificationParams | Property-scoped within _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`geoQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`geometry`_ | Feature, OrderingParams, GeoParams | Type-scoped within Feature, | +| | | Property-scoped within | +| | | _`geoQ`_, _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`geoproperty`_ | GeoParams | Property-scoped within _`geoRel`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`georel`_ | GeoParams | Property-scoped within _`geoRel`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`idPattern `_ | EntitySelector, EntityInfo | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`information`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`instanceId`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`isActive`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`join `_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`joinLevel`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`json `_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`jsonKeys`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`jsonldContext `_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`jsons`_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`key`_ | KeyValuePair | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lang`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`languageMap `_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`languageMaps`_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lastFailure`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lastN`_ | TemporalParams | Property-scoped within _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lastNotification`_ | NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lastSuccess`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`lastUsedAt`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`linkedMaps`_ | EntityMap | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`localOnly`_ | Query, RegistrationMangementInfo, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`location`_ | Entity, CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`management`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`managementInterval`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`mode`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`modifiedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`ngsildproof `_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`ngsildConformance`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`notification`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`notificationTrigger`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`notifiedAt`_ | CSourceNotification, Notification, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`notifierInfo`_ | Endpoint | Property-scoped within _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`notUpdated`_ | UpdateResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`object`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`objectList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`objectLists`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`objects`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`objectType`_ | Relationship, ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`observationInterval`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`observationSpace`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`observedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`omit`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`operations`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`operationSpace`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`orderBy`_ | OrderingParams | Property-scoped within _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`ordering`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`pick`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousJson`_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousLanguageMap`_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousObject`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousObjectList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousValue`_ | Property, GeoProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousValueList`_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`previousVocab`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`problemDetails`_ | ExecutionResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`properties`_ | Feature | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`propertyNames`_ | RegistrationInfo | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`q`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`reason`_ | NotUpdatedResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`receiverInfo`_ | Endpoint, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`refreshRate`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`registrationId`_ | NotUpdatedResult, EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`registrationName`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`relationshipNames`_ | RegistrationInfo | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`resultStatus`_ | ExecutionResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`scope`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`scopeQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`showChanges`_ | NotificationParams | Property-scoped within _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotId`_ | SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotLifetime`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotPriority`_ | SnapshotNotification, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotQueries`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotQueriesDetails`_ | Snapshot, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotStatus`_ | Snapshot, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotTemporalQueries`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`snapshotTemporalQueriesDetails`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`splitEntities`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`startAt`_ | TimeIntervalParams | Property-scoped within | +| | | _`managementInterval`_, | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`status`_ | CSourceRegistration, NotificationParams, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`subscriptionId`_ | CSourceNotification, Notification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`subscriptionName`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`success`_ | OperationResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`sysAttrs`_ | NotificationParams | Property-scoped within _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`temporalQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`temporalSnapshotQueriesDetails`_ | SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`tenant`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`throttling`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timeAt`_ | TemporalParams | Property-scoped within _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timeInterval`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timeout `_ | Endpoint, RegistrationManagementInfo | Property-scoped | +| | | _`managementInterval`_, | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timeproperty`_ | TemporalParams | Property-scoped within _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timerel`_ | TemporalParams | Property-scoped within _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timesFailed`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`timesSent`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`triggerReason`_ | CSourceNotification | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`typeList`_ | EntityTypeList | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`typeName`_ | EntityType, EntityTypeInfo | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`typeNames `_ | Attribute | Type-scoped | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`unitCode`_ | Property, ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`updated`_ | UpdateResult | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`uri `_ | Endpoint | Property-scoped within _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`value`_ | Property, GeoProperty, KeyValuePair | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`valueList`_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`valueLists `_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`values`_ | Property, ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`valueType`_ | Property, GeoProperty, ListProperty, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`vocab`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`vocabs`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ +| _`watchedAttributes `_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ ::: @@ -658,8 +669,9 @@ Core _`@context`_: - ["avg"]{.HTML-Code}, ["distinctCount"]{.HTML-Code}, ["max"]{.HTML-Code}, ["min"]{.HTML-Code}, ["stddev"]{.HTML-Code}, ["sum"]{.HTML-Code}, - ["sumsq"]{.HTML-Code}, ["totalCount"]{.HTML-Code} are used by the Aggregated - temporal representation of an Entity. See Clause+++root.3.2.7 + ["sumsq"]{.HTML-Code}, ["totalCount"]{.HTML-Code} are Property-scoped and + used by the Aggregated temporal representation of an Entity. See Clause + 5.3.2.7 - ["bbox"]{.HTML-Code}, ["properties"]{.HTML-Code}, ["coordinates"]{.HTML-Code} are used in geographic operations and retain their standard GeoJSON-LD -- GitLab From 1bd10050aff08c886a7f3048298654bebf55d738 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 2 Dec 2025 23:24:11 +0100 Subject: [PATCH 06/19] Update text --- md/clause-5.md | 100 +++++++++++++++++++++++++++++-------------------- 1 file changed, 60 insertions(+), 40 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 4ba8566..3153848 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -310,51 +310,58 @@ Table: Matrix of all Attributes ::: TAL +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| Name | Data Type using the attribute | Core _`@context`_ JSON-LD Scope | +| Name | Data Type using the attribute | Core _`@context`_ Definition | +====================================+=======================================================================+===========================================+ -| _`accept`_ | Endpoint | Property-scoped within _`endpoint`_ | +| _`accept`_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`aggrParams`_ | Query | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped within _`aggrParams`_, | +| _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped definition within | +| | | _`aggrParams`_, | | | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped within _`aggrParams`_, | +| _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped definition within | +| | | _`aggrParams`_, | | | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeCount`_ | Attribute | Type-scoped | +| _`attributeCount`_ | Attribute | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeDetails`_ | EntityTypeInfo | Type-scoped | +| _`attributeDetails`_ | EntityTypeInfo | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeList `_ | AttributeList | Type-scoped | +| _`attributeList `_ | AttributeList | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`attributeName`_ | Attribute, NotUpdatedResult | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeNames `_ | EntityType | Type-scoped | +| _`attributeNames `_ | EntityType | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeTypes`_ | Attribute | Type-scoped | +| _`attributeTypes`_ | Attribute | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributes`_ | NotificationParams | Property-scoped within _`notification`_ | +| _`attributes`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`attrs`_ | Query | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped within _`management`_ | +| _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped definition within | +| | | _`management`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`collation`_ | OrderingParams | Property-scoped within _`ordering`_ | +| _`collation`_ | OrderingParams | Property-scoped definition within | +| | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`containedBy `_ | Query | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`contextSourceAlias `_ | ContextSourceIdentity, CSourceRegistration | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceExtras`_ | ContextSourceIdentity | Type-scoped | +| _`contextSourceExtras`_ | ContextSourceIdentity | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`contextSourceInfo`_ | CSourceRegistration | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceTimeAt`_ | ContextSourceIdentity | Type-scoped | +| _`contextSourceTimeAt`_ | ContextSourceIdentity | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceUptime`_ | ContextSourceIdentity | Type-scoped | +| _`contextSourceUptime`_ | ContextSourceIdentity | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped within _`management`_, | +| _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | +| | | _`management`_, | | | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`coordinates`_ | GeoParams, OrderingParams | | @@ -367,7 +374,7 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`csf`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`data `_ | CSourceNotification, Notification | Type-scoped | +| _`data `_ | CSourceNotification, Notification | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`datasetId `_ | Property, Relationship, GeoProperty, ListProperty, | | | | ListRelationship, LanguageProperty, JsonProperty, | | @@ -379,11 +386,12 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`description`_ | CSourceRegistration, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`endAt`_ | TimeIntervalParams | Property-scoped within | +| _`endAt`_ | TimeIntervalParams | Property-scoped definition within | | | | _`managementInterval`_, | | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`endTimeAt`_ | TemporalParams | Property-scoped within _`temporalQ`_ | +| _`endTimeAt`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`endpoint`_ | CSourceRegistration, Snapshot, NotificationParams | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -391,7 +399,7 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`entity`_ | Relationship | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityCount`_ | EntityTypeInfo | Type-scoped | +| _`entityCount`_ | EntityTypeInfo | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`entityId`_ | EntityError | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -412,19 +420,22 @@ Table: Matrix of all Attributes | | CSourceRegistration, SnapshotNotification, EntityMap, Entity, | | | | Snapshot | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`features`_ | FeatureCollection | Type-scoped | +| _`features`_ | FeatureCollection | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`format`_ | NotificationParams | Property-scoped within _`notification`_ | +| _`format`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`geoQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`geometry`_ | Feature, OrderingParams, GeoParams | Type-scoped within Feature, | -| | | Property-scoped within | +| | | Property-scoped definition within | | | | _`geoQ`_, _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`geoproperty`_ | GeoParams | Property-scoped within _`geoRel`_ | +| _`geoproperty`_ | GeoParams | Property-scoped definition within | +| | | _`geoRel`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`georel`_ | GeoParams | Property-scoped within _`geoRel`_ | +| _`georel`_ | GeoParams | Property-scoped definition within | +| | | _`geoRel`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`idPattern `_ | EntitySelector, EntityInfo | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -457,7 +468,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`lastFailure`_ | CSourceRegistration, NotificationParams | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastN`_ | TemporalParams | Property-scoped within _`temporalQ`_ | +| _`lastN`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`lastNotification`_ | NotificationParams | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -492,7 +504,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`notifiedAt`_ | CSourceNotification, Notification, SnapshotNotification | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notifierInfo`_ | Endpoint | Property-scoped within _`endpoint`_ | +| _`notifierInfo`_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`notUpdated`_ | UpdateResult | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -520,7 +533,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`operationSpace`_ | CSourceRegistration, Entity | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`orderBy`_ | OrderingParams | Property-scoped within _`ordering`_ | +| _`orderBy`_ | OrderingParams | Property-scoped definition within | +| | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`ordering`_ | Query | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -542,7 +556,7 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`problemDetails`_ | ExecutionResult | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`properties`_ | Feature | Type-scoped | +| _`properties`_ | Feature | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`propertyNames`_ | RegistrationInfo | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -566,7 +580,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`scopeQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`showChanges`_ | NotificationParams | Property-scoped within _`notification`_ | +| _`showChanges`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`snapshotId`_ | SnapshotNotification | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -586,7 +601,7 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`splitEntities`_ | Query | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`startAt`_ | TimeIntervalParams | Property-scoped within | +| _`startAt`_ | TimeIntervalParams | Property-scoped definition within | | | | _`managementInterval`_, | | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -598,7 +613,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`success`_ | OperationResult | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`sysAttrs`_ | NotificationParams | Property-scoped within _`notification`_ | +| _`sysAttrs`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`temporalQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -608,17 +624,20 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`throttling`_ | Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeAt`_ | TemporalParams | Property-scoped within _`temporalQ`_ | +| _`timeAt`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`timeInterval`_ | Subscription | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeout `_ | Endpoint, RegistrationManagementInfo | Property-scoped | +| _`timeout `_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | | | | _`managementInterval`_, | | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeproperty`_ | TemporalParams | Property-scoped within _`temporalQ`_ | +| _`timeproperty`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timerel`_ | TemporalParams | Property-scoped within _`temporalQ`_ | +| _`timerel`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`timesFailed`_ | CSourceRegistration, NotificationParams | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ @@ -626,17 +645,18 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`triggerReason`_ | CSourceNotification | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeList`_ | EntityTypeList | Type-scoped | +| _`typeList`_ | EntityTypeList | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeName`_ | EntityType, EntityTypeInfo | Type-scoped | +| _`typeName`_ | EntityType, EntityTypeInfo | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeNames `_ | Attribute | Type-scoped | +| _`typeNames `_ | Attribute | Type-scoped definition | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`unitCode`_ | Property, ListProperty | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`updated`_ | UpdateResult | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`uri `_ | Endpoint | Property-scoped within _`endpoint`_ | +| _`uri `_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ | _`value`_ | Property, GeoProperty, KeyValuePair | | +------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -- GitLab From 758e6e68cb5f11c03abb6f03de0d6ac7b8769e2a Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Wed, 3 Dec 2025 09:29:52 +0100 Subject: [PATCH 07/19] Add types --- md/clause-5.md | 749 +++++++++++++++++++++++++------------------------ 1 file changed, 382 insertions(+), 367 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 3153848..398ce39 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -309,373 +309,388 @@ Table: Matrix of all Attributes ::: ::: TAL -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| Name | Data Type using the attribute | Core _`@context`_ Definition | -+====================================+=======================================================================+===========================================+ -| _`accept`_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`aggrParams`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped definition within | -| | | _`aggrParams`_, | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped definition within | -| | | _`aggrParams`_, | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeCount`_ | Attribute | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeDetails`_ | EntityTypeInfo | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeList `_ | AttributeList | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeName`_ | Attribute, NotUpdatedResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeNames `_ | EntityType | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributeTypes`_ | Attribute | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attributes`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`attrs`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped definition within | -| | | _`management`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`collation`_ | OrderingParams | Property-scoped definition within | -| | | _`ordering`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`containedBy `_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceAlias `_ | ContextSourceIdentity, CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceExtras`_ | ContextSourceIdentity | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceInfo`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceTimeAt`_ | ContextSourceIdentity | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`contextSourceUptime`_ | ContextSourceIdentity | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | -| | | _`management`_, | -| | | _`endpoint`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`coordinates`_ | GeoParams, OrderingParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`createdAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | | -| | | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`createEntityMap`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`csf`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`data `_ | CSourceNotification, Notification | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`datasetId `_ | Property, Relationship, GeoProperty, ListProperty, | | -| | ListRelationship, LanguageProperty, JsonProperty, | | -| | VocabProperty, Subscription, CSourceRegistration, Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`deletedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty, Subscription | | -| | | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`description`_ | CSourceRegistration, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`endAt`_ | TimeIntervalParams | Property-scoped definition within | -| | | _`managementInterval`_, | -| | | _`observationInterval`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`endTimeAt`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`endpoint`_ | CSourceRegistration, Snapshot, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entities`_ | Query, RegistrationInfo, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entity`_ | Relationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityCount`_ | EntityTypeInfo | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityId`_ | EntityError | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityList`_ | ListRelationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityMap`_ | EntityMap | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`entityMapLifetime`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`error`_ | EntityError | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`errors`_ | OperationResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`expandValues`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`expiresAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty, Subscription, | | -| | CSourceRegistration, SnapshotNotification, EntityMap, Entity, | | -| | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`features`_ | FeatureCollection | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`format`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`geoQ`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`geometry`_ | Feature, OrderingParams, GeoParams | Type-scoped within Feature, | -| | | Property-scoped definition within | -| | | _`geoQ`_, _`ordering`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`geoproperty`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`georel`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`idPattern `_ | EntitySelector, EntityInfo | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`information`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`instanceId`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`isActive`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`join `_ | Query, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`joinLevel`_ | Query, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`json `_ | JsonProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`jsonKeys`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`jsonldContext `_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`jsons`_ | JsonProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`key`_ | KeyValuePair | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lang`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`languageMap `_ | LanguageProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`languageMaps`_ | LanguageProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastFailure`_ | CSourceRegistration, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastN`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastNotification`_ | NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastSuccess`_ | CSourceRegistration, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`lastUsedAt`_ | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`linkedMaps`_ | EntityMap | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`localOnly`_ | Query, RegistrationMangementInfo, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`location`_ | Entity, CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`management`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`managementInterval`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`mode`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`modifiedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty, Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`ngsildproof `_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty | | -| | | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`ngsildConformance`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notification`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notificationTrigger`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notifiedAt`_ | CSourceNotification, Notification, SnapshotNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notifierInfo`_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`notUpdated`_ | UpdateResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`object`_ | Relationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`objectList`_ | ListRelationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`objectLists`_ | ListRelationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`objects`_ | Relationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`objectType`_ | Relationship, ListRelationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`observationInterval`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`observationSpace`_ | CSourceRegistration, Entity | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`observedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | -| | LanguageProperty, JsonProperty, VocabProperty | | -| | | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`omit`_ | Query, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`operations`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`operationSpace`_ | CSourceRegistration, Entity | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`orderBy`_ | OrderingParams | Property-scoped definition within | -| | | _`ordering`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`ordering`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`pick`_ | Query, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousJson`_ | JsonProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousLanguageMap`_ | LanguageProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousObject`_ | Relationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousObjectList`_ | ListRelationship | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousValue`_ | Property, GeoProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousValueList`_ | ListProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`previousVocab`_ | VocabProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`problemDetails`_ | ExecutionResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`properties`_ | Feature | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`propertyNames`_ | RegistrationInfo | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`q`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`reason`_ | NotUpdatedResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`receiverInfo`_ | Endpoint, Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`refreshRate`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`registrationId`_ | NotUpdatedResult, EntityError | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`registrationName`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`relationshipNames`_ | RegistrationInfo | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`resultStatus`_ | ExecutionResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`scope`_ | CSourceRegistration, Entity | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`scopeQ`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`showChanges`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotId`_ | SnapshotNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotLifetime`_ | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotPriority`_ | SnapshotNotification, Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotQueries`_ | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotQueriesDetails`_ | Snapshot, SnapshotNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotStatus`_ | Snapshot, SnapshotNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotTemporalQueries`_ | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`snapshotTemporalQueriesDetails`_ | Snapshot | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`splitEntities`_ | Query | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`startAt`_ | TimeIntervalParams | Property-scoped definition within | -| | | _`managementInterval`_, | -| | | _`observationInterval`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`status`_ | CSourceRegistration, NotificationParams, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`subscriptionId`_ | CSourceNotification, Notification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`subscriptionName`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`success`_ | OperationResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`sysAttrs`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`temporalQ`_ | Query, Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`temporalSnapshotQueriesDetails`_ | SnapshotNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`tenant`_ | CSourceRegistration | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`throttling`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeAt`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeInterval`_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeout `_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | -| | | _`managementInterval`_, | -| | | _`observationInterval`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timeproperty`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timerel`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timesFailed`_ | CSourceRegistration, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`timesSent`_ | CSourceRegistration, NotificationParams | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`triggerReason`_ | CSourceNotification | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeList`_ | EntityTypeList | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeName`_ | EntityType, EntityTypeInfo | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`typeNames `_ | Attribute | Type-scoped definition | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`unitCode`_ | Property, ListProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`updated`_ | UpdateResult | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`uri `_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`value`_ | Property, GeoProperty, KeyValuePair | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`valueList`_ | ListProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`valueLists `_ | ListProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`values`_ | Property, ListProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`valueType`_ | Property, GeoProperty, ListProperty, | | -| | LanguageProperty, JsonProperty, VocabProperty | | -| | | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`vocab`_ | VocabProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`vocabs`_ | VocabProperty | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ -| _`watchedAttributes `_ | Subscription | | -+------------------------------------+-----------------------------------------------------------------------+-------------------------------------------+ ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| Name | Data Type using the attribute | Core _`@context`_ Definition | ++====================================+=======================================================================+===============================================+ +| _`accept`_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`aggrParams`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped definition within | +| | | _`aggrParams`_ and | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped definition within | +| | | _`aggrParams`_ and | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributeCount`_ | Attribute | Type-scoped definition within | +| | | [type="Attribute"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributeDetails`_ | EntityTypeInfo | Type-scoped definition within | +| | | [type="EntityTypeInfo"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributeList `_ | AttributeList | Type-scoped definition within | +| | | [type="AttributeList"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributeName`_ | Attribute, NotUpdatedResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributeTypes`_ | Attribute | Type-scoped definition within | +| | | [type="Attribute"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attributes`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`attrs`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped definition within | +| | | _`management`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`collation`_ | OrderingParams | Property-scoped definition within | +| | | _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`containedBy `_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`contextSourceAlias `_ | ContextSourceIdentity, CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`contextSourceExtras`_ | ContextSourceIdentity | Type-scoped definition within | +| | | [type="ContextSourceIdentity"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`contextSourceInfo`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`contextSourceTimeAt`_ | ContextSourceIdentity | Type-scoped definition within | +| | | [type="ContextSourceIdentity"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`contextSourceUptime`_ | ContextSourceIdentity | Type-scoped definition within | +| | | [type="ContextSourceIdentity"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | +| | | _`management`_ and | +| | | _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`coordinates`_ | GeoParams, OrderingParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`createdAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`createEntityMap`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`csf`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`data `_ | CSourceNotification, Notification | Type-scoped definition within | +| | | [type="CSourceNotification"]{.HTML-Code} | +| | | and | +| | | [type="Notification"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`datasetId `_ | Property, Relationship, GeoProperty, ListProperty, | | +| | ListRelationship, LanguageProperty, JsonProperty, | | +| | VocabProperty, Subscription, CSourceRegistration, Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`deletedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Subscription | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`description`_ | CSourceRegistration, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`endAt`_ | TimeIntervalParams | Property-scoped definition within | +| | | _`managementInterval`_ and | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`endTimeAt`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`endpoint`_ | CSourceRegistration, Snapshot, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entities`_ | Query, RegistrationInfo, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entity`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entityCount`_ | EntityTypeInfo | Type-scoped definition within | +| | | [type="EntityTypeInfo"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entityId`_ | EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entityList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entityMap`_ | EntityMap | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`entityMapLifetime`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`error`_ | EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`errors`_ | OperationResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`expandValues`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`expiresAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Subscription, | | +| | CSourceRegistration, SnapshotNotification, EntityMap, Entity, | | +| | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`features`_ | FeatureCollection | Type-scoped definition within | +| | | [type="FeatureCollection"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`format`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`geoQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`geometry`_ | Feature, OrderingParams, GeoParams | Type-scoped within | +| | | [type="Feature"]{.HTML-Code}, property-scoped | +| | | definition within _`geoQ`_, _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`geoproperty`_ | GeoParams | Property-scoped definition within | +| | | _`geoRel`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`georel`_ | GeoParams | Property-scoped definition within | +| | | _`geoRel`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`idPattern `_ | EntitySelector, EntityInfo | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`information`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`instanceId`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`isActive`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`join `_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`joinLevel`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`json `_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`jsonKeys`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`jsonldContext `_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`jsons`_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`key`_ | KeyValuePair | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lang`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`languageMap `_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`languageMaps`_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lastFailure`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lastN`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lastNotification`_ | NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lastSuccess`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`lastUsedAt`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`linkedMaps`_ | EntityMap | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`localOnly`_ | Query, RegistrationMangementInfo, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`location`_ | Entity, CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`management`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`managementInterval`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`mode`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`modifiedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`ngsildproof `_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`ngsildConformance`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`notification`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`notificationTrigger`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`notifiedAt`_ | CSourceNotification, Notification, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`notifierInfo`_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`notUpdated`_ | UpdateResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`object`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`objectList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`objectLists`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`objects`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`objectType`_ | Relationship, ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`observationInterval`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`observationSpace`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`observedAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`omit`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`operations`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`operationSpace`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`orderBy`_ | OrderingParams | Property-scoped definition within | +| | | _`ordering`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`ordering`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`pick`_ | Query, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousJson`_ | JsonProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousLanguageMap`_ | LanguageProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousObject`_ | Relationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousObjectList`_ | ListRelationship | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousValue`_ | Property, GeoProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousValueList`_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`previousVocab`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`problemDetails`_ | ExecutionResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`properties`_ | Feature | Type-scoped definition within | +| | | [type="Feature"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`propertyNames`_ | RegistrationInfo | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`q`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`reason`_ | NotUpdatedResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`receiverInfo`_ | Endpoint, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`refreshRate`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`registrationId`_ | NotUpdatedResult, EntityError | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`registrationName`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`relationshipNames`_ | RegistrationInfo | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`resultStatus`_ | ExecutionResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`scope`_ | CSourceRegistration, Entity | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`scopeQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`showChanges`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotId`_ | SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotLifetime`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotPriority`_ | SnapshotNotification, Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotQueries`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotQueriesDetails`_ | Snapshot, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotStatus`_ | Snapshot, SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotTemporalQueries`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`snapshotTemporalQueriesDetails`_ | Snapshot | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`splitEntities`_ | Query | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`startAt`_ | TimeIntervalParams | Property-scoped definition within | +| | | _`managementInterval`_ and | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`status`_ | CSourceRegistration, NotificationParams, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`subscriptionId`_ | CSourceNotification, Notification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`subscriptionName`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`success`_ | OperationResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`sysAttrs`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`temporalQ`_ | Query, Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`temporalSnapshotQueriesDetails`_ | SnapshotNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`tenant`_ | CSourceRegistration | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`throttling`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timeAt`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timeInterval`_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timeout `_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | +| | | _`managementInterval`_ and | +| | | _`observationInterval`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timeproperty`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timerel`_ | TemporalParams | Property-scoped definition within | +| | | _`temporalQ`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timesFailed`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`timesSent`_ | CSourceRegistration, NotificationParams | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`triggerReason`_ | CSourceNotification | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`typeList`_ | EntityTypeList | Type-scoped definition within | +| | | [type="EntityTypeList"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`typeName`_ | EntityType, EntityTypeInfo | Type-scoped definition within | +| | | [type="EntityType"]{.HTML-Code} and | +| | | [type="EntityTypeInfo"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`typeNames `_ | Attribute | Type-scoped definition within | +| | | [type="Attribute"]{.HTML-Code} | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`unitCode`_ | Property, ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`updated`_ | UpdateResult | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`uri `_ | Endpoint | Property-scoped definition within | +| | | _`endpoint`_ | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`value`_ | Property, GeoProperty, KeyValuePair | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`valueList`_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`valueLists `_ | ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`values`_ | Property, ListProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`valueType`_ | Property, GeoProperty, ListProperty, | | +| | LanguageProperty, JsonProperty, VocabProperty | | +| | | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`vocab`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`vocabs`_ | VocabProperty | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ +| _`watchedAttributes `_ | Subscription | | ++------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ ::: -- GitLab From c05662010279f6091c5d9937afda296b96d39996 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Wed, 3 Dec 2025 11:01:33 +0100 Subject: [PATCH 08/19] List exisiting terms from the core context. --- md/clause-5.md | 37 +++++++++++++++++++++++++++++++++---- 1 file changed, 33 insertions(+), 4 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 398ce39..f6a9fe6 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -199,6 +199,36 @@ Entity Type is to delete the Entity and re-create it with the same _`id`_. Alternatively, a batch upsert with ["replace"]{.HTML-Code} update mode can be used, as described in Clause+++clause-10+++10.3.3. +The following names should be avoided when defining Entity Types, as definitions +already exist within the Core _`@context`_, and are used for the operations of +NGSI-LD API itself: + +- ["Attribute"]{.HTML-Code}, ["AttributeList"]{.HTML-Code} , + ["ContextSourceIdentity"]{.HTML-Code} , + ["ContextSourceNotification"]{.HTML-Code}, + ["ContextSourceRegistration"]{.HTML-Code}, ["EntityTypeInfo"]{.HTML-Code} , + ["EntityTypeList"]{.HTML-Code}, ["ExecutionResultDetails"]{.HTML-Code}, + ["GeoProperty"]{.HTML-Code} , ["JsonProperty"]{.HTML-Code}, + ["LanguageProperty"]{.HTML-Code}, ["ListProperty"]{.HTML-Code} , + ["ListRelationship"]{.HTML-Code}, ["Notification"]{.HTML-Code}, + ["Property"]{.HTML-Code} , ["Relationship"]{.HTML-Code}, + ["Snapshot"]{.HTML-Code}, ["SnapshotNotification"]{.HTML-Code} , + ["Subscription"]{.HTML-Code}, ["TemporalProperty"]{.HTML-Code}, + ["VocabProperty"]{.HTML-Code} + +The following names are defined in in the Core _`@context`_ using their standard +GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: + +- ["Feature"]{.HTML-Code}, ["FeatureCollection"]{.HTML-Code}, + ["GeometryCollection"]{.HTML-Code} , ["LineString"]{.HTML-Code}, + ["MultiLineString"]{.HTML-Code}, ["MultiPoint"]{.HTML-Code} , + ["MultiPolygon"]{.HTML-Code}, ["Point"]{.HTML-Code}, ["Polygon"]{.HTML-Code} + +The following names are defined in in the Core _`@context`_ and are reserved for +temporal definitions: + +- ["Date"]{.HTML-Code}, ["DateTime"]{.HTML-Code}, ["Time"]{.HTML-Code} + ### 5.2.4 Simple Attributes / temporal Attributes NGSI-LD defines the following Properties of type _TemporalProperty_ that shall @@ -369,7 +399,7 @@ Table: Matrix of all Attributes | | | _`management`_ and | | | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`coordinates`_ | GeoParams, OrderingParams | | +| _`coordinates`_ | GeoParams, OrderingParams, GeoProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`createdAt`_ | Property, Relationship, GeoProperty, ListProperty, ListRelationship, | | | | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | | @@ -704,9 +734,8 @@ Core _`@context`_: - ["avg"]{.HTML-Code}, ["distinctCount"]{.HTML-Code}, ["max"]{.HTML-Code}, ["min"]{.HTML-Code}, ["stddev"]{.HTML-Code}, ["sum"]{.HTML-Code}, - ["sumsq"]{.HTML-Code}, ["totalCount"]{.HTML-Code} are Property-scoped and - used by the Aggregated temporal representation of an Entity. See Clause - 5.3.2.7 + ["sumsq"]{.HTML-Code}, ["totalCount"]{.HTML-Code} are Property-scoped and used + by the Aggregated temporal representation of an Entity. See Clause 5.3.2.7 - ["bbox"]{.HTML-Code}, ["properties"]{.HTML-Code}, ["coordinates"]{.HTML-Code} are used in geographic operations and retain their standard GeoJSON-LD -- GitLab From afb6f83e6c07aeeace2eb7efc839ac97fb47679f Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Wed, 3 Dec 2025 11:11:01 +0100 Subject: [PATCH 09/19] Clarify text. --- md/clause-5.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index f6a9fe6..e56189c 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -199,9 +199,9 @@ Entity Type is to delete the Entity and re-create it with the same _`id`_. Alternatively, a batch upsert with ["replace"]{.HTML-Code} update mode can be used, as described in Clause+++clause-10+++10.3.3. -The following names should be avoided when defining Entity Types, as definitions -already exist within the Core _`@context`_, and are used for the operations of -NGSI-LD API itself: +The following names shall be avoided when defining Entity Types, as definitions +already exist within the core _`@context`_, and are reserved for use as data +types within the NGSI-LD Core API itself: - ["Attribute"]{.HTML-Code}, ["AttributeList"]{.HTML-Code} , ["ContextSourceIdentity"]{.HTML-Code} , @@ -216,7 +216,7 @@ NGSI-LD API itself: ["Subscription"]{.HTML-Code}, ["TemporalProperty"]{.HTML-Code}, ["VocabProperty"]{.HTML-Code} -The following names are defined in in the Core _`@context`_ using their standard +The following names are defined in the core _`@context`_ using their standard GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: - ["Feature"]{.HTML-Code}, ["FeatureCollection"]{.HTML-Code}, @@ -224,7 +224,7 @@ GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: ["MultiLineString"]{.HTML-Code}, ["MultiPoint"]{.HTML-Code} , ["MultiPolygon"]{.HTML-Code}, ["Point"]{.HTML-Code}, ["Polygon"]{.HTML-Code} -The following names are defined in in the Core _`@context`_ and are reserved for +The following names are defined in the Core _`@context`_ and are reserved for temporal definitions: - ["Date"]{.HTML-Code}, ["DateTime"]{.HTML-Code}, ["Time"]{.HTML-Code} -- GitLab From c4fb532db5bc867798dc7edc36f00269b0dabc4b Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Fri, 5 Dec 2025 10:23:52 +0100 Subject: [PATCH 10/19] Add scope to `notUpdated` --- md/annex-b.md | 12 ++++++++++-- md/clause-5.md | 12 ++++++++---- 2 files changed, 18 insertions(+), 6 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index ce3d1ab..6a6f431 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -368,7 +368,16 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:notifiedAt", "@type": "DateTime" }, - "notUpdated": "ngsi-ld:notUpdated", + "notUpdated": { + "@id":"ngsi-ld:notUpdated", + "@context": { + "attributeName": { + "@id": "ngsi-ld:attributeName", + "@type": "@vocab" + }, + "reason": "ngsi-ld:reason" + } + }, "object": { "@id": "ngsi-ld:hasObject", "@type": "@id" @@ -480,7 +489,6 @@ Such definition has been tested using [i.19]. "@type": "@vocab" }, "q": "ngsi-ld:q", - "reason": "ngsi-ld:reason", "refreshRate": "ngsi-ld:refreshRate", "registrationId": "ngsi-ld:registrationId", "registrationName": "ngsi-ld:registrationName", diff --git a/md/clause-5.md b/md/clause-5.md index e56189c..a94d942 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -364,7 +364,10 @@ Table: Matrix of all Attributes | _`attributeList `_ | AttributeList | Type-scoped definition within | | | | [type="AttributeList"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`attributeName`_ | Attribute, NotUpdatedResult | | +| _`attributeName`_ | Attribute, NotUpdatedResult | Type-scoped definition within | +| | | [type="Attribute"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notUpdated`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`attributeTypes`_ | Attribute | Type-scoped definition within | | | | [type="Attribute"]{.HTML-Code} | @@ -603,7 +606,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`q`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`reason`_ | NotUpdatedResult | | +| _`reason`_ | NotUpdatedResult | Property-scoped definition within | +| | | _`notUpdated`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`receiverInfo`_ | Endpoint, Snapshot | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -709,7 +713,7 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`valueLists `_ | ListProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`values`_ | Property, ListProperty | | +| _`values`_ | Property, GeoProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`valueType`_ | Property, GeoProperty, ListProperty, | | | | LanguageProperty, JsonProperty, VocabProperty | | @@ -3302,7 +3306,7 @@ Table: UpdateResult data type definition +-------------+-----------------------+----------------------------+-------------+---------------------------------------------------------------------------------------------------------------------------------------+ | Name | Data Type | Restrictions | Cardinality | Description | +=============+=======================+============================+=============+=======================================================================================================================================+ -| notUpdated | NotUpdatedDetails[] | See Clause+++root.2.6.8.4 | 1 | List which contains the Attributes (represented by their name) that were not updated, together with the reason for not being updated. | +| notUpdated | NotUpdatedResult[] | See Clause+++root.2.6.8.4 | 1 | List which contains the Attributes (represented by their name) that were not updated, together with the reason for not being updated. | +-------------+-----------------------+----------------------------+-------------+---------------------------------------------------------------------------------------------------------------------------------------+ | updated | String[] | | 1 | List of Attributes (represented by their name) that were appended or updated. | +-------------+-----------------------+----------------------------+-------------+---------------------------------------------------------------------------------------------------------------------------------------+ -- GitLab From eab578d0b94998997512fb8bb2b3459561066797 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Fri, 5 Dec 2025 13:28:27 +0100 Subject: [PATCH 11/19] Add type-scoping to Query attributes. --- md/annex-b.md | 78 +++++++++++++++++++++++++++++---------------------- 1 file changed, 44 insertions(+), 34 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index 6a6f431..ba3d4b4 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -153,6 +153,42 @@ Such definition has been tested using [i.19]. "Point": "geojson:Point", "Polygon": "geojson:Polygon", "Property": "ngsi-ld:Property", + "Query": { + "@id": "ngsi-ld:Query", + "@context": { + "aggrParams": { + "@id": "ngsi-ld:aggrParams", + "@context": { + "aggrMethods": "ngsi-ld:aggrMethods", + "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration" + } + }, + "attrs": "ngsi-ld:attrs", + "containedBy": "ngsi-ld:isContainedBy", + "createEntityMap": "ngsi-ld:createEntityMap", + "entityMapLifetime": "ngsi-ld:hasEntityMapLifetime", + "join": "ngsi-ld:join", + "joinLevel": "ngsi-ld:hasJoinLevel", + "omit": "ngsi-ld:omit", + "pick": "ngsi-ld:pick", + "ordering": { + "@id": "ngsi-ld:ordering", + "@context": { + "collation": "ngsi-ld:collation", + "coordinates": { + "@container": "@list", + "@id": "geojson:coordinates" + }, + "geometry": "geojson:geometry", + "orderBy": { + "@container": "@list", + "@id": "ngsi-ld:orderBy" + } + } + }, + "splitEntities": "ngsi-ld:hasSplitEntities" + } + }, "Relationship": "ngsi-ld:Relationship", "Snapshot": "ngsi-ld:Snapshot", "SnapshotNotification": "ngsi-ld:SnapshotNotification", @@ -160,19 +196,10 @@ Such definition has been tested using [i.19]. "TemporalProperty": "ngsi-ld:TemporalProperty", "Time": "ngsi-ld:Time", "VocabProperty": "ngsi-ld:VocabProperty", - "aggrParams": { - "@id": "ngsi-ld:aggrParams", - "@context": { - "aggrMethods": "ngsi-ld:aggrMethods", - "aggrPeriodDuration": "ngsi-ld:aggrPeriodDuration" - } - }, - "attrs": "ngsi-ld:attrs", "bbox": { "@container": "@list", "@id": "geojson:bbox" }, - "containedBy": "ngsi-ld:isContainedBy", "contextSourceAlias": "ngsi-ld:contextSourceAlias", "coordinates": { "@container": "@list", @@ -222,7 +249,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:hasEntityMap", "@container": "@index" }, - "entityMapLifetime": "ngsi-ld:hasEntityMapLifetime", "error": "ngsi-ld:error", "errors": "ngsi-ld:errors", "expandValues": "ngsi-ld:expandValues", @@ -249,8 +275,6 @@ Such definition has been tested using [i.19]. "@type": "@id" }, "isActive": "ngsi-ld:isActive", - "join": "ngsi-ld:join", - "joinLevel": "ngsi-ld:hasJoinLevel", "json": { "@id": "ngsi-ld:hasJSON", "@type": "@json" @@ -359,6 +383,10 @@ Such definition has been tested using [i.19]. "@type": "@vocab" }, "format": "ngsi-ld:format", + "join": "ngsi-ld:join", + "joinLevel": "ngsi-ld:hasJoinLevel", + "omit": "ngsi-ld:omit", + "pick": "ngsi-ld:pick", "showChanges": "ngsi-ld:showChanges", "sysAttrs": "ngsi-ld:sysAttrs" } @@ -436,25 +464,8 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:observedAt", "@type": "DateTime" }, - "omit": "ngsi-ld:omit", "operations": "ngsi-ld:operations", "operationSpace": "ngsi-ld:operationSpace", - "ordering": { - "@id": "ngsi-ld:ordering", - "@context": { - "collation": "ngsi-ld:collation", - "coordinates": { - "@container": "@list", - "@id": "geojson:coordinates" - }, - "geometry": "geojson:geometry", - "orderBy": { - "@container": "@list", - "@id": "ngsi-ld:orderBy" - } - } - }, - "pick": "ngsi-ld:pick", "previousJson": { "@id": "ngsi-ld:hasPreviousJson", "@type": "@json" @@ -519,12 +530,7 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:snapshotTemporalQueriesDetails", "@container": "@list" }, - "splitEntities": "ngsi-ld:hasSplitEntities", "status": "ngsi-ld:status", - "stddev": { - "@id": "ngsi-ld:stddev", - "@container": "@list" - }, "subscriptionName": "ngsi-ld:subscriptionName", "success": { "@id": "ngsi-ld:success", @@ -599,6 +605,10 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:min", "@container": "@list" }, + "stddev": { + "@id": "ngsi-ld:stddev", + "@container": "@list" + }, "sum": { "@id": "ngsi-ld:sum", "@container": "@list" -- GitLab From 85308deb4b66c397351c027ffcc3b6366dc1c706 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Fri, 5 Dec 2025 13:50:12 +0100 Subject: [PATCH 12/19] Update scoped definitions. --- md/clause-5.md | 51 ++++++++++++++++++++++++++++++++++---------------- 1 file changed, 35 insertions(+), 16 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index a94d942..c5c295d 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -210,11 +210,11 @@ types within the NGSI-LD Core API itself: ["EntityTypeList"]{.HTML-Code}, ["ExecutionResultDetails"]{.HTML-Code}, ["GeoProperty"]{.HTML-Code} , ["JsonProperty"]{.HTML-Code}, ["LanguageProperty"]{.HTML-Code}, ["ListProperty"]{.HTML-Code} , - ["ListRelationship"]{.HTML-Code}, ["Notification"]{.HTML-Code}, - ["Property"]{.HTML-Code} , ["Relationship"]{.HTML-Code}, - ["Snapshot"]{.HTML-Code}, ["SnapshotNotification"]{.HTML-Code} , - ["Subscription"]{.HTML-Code}, ["TemporalProperty"]{.HTML-Code}, - ["VocabProperty"]{.HTML-Code} + ["ListRelationship"]{.HTML-Code}, ["Query"]{.HTML-Code}, + ["Notification"]{.HTML-Code}, ["Property"]{.HTML-Code}, + ["Relationship"]{.HTML-Code}, ["Snapshot"]{.HTML-Code}, + ["SnapshotNotification"]{.HTML-Code} , ["Subscription"]{.HTML-Code}, + ["TemporalProperty"]{.HTML-Code}, ["VocabProperty"]{.HTML-Code} The following names are defined in the core _`@context`_ using their standard GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: @@ -345,7 +345,8 @@ Table: Matrix of all Attributes | _`accept`_ | Endpoint | Property-scoped definition within | | | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`aggrParams`_ | Query | | +| _`aggrParams`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped definition within | | | | _`aggrParams`_ and | @@ -375,7 +376,8 @@ Table: Matrix of all Attributes | _`attributes`_ | NotificationParams | Property-scoped definition within | | | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`attrs`_ | Query | | +| _`attrs`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped definition within | | | | _`management`_ | @@ -383,7 +385,8 @@ Table: Matrix of all Attributes | _`collation`_ | OrderingParams | Property-scoped definition within | | | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`containedBy `_ | Query | | +| _`containedBy `_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`contextSourceAlias `_ | ContextSourceIdentity, CSourceRegistration | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -408,7 +411,8 @@ Table: Matrix of all Attributes | | LanguageProperty, JsonProperty, VocabProperty, Entity, Snapshot | | | | | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`createEntityMap`_ | Query | | +| _`createEntityMap`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`csf`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -449,7 +453,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`entityMap`_ | EntityMap | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`entityMapLifetime`_ | Query | | +| _`entityMapLifetime`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`error`_ | EntityError | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -489,9 +494,15 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`isActive`_ | Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`join `_ | Query, NotificationParams | | +| _`join `_ | Query, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`joinLevel`_ | Query, NotificationParams | | +| _`joinLevel`_ | Query, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`json `_ | JsonProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -570,7 +581,10 @@ Table: Matrix of all Attributes | | LanguageProperty, JsonProperty, VocabProperty | | | | | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`omit`_ | Query, NotificationParams | | +| _`omit`_ | Query, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`operations`_ | CSourceRegistration | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -579,9 +593,13 @@ Table: Matrix of all Attributes | _`orderBy`_ | OrderingParams | Property-scoped definition within | | | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`ordering`_ | Query | | +| _`ordering`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`pick`_ | Query, NotificationParams | | +| _`pick`_ | Query, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`previousJson`_ | JsonProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -644,7 +662,8 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`snapshotTemporalQueriesDetails`_ | Snapshot | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`splitEntities`_ | Query | | +| _`splitEntities`_ | Query | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`startAt`_ | TimeIntervalParams | Property-scoped definition within | | | | _`managementInterval`_ and | -- GitLab From 377c218a93e3879628537dd849fe7c872d3f2ad4 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 8 Dec 2025 10:14:50 +0000 Subject: [PATCH 13/19] Remove spacing. --- md/clause-5.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/md/clause-5.md b/md/clause-5.md index c5c295d..5c32a47 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -220,7 +220,7 @@ The following names are defined in the core _`@context`_ using their standard GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: - ["Feature"]{.HTML-Code}, ["FeatureCollection"]{.HTML-Code}, - ["GeometryCollection"]{.HTML-Code} , ["LineString"]{.HTML-Code}, + ["GeometryCollection"]{.HTML-Code}, ["LineString"]{.HTML-Code}, ["MultiLineString"]{.HTML-Code}, ["MultiPoint"]{.HTML-Code} , ["MultiPolygon"]{.HTML-Code}, ["Point"]{.HTML-Code}, ["Polygon"]{.HTML-Code} -- GitLab From ec88ecf2b1624336635af81f6c7defe022c4f581 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 8 Dec 2025 14:23:25 +0000 Subject: [PATCH 14/19] Add type-scoping to read-only attributes. --- md/annex-b.md | 58 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 39 insertions(+), 19 deletions(-) diff --git a/md/annex-b.md b/md/annex-b.md index ba3d4b4..8341c31 100644 --- a/md/annex-b.md +++ b/md/annex-b.md @@ -72,7 +72,22 @@ Such definition has been tested using [i.19]. "triggerReason": "ngsi-ld:triggerReason" } }, - "ContextSourceRegistration": "ngsi-ld:ContextSourceRegistration", + "ContextSourceRegistration": { + "@id": "ngsi-ld:ContextSourceRegistration", + "@context": { + "lastFailure": { + "@id": "ngsi-ld:lastFailure", + "@type": "DateTime" + }, + "lastSuccess": { + "@id": "ngsi-ld:lastSuccess", + "@type": "DateTime" + }, + "status": "ngsi-ld:status", + "timesFailed": "ngsi-ld:timesFailed", + "timesSent": "ngsi-ld:timesSent" + } + }, "Date": "ngsi-ld:Date", "DateTime": "ngsi-ld:DateTime", "EntityMap": "ngsi-ld:EntityMap", @@ -192,7 +207,12 @@ Such definition has been tested using [i.19]. "Relationship": "ngsi-ld:Relationship", "Snapshot": "ngsi-ld:Snapshot", "SnapshotNotification": "ngsi-ld:SnapshotNotification", - "Subscription": "ngsi-ld:Subscription", + "Subscription": { + "@id": "ngsi-ld:Subscription", + "@context": { + "status": "ngsi-ld:status" + } + }, "TemporalProperty": "ngsi-ld:TemporalProperty", "Time": "ngsi-ld:Time", "VocabProperty": "ngsi-ld:VocabProperty", @@ -316,18 +336,6 @@ Such definition has been tested using [i.19]. } }, "langString": "http://www.w3.org/1999/02/22-rdf-syntax-ns#langString", - "lastFailure": { - "@id": "ngsi-ld:lastFailure", - "@type": "DateTime" - }, - "lastNotification": { - "@id": "ngsi-ld:lastNotification", - "@type": "DateTime" - }, - "lastSuccess": { - "@id": "ngsi-ld:lastSuccess", - "@type": "DateTime" - }, "lastUsedAt": { "@id": "ngsi-ld:lastUsedAt", "@type": "DateTime" @@ -385,10 +393,25 @@ Such definition has been tested using [i.19]. "format": "ngsi-ld:format", "join": "ngsi-ld:join", "joinLevel": "ngsi-ld:hasJoinLevel", + "lastFailure": { + "@id": "ngsi-ld:lastFailure", + "@type": "DateTime" + }, + "lastNotification": { + "@id": "ngsi-ld:lastNotification", + "@type": "DateTime" + }, + "lastSuccess": { + "@id": "ngsi-ld:lastSuccess", + "@type": "DateTime" + }, "omit": "ngsi-ld:omit", "pick": "ngsi-ld:pick", "showChanges": "ngsi-ld:showChanges", - "sysAttrs": "ngsi-ld:sysAttrs" + "status": "ngsi-ld:status", + "sysAttrs": "ngsi-ld:sysAttrs", + "timesFailed": "ngsi-ld:timesFailed", + "timesSent": "ngsi-ld:timesSent" } }, "notificationTrigger": "ngsi-ld:notificationTrigger", @@ -397,7 +420,7 @@ Such definition has been tested using [i.19]. "@type": "DateTime" }, "notUpdated": { - "@id":"ngsi-ld:notUpdated", + "@id": "ngsi-ld:notUpdated", "@context": { "attributeName": { "@id": "ngsi-ld:attributeName", @@ -530,7 +553,6 @@ Such definition has been tested using [i.19]. "@id": "ngsi-ld:snapshotTemporalQueriesDetails", "@container": "@list" }, - "status": "ngsi-ld:status", "subscriptionName": "ngsi-ld:subscriptionName", "success": { "@id": "ngsi-ld:success", @@ -560,8 +582,6 @@ Such definition has been tested using [i.19]. }, "throttling": "ngsi-ld:throttling", "timeInterval": "ngsi-ld:timeInterval", - "timesFailed": "ngsi-ld:timesFailed", - "timesSent": "ngsi-ld:timesSent", "title": "http://purl.org/dc/terms/title", "unchanged": "ngsi-ld:unchanged", "unitCode": "ngsi-ld:unitCode", -- GitLab From c1537d096069c0b926890e9bd137e1de6b16b646 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 8 Dec 2025 15:05:45 +0000 Subject: [PATCH 15/19] Update scoped definitions for read-only attributes. Fix whitespace issues. --- md/clause-5.md | 80 +++++++++++++++++++++++++++++++------------------- 1 file changed, 49 insertions(+), 31 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 5c32a47..5e706aa 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -343,17 +343,17 @@ Table: Matrix of all Attributes | Name | Data Type using the attribute | Core _`@context`_ Definition | +====================================+=======================================================================+===============================================+ | _`accept`_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`aggrParams`_ | Query | Type-scoped definition within | | | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`aggrMethods`_ | AggregationParams, TemporalParams | Property-scoped definition within | -| | | _`aggrParams`_ and | +| | | _`aggrParams`_ and | | | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`aggrPeriodDuration`_ | AggregationParams, TemporalParams | Property-scoped definition within | -| | | _`aggrParams`_ and | +| | | _`aggrParams`_ and | | | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`attributeCount`_ | Attribute | Type-scoped definition within | @@ -374,16 +374,16 @@ Table: Matrix of all Attributes | | | [type="Attribute"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`attributes`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`attrs`_ | Query | Type-scoped definition within | | | | [type="Query"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`cacheDuration`_ | RegistrationManagementInfo | Property-scoped definition within | -| | | _`management`_ | +| | | _`management`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`collation`_ | OrderingParams | Property-scoped definition within | -| | | _`ordering`_ | +| | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`containedBy `_ | Query | Type-scoped definition within | | | | [type="Query"]{.HTML-Code} | @@ -402,7 +402,7 @@ Table: Matrix of all Attributes | | | [type="ContextSourceIdentity"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`cooldown`_ | Endpoint, RegistrationManagementInfo | Property-scoped definition within | -| | | _`management`_ and | +| | | _`management`_ and | | | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`coordinates`_ | GeoParams, OrderingParams, GeoProperty | | @@ -436,7 +436,7 @@ Table: Matrix of all Attributes | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`endTimeAt`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`endpoint`_ | CSourceRegistration, Snapshot, NotificationParams | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -471,7 +471,7 @@ Table: Matrix of all Attributes | | | [type="FeatureCollection"]{.HTML-Code} | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`format`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`geoQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -480,10 +480,10 @@ Table: Matrix of all Attributes | | | definition within _`geoQ`_, _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`geoproperty`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | +| | | _`geoRel`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`georel`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | +| | | _`geoRel`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`idPattern `_ | EntitySelector, EntityInfo | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -497,12 +497,12 @@ Table: Matrix of all Attributes | _`join `_ | Query, NotificationParams | Type-scoped definition within | | | | [type="Query"]{.HTML-Code}, | | | | property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`joinLevel`_ | Query, NotificationParams | Type-scoped definition within | | | | [type="Query"]{.HTML-Code}, | | | | property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`json `_ | JsonProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -520,14 +520,21 @@ Table: Matrix of all Attributes +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`languageMaps`_ | LanguageProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`lastFailure`_ | CSourceRegistration, NotificationParams | | +| _`lastFailure`_ | CSourceRegistration, NotificationParams | Type-scoped definition within | +| | | [type="ContextSourceRegistration"]{.HTML-Code}| +| | | , property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`lastN`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`lastNotification`_ | NotificationParams | | +| _`lastNotification`_ | NotificationParams | Property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`lastSuccess`_ | CSourceRegistration, NotificationParams | | +| _`lastSuccess`_ | CSourceRegistration, NotificationParams | Type-scoped definition within | +| | | [type="ContextSourceRegistration"]{.HTML-Code}| +| | | , property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`lastUsedAt`_ | Snapshot | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -559,7 +566,7 @@ Table: Matrix of all Attributes | _`notifiedAt`_ | CSourceNotification, Notification, SnapshotNotification | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`notifierInfo`_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`notUpdated`_ | UpdateResult | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -584,14 +591,14 @@ Table: Matrix of all Attributes | _`omit`_ | Query, NotificationParams | Type-scoped definition within | | | | [type="Query"]{.HTML-Code}, | | | | property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`operations`_ | CSourceRegistration | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`operationSpace`_ | CSourceRegistration, Entity | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`orderBy`_ | OrderingParams | Property-scoped definition within | -| | | _`ordering`_ | +| | | _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`ordering`_ | Query | Type-scoped definition within | | | | [type="Query"]{.HTML-Code} | @@ -599,7 +606,7 @@ Table: Matrix of all Attributes | _`pick`_ | Query, NotificationParams | Type-scoped definition within | | | | [type="Query"]{.HTML-Code}, | | | | property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`previousJson`_ | JsonProperty | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -625,7 +632,7 @@ Table: Matrix of all Attributes | _`q`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`reason`_ | NotUpdatedResult | Property-scoped definition within | -| | | _`notUpdated`_ | +| | | _`notUpdated`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`receiverInfo`_ | Endpoint, Snapshot | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -644,7 +651,7 @@ Table: Matrix of all Attributes | _`scopeQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`showChanges`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`snapshotId`_ | SnapshotNotification | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -669,7 +676,12 @@ Table: Matrix of all Attributes | | | _`managementInterval`_ and | | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`status`_ | CSourceRegistration, NotificationParams, Subscription | | +| _`status`_ | CSourceRegistration, NotificationParams, Subscription | Type-scoped definitions within | +| | | [type="ContextSourceRegistration"]{.HTML-Code}| +| | | and | +| | | [type="Subscription"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`subscriptionId`_ | CSourceNotification, Notification | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -678,7 +690,7 @@ Table: Matrix of all Attributes | _`success`_ | OperationResult | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`sysAttrs`_ | NotificationParams | Property-scoped definition within | -| | | _`notification`_ | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`temporalQ`_ | Query, Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -689,7 +701,7 @@ Table: Matrix of all Attributes | _`throttling`_ | Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`timeAt`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`timeInterval`_ | Subscription | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -698,14 +710,20 @@ Table: Matrix of all Attributes | | | _`observationInterval`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`timeproperty`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`timerel`_ | TemporalParams | Property-scoped definition within | -| | | _`temporalQ`_ | +| | | _`temporalQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`timesFailed`_ | CSourceRegistration, NotificationParams | | +| _`timesFailed`_ | CSourceRegistration, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -| _`timesSent`_ | CSourceRegistration, NotificationParams | | +| _`timesSent`_ | CSourceRegistration, NotificationParams | Type-scoped definition within | +| | | [type="Query"]{.HTML-Code}, | +| | | property-scoped definition within | +| | | _`notification`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`triggerReason`_ | CSourceNotification | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ @@ -724,7 +742,7 @@ Table: Matrix of all Attributes | _`updated`_ | UpdateResult | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`uri `_ | Endpoint | Property-scoped definition within | -| | | _`endpoint`_ | +| | | _`endpoint`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`value`_ | Property, GeoProperty, KeyValuePair | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -- GitLab From 9cdc0dc66ea5306d5955f0003d64187b5ce4300e Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 8 Dec 2025 15:17:57 +0000 Subject: [PATCH 16/19] Remove word break characters. --- md/clause-5.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 5e706aa..4bdf55a 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -2298,9 +2298,9 @@ Table: Subscription data type definition +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ | notification | NotificationParams | See data type definition in Clause+++root.2.6.7.3 | 1 | Notification details. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -| notificationTrigger | String[] | Valid notification triggers are ["entityCreated"]{.HTML-Code}, ["entityUpdated"]{.HTML-Code}, | 0..1 | The notification triggers listed indicate what kind of changes shall trigger a notification. | -| | | ["entityDeleted"]{.HTML-Code}, ["attributeCreated"]{.HTML-Code}, | | If not present, the default is the combination ["attributeCreated"]{.HTML-Code} | -| | | ["attributeUpdated"]{.HTML-Code}, ["attributeDeleted"]{.HTML-Code} | | and ["attributeUpdated"]{.HTML-Code}. ["entityUpdated"]{.HTML-Code} is equivalent to | +| notificationTrigger | String[] | Valid notification triggers are ["entityCreated"]{.HTML-Code}, ["entityUpdated"]{.HTML-Code}, | 0..1 | The notification triggers listed indicate what kind of changes shall trigger a notification. | +| | | ["entityDeleted"]{.HTML-Code}, ["attributeCreated"]{.HTML-Code}, | | If not present, the default is the combination ["attributeCreated"]{.HTML-Code} | +| | | ["attributeUpdated"]{.HTML-Code}, ["attributeDeleted"]{.HTML-Code} | | and ["attributeUpdated"]{.HTML-Code}. ["entityUpdated"]{.HTML-Code} is equivalent to | | | | | | the combination ["attributeCreated"]{.HTML-Code}, ["attributeUpdated"]{.HTML-Code} | | | | | | and ["attributeDeleted"]{.HTML-Code}. | +---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------+--------------+------------------------------------------------------------------------------------------------+ -- GitLab From 7ddfb241731b925368c611d06f95eaf571228cad Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Mon, 8 Dec 2025 21:49:50 +0000 Subject: [PATCH 17/19] Correct attribute name --- md/clause-5.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 4bdf55a..28638cf 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -480,10 +480,10 @@ Table: Matrix of all Attributes | | | definition within _`geoQ`_, _`ordering`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`geoproperty`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | +| | | _`geoQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`georel`_ | GeoParams | Property-scoped definition within | -| | | _`geoRel`_ | +| | | _`geoQ`_ | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ | _`idPattern `_ | EntitySelector, EntityInfo | | +------------------------------------+-----------------------------------------------------------------------+-----------------------------------------------+ -- GitLab From ba92c2a6c812ab1fe5da56a40c323804f2a0b7b1 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Tue, 9 Dec 2025 14:26:14 +0000 Subject: [PATCH 18/19] Switch to examples. Reference Annex B. Clarify Scoped attribute names --- md/clause-5.md | 85 ++++++++++++++++++++++++++++++++------------------ 1 file changed, 55 insertions(+), 30 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index 28638cf..da1aaab 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -199,35 +199,50 @@ Entity Type is to delete the Entity and re-create it with the same _`id`_. Alternatively, a batch upsert with ["replace"]{.HTML-Code} update mode can be used, as described in Clause+++clause-10+++10.3.3. -The following names shall be avoided when defining Entity Types, as definitions -already exist within the core _`@context`_, and are reserved for use as data -types within the NGSI-LD Core API itself: - -- ["Attribute"]{.HTML-Code}, ["AttributeList"]{.HTML-Code} , - ["ContextSourceIdentity"]{.HTML-Code} , - ["ContextSourceNotification"]{.HTML-Code}, - ["ContextSourceRegistration"]{.HTML-Code}, ["EntityTypeInfo"]{.HTML-Code} , - ["EntityTypeList"]{.HTML-Code}, ["ExecutionResultDetails"]{.HTML-Code}, - ["GeoProperty"]{.HTML-Code} , ["JsonProperty"]{.HTML-Code}, - ["LanguageProperty"]{.HTML-Code}, ["ListProperty"]{.HTML-Code} , - ["ListRelationship"]{.HTML-Code}, ["Query"]{.HTML-Code}, - ["Notification"]{.HTML-Code}, ["Property"]{.HTML-Code}, - ["Relationship"]{.HTML-Code}, ["Snapshot"]{.HTML-Code}, - ["SnapshotNotification"]{.HTML-Code} , ["Subscription"]{.HTML-Code}, - ["TemporalProperty"]{.HTML-Code}, ["VocabProperty"]{.HTML-Code} - -The following names are defined in the core _`@context`_ using their standard -GeoJSON-LD definitions [i.13], and reserved for use in geographic operations: - -- ["Feature"]{.HTML-Code}, ["FeatureCollection"]{.HTML-Code}, - ["GeometryCollection"]{.HTML-Code}, ["LineString"]{.HTML-Code}, - ["MultiLineString"]{.HTML-Code}, ["MultiPoint"]{.HTML-Code} , - ["MultiPolygon"]{.HTML-Code}, ["Point"]{.HTML-Code}, ["Polygon"]{.HTML-Code} +Users should name and define Entity types relevant to their own data model in a +user _`@context`_. These term definitions should **avoid the use** of the terms +already defined within the core _`@context`_, as such terms are reserved to be +used as data types within the NGSI-LD Core API itself, and therefore cannot be +redefined elsewhere. + + + +>>> [!tip] EXAMPLE 1: + +["Attribute"]{.HTML-Code} , ["Notification"]{.HTML-Code}, ["Query"]{.HTML-Code}, ["Relationship"]{.HTML-Code} + +>>> + + + +GeoJSON-LD type definitions [i.13] are also defined in the core _`@context`_ and +reserved for use in geographic operations: + + + +>>> [!tip] EXAMPLE 2: + +["Feature"]{.HTML-Code} , ["FeatureCollection"]{.HTML-Code}, ["Point"]{.HTML-Code}, ["Polygon"]{.HTML-Code} + +>>> + + The following names are defined in the Core _`@context`_ and are reserved for temporal definitions: -- ["Date"]{.HTML-Code}, ["DateTime"]{.HTML-Code}, ["Time"]{.HTML-Code} + + +>>> [!tip] EXAMPLE 3: + +["Date"]{.HTML-Code} , ["DateTime"]{.HTML-Code}, ["Time"]{.HTML-Code} + +>>> + + + +A full list of terms defined for use by the NGSI-LD API can be discovered through +reading the Core NGSI-LD _`@context`_ found in Annex B. ### 5.2.4 Simple Attributes / temporal Attributes @@ -326,11 +341,18 @@ to be a system attribute. ### 5.2.5 Matrix of all Attributes -Table+++below gives a list of all defined attribute names within NGSI-LD data -types. User-defined terms within the user _`@context`_ may reuse these terms -**as is**, but shall avoid amending the definition these attribute names, since -the Core _`@context`_ definition always has priority, and will override any -changes defined in the user _`@context`_. +Table+++below gives a list of all attribute names used within NGSI-LD data +types. The core _`@context`_ provides term definitions for all of these +attribute names. Where possible, users should avoid the repurposing of these +attribute names when creating their own user-defined term definitions in the +user _`@context`_. + +Unscoped term definitions for attribute names within the core _`@context`_, +**can never be overridden**, since the core _`@context`_ definition always has +priority over any user _`@context`_ definition. Core _`@context`_ definitions +for attribute names which are defined as Property-scoped or Type-scoped (as +described by the JSON-LD specification [n.8], section 1.4) may be overridden +where necessary, although this usage is still discouraged. @@ -789,6 +811,9 @@ Core _`@context`_: - ["langString"]{.HTML-Code} is defined to retain its standard RDF datatype [n.7]. +The full list of attribute names defined as terms can be discovered through reading +the Core NGSI-LD _`@context`_ found in Annex B. + ### 5.2.6 Data types #### 5.2.6.1 Introduction -- GitLab From 903f70b301025fc539164bc5356645e5f2232538 Mon Sep 17 00:00:00 2001 From: Jason Fox Date: Fri, 12 Dec 2025 09:32:32 +0000 Subject: [PATCH 19/19] Run prettier --- md/clause-5.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/md/clause-5.md b/md/clause-5.md index da1aaab..2b4ee3f 100644 --- a/md/clause-5.md +++ b/md/clause-5.md @@ -241,8 +241,8 @@ temporal definitions: -A full list of terms defined for use by the NGSI-LD API can be discovered through -reading the Core NGSI-LD _`@context`_ found in Annex B. +A full list of terms defined for use by the NGSI-LD API can be discovered +through reading the Core NGSI-LD _`@context`_ found in Annex B. ### 5.2.4 Simple Attributes / temporal Attributes @@ -811,8 +811,8 @@ Core _`@context`_: - ["langString"]{.HTML-Code} is defined to retain its standard RDF datatype [n.7]. -The full list of attribute names defined as terms can be discovered through reading -the Core NGSI-LD _`@context`_ found in Annex B. +The full list of attribute names defined as terms can be discovered through +reading the Core NGSI-LD _`@context`_ found in Annex B. ### 5.2.6 Data types -- GitLab