Skip to content

Commit

Permalink
Reordered paragraphs and rephrased
Browse files Browse the repository at this point in the history
  • Loading branch information
ralfhandl committed Oct 26, 2023
1 parent 64a5452 commit bc7e307
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 10 deletions.
4 changes: 2 additions & 2 deletions docs/odata-protocol/odata-protocol.html
Original file line number Diff line number Diff line change
Expand Up @@ -1285,9 +1285,9 @@ <h4 id="11242-requesting-a-raw-value-using-value"><a name="RequestingaRawValueus
<p>The default format for <code>Edm.Binary</code> is the format specified by the <a href="https://github.com/oasis-tcs/odata-vocabularies/blob/master/vocabularies/Org.OData.Core.V1.md#MediaType"><code>Core.MediaType</code></a> annotation (see <a href="#ODataVocCore">OData-VocCore</a>) if this annotation is present. If not annotated, the format cannot be predicted by the client.</p>
<p>The default format for <code>Edm.Geo</code> types is <code>text/plain</code> using the WKT (well-known text) format, see rules <code>fullCollectionLiteral</code>, <code>fullLineStringLiteral</code>, <code>fullMultiPointLiteral</code>, <code>fullMultiLineStringLiteral</code>, <code>fullMultiPolygonLiteral</code>, <code>fullPointLiteral</code>, and <code>fullPolygonLiteral</code> in <a href="#ODataABNF">OData-ABNF</a>.</p>
<p>The default format for single primitive values except <code>Edm.Binary</code> and the <code>Edm.Geo</code> types is <code>text/plain</code>. Responses for type <code>Edm.String</code> can use the <code>charset</code> format parameter to specify the character set used for representing the string value. Responses for the other primitive types follow the rules <code>booleanValue</code>, <code>byteValue</code>, <code>dateValue</code>, <code>dateTimeOffsetValue</code>, <code>decimalValue</code>, <code>doubleValue</code>, <code>durationValue</code>, <code>enumValue</code>, <code>guidValue</code>, <code>int16Value</code>, <code>int32Value</code>, <code>int64Value</code>, <code>sbyteValue</code>, <code>singleValue</code>, and <code>timeOfDayValue</code> in <a href="#ODataABNF">OData-ABNF</a>.</p>
<p>A <code>$value</code> request for a property or operation result that is <code>null</code> results in a <a href="#ResponseCode204NoContent"><code>204 No Content</code></a> response.</p>
<p>A raw value request for a property or operation result of type <code>Edm.Stream</code> returns <code>400 Bad Request</code>.</p>
<p>A raw value request for a property or operation result that is <code>null</code> results in a <a href="#ResponseCode204NoContent"><code>204 No Content</code></a> response.</p>
<p>If the property or operation result is not available, for example due to permissions, the service responds with <a href="#ResponseCode404NotFound"><code>404 Not Found</code></a>.</p>
<p>Appending <code>/$value</code> to the URL of a property or operation result of type <code>Edm.Stream</code> returns <code>400 Bad Request</code>.</p>
<div class="example">
<p>Example 32:</p>
<pre><code>GET http://host/service/Products(1)/Name/$value</code></pre>
Expand Down
8 changes: 4 additions & 4 deletions docs/odata-protocol/odata-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -2795,15 +2795,15 @@ other primitive types follow the rules `booleanValue`, `byteValue`,
`int64Value`, `sbyteValue`, `singleValue`, and `timeOfDayValue` in
[OData-ABNF](#ODataABNF).

A `$value` request for a property or operation result that is `null` results in a
A raw value request for a property or operation result of type `Edm.Stream`
returns `400 Bad Request`.

A raw value request for a property or operation result that is `null` results in a
[`204 No Content`](#ResponseCode204NoContent) response.

If the property or operation result is not available, for example due to permissions, the
service responds with [`404 Not Found`](#ResponseCode404NotFound).

Appending `/$value` to the URL of a property or operation result of type `Edm.Stream`
returns `400 Bad Request`.

::: example
Example 32:
```
Expand Down
8 changes: 4 additions & 4 deletions odata-protocol/11 Data Service Requests.md
Original file line number Diff line number Diff line change
Expand Up @@ -269,15 +269,15 @@ other primitive types follow the rules `booleanValue`, `byteValue`,
`int64Value`, `sbyteValue`, `singleValue`, and `timeOfDayValue` in
[OData-ABNF](#ODataABNF).

A `$value` request for a property or operation result that is `null` results in a
A raw value request for a property or operation result of type `Edm.Stream`
returns `400 Bad Request`.

A raw value request for a property or operation result that is `null` results in a
[`204 No Content`](#ResponseCode204NoContent) response.

If the property or operation result is not available, for example due to permissions, the
service responds with [`404 Not Found`](#ResponseCode404NotFound).

Appending `/$value` to the URL of a property or operation result of type `Edm.Stream`
returns `400 Bad Request`.

::: example
Example ##ex:
```
Expand Down

0 comments on commit bc7e307

Please sign in to comment.