Skip to content

Commit

Permalink
Heiko's proposal
Browse files Browse the repository at this point in the history
  • Loading branch information
ralfhandl committed Jun 13, 2024
1 parent 92f107f commit 3aca20c
Show file tree
Hide file tree
Showing 3 changed files with 5 additions and 5 deletions.
2 changes: 1 addition & 1 deletion docs/odata-json-format/odata-json-format.html
Original file line number Diff line number Diff line change
Expand Up @@ -674,7 +674,7 @@ <h3 id="458-control-information-id-odataid"><a name="ControlInformationidodataid
<li>percent-encoding normalization as defined in section 6 of <a href="#rfc3986">RFC3986</a>.</li>
</ul>
<p>Note that the entity-id MUST be invariant across languages, so if key values are language dependent then the <code>id</code> MUST be included if it does not match convention for the localized key values. If the <code>id</code> is represented, it MAY be a <a href="#RelativeURLs">relative URL</a>.</p>
<p>If the entity is transient (i.e. cannot be read or updated), the <code>id</code> control information MUST appear in OData 4.0 payloads and have the <code>null</code> value. In 4.01 payloads transient entities need not have the <code>id</code> control information, and 4.01 clients MUST treat entities with neither <code>id</code> control information nor a full set of key properties as transient entities.</p>
<p>If the entity is transient (i.e. cannot be read or updated), the <code>id</code> control information MUST appear in OData 4.0 payloads and have the <code>null</code> value. In 4.01 or greater payloads transient entities need not have the <code>id</code> control information, and clients MUST treat entities with neither <code>id</code> control information nor a full set of key properties as transient entities.</p>
<p>The <code>id</code> control information MUST NOT appear for a collection. Its meaning in this context is reserved for future versions of this specification.</p>
<p>Entities with <code>id</code> equal to <code>null</code> cannot be compared to other entities, reread, or updated. If <a href="#metadataminimalodatametadataminimal"><code>metadata=minimal</code></a> is specified and the <code>id</code> is not present in the entity, then the canonical URL MUST be used as the entity-id.</p>
</details>
Expand Down
4 changes: 2 additions & 2 deletions docs/odata-json-format/odata-json-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -963,8 +963,8 @@ URL](#RelativeURLs).

If the entity is transient (i.e. cannot be read or updated), the
`id` control information MUST appear in OData 4.0 payloads
and have the `null` value. In 4.01 payloads transient
entities need not have the `id` control information, and 4.01
and have the `null` value. In 4.01 or greater payloads transient
entities need not have the `id` control information, and
clients MUST treat entities with neither `id` control
information nor a full set of key properties as transient entities.

Expand Down
4 changes: 2 additions & 2 deletions odata-json-format/4 Common Characteristics.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,8 +419,8 @@ URL](#RelativeURLs).

If the entity is transient (i.e. cannot be read or updated), the
`id` control information MUST appear in OData 4.0 payloads
and have the `null` value. In 4.01 payloads transient
entities need not have the `id` control information, and 4.01
and have the `null` value. In 4.01 or greater payloads transient
entities need not have the `id` control information, and
clients MUST treat entities with neither `id` control
information nor a full set of key properties as transient entities.

Expand Down

0 comments on commit 3aca20c

Please sign in to comment.