Skip to content

Commit 896f023

Browse files
committed
No EntitySetPath => context URL
1 parent b163a2a commit 896f023

5 files changed

Lines changed: 11 additions & 0 deletions

File tree

docs/odata-csdl-json/odata-csdl-json.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1956,6 +1956,7 @@ <h3><a id="IsBound.13.1" href="#IsBound.13.1"><code>$IsBound</code></a></h3>
19561956
<h2 id="126-entity-set-path"><a id="EntitySetPath" href="#EntitySetPath">12.6 Entity Set Path</a></h2>
19571957
</summary>
19581958
<p>Bound actions and functions that return an entity or a collection of entities MAY specify an entity set path. The entity set path specifies the canonical collection (as defined in <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL">OData-Protocol, section 10</a>) of the returned entities in terms of the binding parameter value.</p>
1959+
<p>If no entity set path is specified or the canonical collection cannot be determined by the following rules, the service SHOULD include a context URL <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL">OData-Protocol, section 10</a> in the response.</p>
19591960
<p>The entity set path consists of a series of segments joined together with forward slashes. The first segment of the entity set path MUST be the name of the binding parameter. If the entity set path consists only of the name of the binding parameter, the binding parameter MUST be an entity or a collection of entities. In this case the returned entities MUST belong to the same canonical collection as the binding parameter.</p>
19601961
<p>Otherwise the entity set path has the form <span class="math inline">\(p/s_1/…/s_k\)</span> with <span class="math inline">\(k&gt;0\)</span>, and the binding parameter MUST be single-valued. The additional segments <span class="math inline">\(s_1,…,s_k\)</span> MUST be paths that could occur in an expand item <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part2-url-conventions.html#SystemQueryOptionexpand">OData-URL, section 5.1.3</a>, and they MUST end with the name of a <a href="#NavigationProperty">navigation property</a>, optionally followed by the <a href="#QualifiedName">qualified name</a> of a type cast. Furthermore, <span class="math inline">\(s_1,…,s_{k-1}\)</span> MUST be single-valued, and <span class="math inline">\(s_k\)</span> MUST name a collection-valued navigation property. In this case all returned entities MUST belong to the canonical collection <span class="math inline">\(C\)</span> of the final navigation property, if this can be determined by the following algorithm:</p>
19611962
<ol type="1">

docs/odata-csdl-json/odata-csdl-json.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2819,6 +2819,9 @@ entities MAY specify an entity set path. The entity set path specifies the canon
28192819
(as defined in [OData-Protocol, section 10](https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL)) of the
28202820
returned entities in terms of the binding parameter value.
28212821

2822+
If no entity set path is specified or the canonical collection cannot be determined
2823+
by the following rules, the service SHOULD include a context URL [OData-Protocol, section 10](https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL) in the response.
2824+
28222825
The entity set path consists of a series of segments joined together
28232826
with forward slashes.
28242827
The first segment of the entity set path MUST be the name of the binding

docs/odata-csdl-xml/odata-csdl-xml.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1843,6 +1843,7 @@ <h3><a id="AttributeIsBound.21.2" href="#AttributeIsBound.21.2">Attribute <code>
18431843
<h2 id="126-entity-set-path"><a id="EntitySetPath" href="#EntitySetPath">12.6 Entity Set Path</a></h2>
18441844
</summary>
18451845
<p>Bound actions and functions that return an entity or a collection of entities MAY specify an entity set path. The entity set path specifies the canonical collection (as defined in <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL">OData-Protocol, section 10</a>) of the returned entities in terms of the binding parameter value.</p>
1846+
<p>If no entity set path is specified or the canonical collection cannot be determined by the following rules, the service SHOULD include a context URL <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL">OData-Protocol, section 10</a> in the response.</p>
18461847
<p>The entity set path consists of a series of segments joined together with forward slashes. The first segment of the entity set path MUST be the name of the binding parameter. If the entity set path consists only of the name of the binding parameter, the binding parameter MUST be an entity or a collection of entities. In this case the returned entities MUST belong to the same canonical collection as the binding parameter.</p>
18471848
<p>Otherwise the entity set path has the form <span class="math inline">\(p/s_1/…/s_k\)</span> with <span class="math inline">\(k&gt;0\)</span>, and the binding parameter MUST be single-valued. The additional segments <span class="math inline">\(s_1,…,s_k\)</span> MUST be paths that could occur in an expand item <a href="https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part2-url-conventions.html#SystemQueryOptionexpand">OData-URL, section 5.1.3</a>, and they MUST end with the name of a <a href="#NavigationProperty">navigation property</a>, optionally followed by the <a href="#QualifiedName">qualified name</a> of a type cast. Furthermore, <span class="math inline">\(s_1,…,s_{k-1}\)</span> MUST be single-valued, and <span class="math inline">\(s_k\)</span> MUST name a collection-valued navigation property. In this case all returned entities MUST belong to the canonical collection <span class="math inline">\(C\)</span> of the final navigation property, if this can be determined by the following algorithm:</p>
18481849
<ol type="1">

docs/odata-csdl-xml/odata-csdl-xml.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2698,6 +2698,9 @@ entities MAY specify an entity set path. The entity set path specifies the canon
26982698
(as defined in [OData-Protocol, section 10](https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL)) of the
26992699
returned entities in terms of the binding parameter value.
27002700

2701+
If no entity set path is specified or the canonical collection cannot be determined
2702+
by the following rules, the service SHOULD include a context URL [OData-Protocol, section 10](https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part1-protocol.html#ContextURL) in the response.
2703+
27012704
The entity set path consists of a series of segments joined together
27022705
with forward slashes.
27032706
The first segment of the entity set path MUST be the name of the binding

odata-csdl/12 Action and Function.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -186,6 +186,9 @@ entities MAY specify an entity set path. The entity set path specifies the canon
186186
(as defined in [#OData-Protocol#ContextURL]) of the
187187
returned entities in terms of the binding parameter value.
188188

189+
If no entity set path is specified or the canonical collection cannot be determined
190+
by the following rules, the service SHOULD include a context URL [#OData-Protocol#ContextURL] in the response.
191+
189192
The entity set path consists of a series of segments joined together
190193
with forward slashes.
191194
The first segment of the entity set path MUST be the name of the binding

0 commit comments

Comments
 (0)