[ODATA-428] Introduce dynamic expression AnnotationPath and accompanying abstract type Edm.AnnotationPath - OASIS Technical Committees Issue Tracker

Details

Type: Bug
Status: Closed
Priority: Major
Resolution: Fixed
Affects Version/s: V4.0_CSD01
Fix Version/s: V4.0_CSD02
Component/s: CSDL XML
Labels:
None
Environment:

[Applied]

Proposal:

Hide

The edm:AnnotationPath expression provides a value for terms or term properties that specify the built-in abstract type Edm.AnnotationPath. It uses the same syntax and rules as the edm:Path expression, with the added restriction that the last path segment MUST be a term cast with optional qualifier in the context of the preceding path part.
In contrast to the edm:Path expression the value of the edm:AnnotationPath expression is the path itself, not the value of the annotation identified by the path. This is useful for terms that reuse or refer to other terms.
The edm:AnnotationPath expression MAY be provided using element notation or attribute notation.
Example xx:
<Annotation Term="UI.ReferenceFacet" AnnotationPath="Product/Supplier@UI.LineItem" />

<Annotation Term="UI.CollectionFacet" Qualifier="Contacts">
<Collection>
<AnnotationPath>Supplier/@Communication.Contact</AnnotationPath>
<AnnotationPath>Customer/@Communication.Contact</AnnotationPath>
</Collection>
</Annotation>

Show
The edm:AnnotationPath expression provides a value for terms or term properties that specify the built-in abstract type Edm.AnnotationPath. It uses the same syntax and rules as the edm:Path expression, with the added restriction that the last path segment MUST be a term cast with optional qualifier in the context of the preceding path part. In contrast to the edm:Path expression the value of the edm:AnnotationPath expression is the path itself, not the value of the annotation identified by the path. This is useful for terms that reuse or refer to other terms. The edm:AnnotationPath expression MAY be provided using element notation or attribute notation. Example xx: <Annotation Term="UI.ReferenceFacet" AnnotationPath="Product/Supplier@UI.LineItem" /> <Annotation Term="UI.CollectionFacet" Qualifier="Contacts"> <Collection> <AnnotationPath>Supplier/@Communication.Contact</AnnotationPath> <AnnotationPath>Customer/@Communication.Contact</AnnotationPath> </Collection> </Annotation>
Resolution:

Hide

https://www.oasis-open.org/committees/download.php/49613/odata-v4.0-wd02-part1-protocol-2013-06-19.docx
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/vocabularies/Org.OData.Core.V1.xml?rev=377
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/vocabularies/Org.OData.Capabilities.V1.xml?rev=379

https://www.oasis-open.org/committees/download.php/49614/odata-v4.0-wd02-part2-url-conventions-2013-06-19.docx
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/ABNF/odata-abnf-construction-rules.txt?rev=380
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/ABNF/odata-abnf-testcases.xml?rev=380

https://www.oasis-open.org/committees/download.php/49615/odata-v4.0-wd02-part3-csdl-2013-06-19.docx
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/edmx.xsd?rev=357
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/edm.xsd?rev=377
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/MetadataService.edmx?rev=374

https://www.oasis-open.org/committees/download.php/49611/odata-atom-format-v4.0-wd02-2013-06-19.docx
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/metadata.xsd?rev=382

https://www.oasis-open.org/committees/download.php/49612/odata-json-format-v4.0-wd02-2013-06-19.docx

Show
https://www.oasis-open.org/committees/download.php/49613/odata-v4.0-wd02-part1-protocol-2013-06-19.docx https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/vocabularies/Org.OData.Core.V1.xml?rev=377 https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/vocabularies/Org.OData.Capabilities.V1.xml?rev=379 https://www.oasis-open.org/committees/download.php/49614/odata-v4.0-wd02-part2-url-conventions-2013-06-19.docx https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/ABNF/odata-abnf-construction-rules.txt?rev=380 https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/ABNF/odata-abnf-testcases.xml?rev=380 https://www.oasis-open.org/committees/download.php/49615/odata-v4.0-wd02-part3-csdl-2013-06-19.docx https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/edmx.xsd?rev=357 https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/edm.xsd?rev=377 https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/MetadataService.edmx?rev=374 https://www.oasis-open.org/committees/download.php/49611/odata-atom-format-v4.0-wd02-2013-06-19.docx https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/metadata.xsd?rev=382 https://www.oasis-open.org/committees/download.php/49612/odata-json-format-v4.0-wd02-2013-06-19.docx

Description

The Path dynamic expression allows to refer to the value identified by a path through an entity graph. Path expressions can end in a

property
navigation property
term cast with optional qualifiers.

In some situations the path itself is of primary interest, which is why we introduced the dynamic expressions PropertyPath and NavigationPropertyPath.

Unfortunately we forgot the AnnotationPath for paths ending in a term cast with optional qualifiers.

Introduce dynamic expression AnnotationPath and accompanying abstract type Edm.AnnotationPath

Details

Description

Attachments

Activity

People

Dates