diff --git a/docs/odata-protocol/odata-protocol.html b/docs/odata-protocol/odata-protocol.html index 8286ecb2..83fc639c 100644 --- a/docs/odata-protocol/odata-protocol.html +++ b/docs/odata-protocol/odata-protocol.html @@ -2410,7 +2410,7 @@
If a navigation property is absent from a PUT
or PATCH
request payload, the referenced or contained entity, or the collection thereof, remain unchanged by a successful update.
If a navigation property is absent from a PUT
or PATCH
request payload, the referenced or contained entity, or the collection thereof, remains unchanged by a successful update.
Example 78: using the JSON format, a 4.01 PATCH
request can update a manager entity. Following the update, the manager has three direct reports; two existing employees and one new employee named Suzanne Brown
. The LastName
of employee 6 is updated to Smith
.
If Products
was a containment navigation property, the request and response would be the same, except for the entity-id: "@id": "Categories(6)/Products(57)"
.
If Products
was a containment navigation property, the request and response would be the same, except that the @id
would likely be relative to the category, for example, Categories(6)/Products(57)
.
If the targeted entity in the payload contains some structural properties, PUT
resets all its other structural properties. The following alternative payload resets the product name. The effect would be the same if the @id
was omitted from the request.
PUT http://host/service/Categories(6)?$expand=Products
diff --git a/docs/odata-protocol/odata-protocol.md b/docs/odata-protocol/odata-protocol.md
index 0aa8b573..049d318e 100644
--- a/docs/odata-protocol/odata-protocol.md
+++ b/docs/odata-protocol/odata-protocol.md
@@ -4454,7 +4454,7 @@ set of entities to be related according to that relationship and MUST
NOT include added links, deleted links, or deleted entities.
If a navigation property is absent from a `PUT` or `PATCH` request payload, the referenced
-or contained entity, or the collection thereof, remain unchanged by a successful update.
+or contained entity, or the collection thereof, remains unchanged by a successful update.
::: example
Example 78: using the JSON format, a 4.01 `PATCH` request can update a
@@ -4600,7 +4600,8 @@ Response
::::
If `Products` was a containment navigation property, the request and response
-would be the same, except for the entity-id: `"@id": "Categories(6)/Products(57)"`.
+would be the same, except that the `@id` would likely be relative to the category,
+for example, `Categories(6)/Products(57)`.
If the targeted entity in the payload contains some structural properties,
`PUT` resets all its other structural properties. The following alternative
diff --git a/odata-protocol/11.4 Data Modification.md b/odata-protocol/11.4 Data Modification.md
index 40b91712..4c61d0e7 100644
--- a/odata-protocol/11.4 Data Modification.md
+++ b/odata-protocol/11.4 Data Modification.md
@@ -450,7 +450,7 @@ set of entities to be related according to that relationship and MUST
NOT include added links, deleted links, or deleted entities.
If a navigation property is absent from a `PUT` or `PATCH` request payload, the referenced
-or contained entity, or the collection thereof, remain unchanged by a successful update.
+or contained entity, or the collection thereof, remains unchanged by a successful update.
::: example
Example ##ex: using the JSON format, a 4.01 `PATCH` request can update a
@@ -596,7 +596,8 @@ Response
::::
If `Products` was a containment navigation property, the request and response
-would be the same, except for the entity-id: `"@id": "Categories(6)/Products(57)"`.
+would be the same, except that the `@id` would likely be relative to the category,
+for example, `Categories(6)/Products(57)`.
If the targeted entity in the payload contains some structural properties,
`PUT` resets all its other structural properties. The following alternative