Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Post-conditions #1972

Draft
wants to merge 10 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Clients SHOULD
  • Loading branch information
HeikoTheissen committed Aug 1, 2024
commit 86899f91dab142259319c2479747dbc31d1f9a21
1 change: 1 addition & 0 deletions docs/odata-protocol/odata-protocol.html
Original file line number Diff line number Diff line change
Expand Up @@ -2272,6 +2272,7 @@ <h3 id="1142-create-an-entity"><a name="CreateanEntity" href="#CreateanEntity">1
<p>If the entity being created is not an open entity, additional property values beyond those specified in the metadata SHOULD NOT be sent in the request body. The service MUST fail if unable to persist all property values specified in the request.</p>
<p>If non-insertable properties are included in the request body, services MUST either ignore them or fail the request if the provided values do not match the service-determined values.</p>
<p>A client who has out-of-band knowledge that a service has the latter behavior for certain non-insertable properties can provide them in an insert request and benefit from the certainty that, if the request succeeds, their service-determined values match the provided values. Providing such properties effectively imposes “post-conditions” that must be met for the request to succeed.</p>
<p>Otherwise, clients SHOULD omit non-insertable properties from the request body.</p>
<p>Non-insertable properties include (and are not limited to)</p>
<ul>
<li>dependent properties that are tied to non-key properties of the principal entity through a referential constraint <a href="#ODataCSDL">OData-CSDL, section 8.5</a> (informally: “denormalized” properties),</li>
Expand Down
2 changes: 2 additions & 0 deletions docs/odata-protocol/odata-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -4190,6 +4190,8 @@ certainty that, if the request succeeds, their service-determined values match
the provided values. Providing such properties effectively imposes "post-conditions"
that must be met for the request to succeed.

Otherwise, clients SHOULD omit non-insertable properties from the request body.

Non-insertable properties include (and are not limited to)

- dependent properties that are tied to non-key properties of the principal entity through a referential constraint [OData-CSDL, section 8.5](#ODataCSDL) (informally: "denormalized" properties),
Expand Down
2 changes: 2 additions & 0 deletions odata-protocol/11.4 Data Modification.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,6 +188,8 @@ certainty that, if the request succeeds, their service-determined values match
the provided values. Providing such properties effectively imposes "post-conditions"
that must be met for the request to succeed.

Otherwise, clients SHOULD omit non-insertable properties from the request body.

Non-insertable properties include (and are not limited to)

- dependent properties that are tied to non-key properties of the principal entity through a referential constraint [OData-CSDL, section 8.5](#ODataCSDL) (informally: "denormalized" properties),
Expand Down