From 0520c2f606b2676422693e1f0215d3d458a44831 Mon Sep 17 00:00:00 2001 From: Jacoby Date: Thu, 12 Dec 2019 14:35:36 +0100 Subject: [PATCH] Addresses https://github.com/opengeospatial/sensorthings/issues/89, adding detailed explanation how updating navigation links works --- src/18-088/10_create_update_delete.adoc | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/src/18-088/10_create_update_delete.adoc b/src/18-088/10_create_update_delete.adoc index b754da5..5889e9d 100755 --- a/src/18-088/10_create_update_delete.adoc +++ b/src/18-088/10_create_update_delete.adoc @@ -318,7 +318,26 @@ Key and other non-updatable properties that are not tied to key properties of th The service ignores the entity id in the payload when applying the update. -The entity SHALL NOT contain related entities as inline content. It MAY contain binding information for navigation properties. For single-valued navigation properties this replaces the relationship. For collection-valued navigation properties this adds to the relationship. +The entity SHALL NOT contain related entities as inline content. It MAY contain binding information for navigation properties for single-valued navigation properties in the form of +[source] +---- +"[navigation property name]": +{ + "@iot.id": [ID of entity to link to] +} +---- +and for collection-value navigation properties in the form of +[source] +---- +"[navigation property name]": +[ + { + "@iot.id": [ID of entity to link to] + } +] +---- + +For single-valued navigation properties this replaces the relationship. For collection-valued navigation properties this adds to the relationship. Nested updates of navigation properties are not supported and SHALL result in a 400 Bad Request error. On success, the response SHALL be a valid success response.