Uploaded image for project: 'OASIS Open Data Protocol (OData) TC'
  1. OASIS Open Data Protocol (OData) TC
  2. ODATA-264

Allow omitting parent key(s) in URLs to contained children

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.0_WD01
    • Fix Version/s: V4.0_WD01
    • Component/s: URL Conventions
    • Labels:
      None
    • Environment:

      [Proposed]

    • Proposal:
      Hide

      If a navigation property leading to a related entity type has a partner navigation property that specifies a referential constraint, then those key properties of the related entity that take part in the referential constraint MAY be omitted from URLs.

      Example: Order contains OrderItem, key of Order is ID, key of OrderItem is OrderID and ItemNo, with a referential constraint tying the value of the OrderID key property of the OrderItem to the value of the ID property of the Order. Then the following URLs are equivalent:

      ~/Orders(1)/Items(OrderID=1,ItemNo=2)
      ~/Orders(1)/Items(2)

      If the constrained key part is specified then it MUST match the parent.
      If the key is included in the content it must be ignored.
      This should apply any time there is a referential constraint

      Accepted: https://www.oasis-open.org/committees/download.php/48481/odata-meeting-28_on-20130307-minutes.html#odata-264

      Show
      If a navigation property leading to a related entity type has a partner navigation property that specifies a referential constraint, then those key properties of the related entity that take part in the referential constraint MAY be omitted from URLs. Example: Order contains OrderItem, key of Order is ID, key of OrderItem is OrderID and ItemNo, with a referential constraint tying the value of the OrderID key property of the OrderItem to the value of the ID property of the Order. Then the following URLs are equivalent: ~/Orders(1)/Items(OrderID=1,ItemNo=2) ~/Orders(1)/Items(2) If the constrained key part is specified then it MUST match the parent. If the key is included in the content it must be ignored. This should apply any time there is a referential constraint Accepted: https://www.oasis-open.org/committees/download.php/48481/odata-meeting-28_on-20130307-minutes.html#odata-264
    • Resolution:
      Show
      https://www.oasis-open.org/committees/download.php/48527/odata-core-v4.0-wd01-part2-url-conventions-2013-03-12.doc Accepted: https://www.oasis-open.org/committees/download.php/49026/odata-meeting-34_on-20130425_26-F2F-minutes.html#odata-264

      Description

      Containment allows specifying

        Attachments

          Activity

            People

            • Assignee:
              handl Ralf Handl
              Reporter:
              handl Ralf Handl
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: