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

Bound actions and function overloads via container and structured type #233

Open
wants to merge 24 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
9c937e0
Bound actions and function overloads via container
HeikoTheissen Jan 11, 2024
8ab36ad
@ralfhandl's suggestions
HeikoTheissen Jan 11, 2024
1680d8e
Actions/Functions bound to a property via structured type
HeikoTheissen Jan 13, 2024
edaf880
Rephrased
HeikoTheissen Jan 15, 2024
c858774
style
HeikoTheissen Jan 15, 2024
cbd551c
@ralfhandl's suggestions
HeikoTheissen Jan 15, 2024
419986c
Action/Function via complex or entity type
HeikoTheissen Jan 15, 2024
584f5fd
Rephrased
HeikoTheissen Jan 15, 2024
8ab0389
Rephrased again
HeikoTheissen Jan 15, 2024
728c907
Fine-tuning
HeikoTheissen Jan 15, 2024
ffb1079
Parameters and return types
HeikoTheissen Jan 15, 2024
48dc875
Merge branch 'main' into ODATA-1626
HeikoTheissen Jan 18, 2024
d522e99
Explain "addressed via resource path"
HeikoTheissen Jan 18, 2024
2c63eb7
Rephrased
HeikoTheissen Jan 18, 2024
99fa5de
Fine-tuning
HeikoTheissen Jan 18, 2024
36ce19c
Redefine the "Property via structured type" case
HeikoTheissen Jan 19, 2024
3a76fca
Merge branch 'main' into ODATA-1626
ralfhandl Jan 26, 2024
fcfd147
Merge branch 'main' into ODATA-1626
ralfhandl Feb 1, 2024
dda4091
Merge branch 'main' into ODATA-1626
ralfhandl Feb 5, 2024
ca3bdea
Merge branch 'main' into ODATA-1626
ralfhandl Feb 15, 2024
528b59e
Merge branch 'main' into ODATA-1626
ralfhandl Feb 22, 2024
21159e2
Merge branch 'main' into ODATA-1626
ralfhandl Feb 29, 2024
6061f24
Merge remote-tracking branch 'origin/main' into ODATA-1626
HeikoTheissen Jul 11, 2024
e405cda
Merge branch 'ODATA-1626' of [email protected]:oasis-tcs/odata-specs.git
HeikoTheissen Jul 11, 2024
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
19 changes: 19 additions & 0 deletions docs/odata-csdl-json/odata-csdl-json.html
Original file line number Diff line number Diff line change
Expand Up @@ -2389,6 +2389,25 @@ <h3 id="1422-target"><a name="Target" href="#Target">14.2.2 Target</a></h3>
</table>
<p>All <a href="#QualifiedName">qualified names</a> used in a target path MUST be in scope.</p>
<p>External targeting is possible for properties and navigation properties of singletons or entities in a particular entity set. These annotations override annotations on the properties or navigation properties targeted via the declaring structured type.</p>
<p>External targeting is also possible for action and function overloads that are bound to a certain type of model element. The target path then consists of two path expressions from the table above separated by a forward slash. The first path expression references one of the following model elements:</p>
<ul>
<li>Navigation Property via container</li>
<li>Property via container</li>
<li>Navigation Property via structured type</li>
<li>Property via structured type</li>
</ul>
<p>and the second path expression references one of the following model elements:</p>
<ul>
<li>Action overload</li>
<li>Function overload</li>
</ul>
<p>where the Action or Function overload is bound with binding parameter type equal to the type of the first path expression, or the second path expression references</p>
<ul>
<li>all overloads of an Action or</li>
<li>all overloads of a Function</li>
</ul>
<p>where the binding parameter is an instance or a collection of the given type.</p>
<p>These annotations override annotations targeting the action or function overloads directly.</p>
<h2 id="143-constant-expression"><a name="ConstantExpression" href="#ConstantExpression">14.3 Constant Expression</a></h2>
<p>Constant expressions allow assigning a constant value to an applied term.</p>
<h3 id="1431-binary"><a name="Binary" href="#Binary">14.3.1 Binary</a></h3>
Expand Down
24 changes: 24 additions & 0 deletions docs/odata-csdl-json/odata-csdl-json.md
Original file line number Diff line number Diff line change
Expand Up @@ -3871,6 +3871,30 @@ properties of singletons or entities in a particular entity set. These
annotations override annotations on the properties or navigation
properties targeted via the declaring structured type.

External targeting is also possible for action and function overloads that
are bound to a certain type of model element. The target path then consists of
two path expressions from the table above separated by a forward slash. The
first path expression references one of the following model elements:
- Navigation Property via container
- Property via container
- Navigation Property via structured type
- Property via structured type

and the second path expression references one of the following model elements:
- Action overload
- Function overload

where the Action or Function overload is bound with binding parameter type
equal to the type of the first path expression, or the second path expression
references
- all overloads of an Action or
- all overloads of a Function

where the binding parameter is an instance or a collection of the given type.

These annotations override annotations targeting the action or function
overloads directly.

## <a name="ConstantExpression" href="#ConstantExpression">14.3 Constant Expression</a>

Constant expressions allow assigning a constant value to an applied
Expand Down
19 changes: 19 additions & 0 deletions docs/odata-csdl-xml/odata-csdl-xml.html
Original file line number Diff line number Diff line change
Expand Up @@ -2205,6 +2205,25 @@ <h3 id="1422-target"><a name="Target" href="#Target">14.2.2 Target</a></h3>
</table>
<p>All <a href="#QualifiedName">qualified names</a> used in a target path MUST be in scope.</p>
<p>External targeting is possible for properties and navigation properties of singletons or entities in a particular entity set. These annotations override annotations on the properties or navigation properties targeted via the declaring structured type.</p>
<p>External targeting is also possible for action and function overloads that are bound to a certain type of model element. The target path then consists of two path expressions from the table above separated by a forward slash. The first path expression references one of the following model elements:</p>
<ul>
<li>Navigation Property via container</li>
<li>Property via container</li>
<li>Navigation Property via structured type</li>
<li>Property via structured type</li>
</ul>
<p>and the second path expression references one of the following model elements:</p>
<ul>
<li>Action overload</li>
<li>Function overload</li>
</ul>
<p>where the Action or Function overload is bound with binding parameter type equal to the type of the first path expression, or the second path expression references</p>
<ul>
<li>all overloads of an Action or</li>
<li>all overloads of a Function</li>
</ul>
<p>where the binding parameter is an instance or a collection of the given type.</p>
<p>These annotations override annotations targeting the action or function overloads directly.</p>
<h2 id="143-constant-expression"><a name="ConstantExpression" href="#ConstantExpression">14.3 Constant Expression</a></h2>
<p>Constant expressions allow assigning a constant value to an applied term.</p>
<h3 id="1431-binary"><a name="Binary" href="#Binary">14.3.1 Binary</a></h3>
Expand Down
24 changes: 24 additions & 0 deletions docs/odata-csdl-xml/odata-csdl-xml.md
Original file line number Diff line number Diff line change
Expand Up @@ -3684,6 +3684,30 @@ properties of singletons or entities in a particular entity set. These
annotations override annotations on the properties or navigation
properties targeted via the declaring structured type.

External targeting is also possible for action and function overloads that
are bound to a certain type of model element. The target path then consists of
two path expressions from the table above separated by a forward slash. The
first path expression references one of the following model elements:
- Navigation Property via container
- Property via container
- Navigation Property via structured type
- Property via structured type

and the second path expression references one of the following model elements:
- Action overload
- Function overload

where the Action or Function overload is bound with binding parameter type
equal to the type of the first path expression, or the second path expression
references
- all overloads of an Action or
- all overloads of a Function

where the binding parameter is an instance or a collection of the given type.

These annotations override annotations targeting the action or function
overloads directly.

## <a name="ConstantExpression" href="#ConstantExpression">14.3 Constant Expression</a>

Constant expressions allow assigning a constant value to an applied
Expand Down
24 changes: 24 additions & 0 deletions odata-csdl/14 Vocabulary and Annotation.md
Original file line number Diff line number Diff line change
Expand Up @@ -674,6 +674,30 @@ properties of singletons or entities in a particular entity set. These
annotations override annotations on the properties or navigation
properties targeted via the declaring structured type.

External targeting is also possible for action and function overloads that
are bound to a certain type of model element. The target path then consists of
two path expressions from the table above separated by a forward slash. The
first path expression references one of the following model elements:
- Navigation Property via container
ralfhandl marked this conversation as resolved.
Show resolved Hide resolved
- Property via container
- Navigation Property via structured type
- Property via structured type

and the second path expression references one of the following model elements:
- Action overload
- Function overload

where the Action or Function overload is bound with binding parameter type
equal to the type of the first path expression, or the second path expression
references
- all overloads of an Action or
- all overloads of a Function
ralfhandl marked this conversation as resolved.
Show resolved Hide resolved

where the binding parameter is an instance or a collection of the given type.

These annotations override annotations targeting the action or function
overloads directly.

## ##subsec Constant Expression

Constant expressions allow assigning a constant value to an applied
Expand Down