[ODATA-435] Simplify URL syntax and CSDL by restricting services to exactly one entity container - OASIS Technical Committees Issue Tracker

Details

Type: Improvement
Status: Closed
Priority: Major
Resolution: Fixed
Affects Version/s: V4.0_CSD01
Fix Version/s: V4.0_CSD02
Component/s: ABNF, ATOM Format, CSDL XML, JSON Format, Protocol, URL Conventions
Labels:
None
Environment:

[Applied]

Proposal:
Hide

CSDL

a schema can have at most one entity container

the metadata document of a service MUST have exactly one entity container, multiple schemas are allowed and can be used to group model elements

entity containers still have a Name attribute

an entity container can still extend the entity container of another schema, the Extends attribute will name the entity container whose container is extended

EntitySet attribute of ActionImport and FunctionImport elements only allow a SimpleIdentifier because there's no need to qualify entity set names

URL/ABNF

remove optional container qualifier (rule containerQualifier) from URL conventions
Show
CSDL a schema can have at most one entity container the metadata document of a service MUST have exactly one entity container, multiple schemas are allowed and can be used to group model elements entity containers still have a Name attribute an entity container can still extend the entity container of another schema, the Extends attribute will name the entity container whose container is extended EntitySet attribute of ActionImport and FunctionImport elements only allow a SimpleIdentifier because there's no need to qualify entity set names URL/ABNF remove optional container qualifier (rule containerQualifier) from URL conventions
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

We had to introduce a URL convention for addressing children of non-default entity containers using names with at least two dots in them (e.g. namespace.container.entityset), which already lead to some confusion.

We can simplify that by restricting services to one entity container, defined in the central $metadata CSDL document.

This would also remove the IsDefaultEntityContainer attribute from CSDL

Simplify URL syntax and CSDL by restricting services to exactly one entity container

Details

Description

Attachments

Activity

People

Dates