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

Allow omitting namespaces for unambiguous functions/actions

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: V4.0_ERRATA02
    • Fix Version/s: V4.01_WD01
    • Component/s: Protocol
    • Labels:
    • Environment:

      Simplified Syntax;[Proposed]

    • Proposal:
      Hide

      -introduce a vocabulary element for services to declare one or more default namespaces, as per simplified url proposal (https://www.oasis-open.org/apps/org/workgroup/odata/email/archives/201511/msg00007.html)

      -4.01 services need to support invoking unqualified actions/functions defined within a default namespace
      -State that bound actions/functions SHOULD NOT conflict with any properties on the type they are bound to
      -Define a precedence for resolving possible conflicts as per simplified url proposal:
      -declared property=>function/action=>open property
      -Services must also allow qualified invocation

      -make sure that docs are clear that services must not require clients to understand custom annotations, but OData annotations may imply semantics that a client reporting support for that version of the specification would need to understand in order to work correctly with the service.

      Show
      -introduce a vocabulary element for services to declare one or more default namespaces, as per simplified url proposal ( https://www.oasis-open.org/apps/org/workgroup/odata/email/archives/201511/msg00007.html ) -4.01 services need to support invoking unqualified actions/functions defined within a default namespace -State that bound actions/functions SHOULD NOT conflict with any properties on the type they are bound to -Define a precedence for resolving possible conflicts as per simplified url proposal: -declared property=>function/action=>open property -Services must also allow qualified invocation -make sure that docs are clear that services must not require clients to understand custom annotations, but OData annotations may imply semantics that a client reporting support for that version of the specification would need to understand in order to work correctly with the service.
    • Resolution:
      Show
      https://www.oasis-open.org/apps/org/workgroup/odata/download.php/59028/odata-v4.01-wd01-part1-protocol.docx https://www.oasis-open.org/apps/org/workgroup/odata/download.php/59029/odata-v4.01-wd01-part2-url-conventions.docx https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/4.01%20spec/ABNF/odata-abnf-construction-rules.txt

      Description

      I hear a lot of pushback on having to qualify functions/actions when invoking.

      We can support unqualified function/actions as long as they don't conflict with any properties.

        Attachments

          Activity

            People

            • Assignee:
              mikep Michael Pizzo
              Reporter:
              mikep Michael Pizzo
            • Watchers:
              5 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: