[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Proposed Charter for Open Data Protocol (OData) Technical Committee
To OASIS Members: A draft TC charter has been submitted to establish the Open Data Protocol (OData) Technical Committee. In accordance with the OASIS TC Process Policy section 2.2: (http://www.oasis-open.org/committees/process-2009-07-30.php#formation) the proposed charter is hereby submitted for comment. The comment period shall remain open until 11:45 pm EDT on 4 June 2012. OASIS maintains a mailing list for the purpose of submitting comments on proposed charters. Any OASIS member may post to this list by sending email to: oasis-charter-discuss@lists.oasis-open.org. All messages will be publicly archived at: http://lists.oasis-open.org/archives/oasis-charter-discuss/. Members who wish to receive emails must join the group by selecting "join group" on the group home page: http://www.oasis-open.org/apps/org/workgroup/oasis-charter-discuss/. Employees of organizational members do not require primary representative approval to subscribe to the oasis-charter-discuss e-mail. A telephone conference will be held among the Convener, the OASIS TC Administrator, and those proposers who wish to attend within four days of the close of the comment period. The announcement and call-in information will be noted on the OASIS Charter Discuss Group Calendar. Please note that background and explanatory documents mentioned in the charter are included with this message as attachments. We encourage member comment and ask that you note the name of the proposed TC (ODATA TC) in the subject line of your email message. --- PROPOSED CHARTER (1) Charter of the Technical Committee (1) (a) Name of the TC OASIS Open Data Protocol (OData) Technical Committee (TC) (1) (b) Statement of Purpose The purpose of the Open Data Protocol (OData) Technical Committee (TC) is to define an open data protocol for sharing data and exposing data models interoperably on the Web. The work will focus on enabling: - The creation of REST-ful HTTP-based data services, allowing resources identified using Uniform Resource Identifiers (URIs) and defined in an abstract data model, to be published and edited by Web clients using simple HTTP messages. - Exposure and access of information from a variety of sources including, but not limited to, relational databases, file systems, content management systems, and traditional Web sites. (1) (c) Scope of Work The TC will accept as input the following OData V3 core specifications published on 27 April 2012: - OData http://www.odata.org/media/30002/OData.html - OData URL Conventions http://www.odata.org/media/30002/OData%20URL%20Conventions.html - ABNF for OData http://www.odata.org/media/30002/OData%20ABNF.html - OData Common Schema Definition Language (CSDL) http://www.odata.org/media/30002/OData%20CSDL%20Definition.html - OData ATOM Format http://www.odata.org/media/30002/OData%20Atom%20Format.html - OData Verbose JSON Format http://www.odata.org/media/30002/OData%20JSON%20Verbose%20Format.html - Open Data Protocol (OData) Batch Processing http://www.odata.org/media/30002/OData%20Batch%20Processing%20Format.html And the following OData V3 extension contributions dated 18 May 2012: - OData Extension for Data Aggregation - OData Extension for Temporal Data - OData Extension for XML Data - OData Extension for JSON Data The TC will refine these initial contributions to produce OASIS standard specifications, including necessary supporting documentation. Other contributions will be accepted for consideration without any prejudice or restrictions and evaluated based on technical merit in so far as they conform to this charter. The scope of the TC's work is limited to technical refinements to the features defined in the input contributions and the following features and capabilities. The features in scope for the TC have been divided into the following categories: 1. Core 2. Extensions 3. Considerations 4. Patterns and Guidance The TC will focus on delivering the core functionality first, followed by extensions (including any necessary changes to core), followed by patterns and guidance and additional considerations, not precluding parallel work. 1. Core: Description of a Data-Oriented Service: - Description of the underlying entity model comprising: - Types of entities that may be returned from the service - Properties of entities that may be Simple types, Complex Types, Collections, Spatial types, Enumerations, Stream or navigation properties - Open entity types whose instances may expose properties not defined in metadata - Relationships between entities that may be returned from the service - Sets of entities that may be enumerated, queried, or inserted into - Nesting of sets of entities within other sets (containment scenarios) - Functions and Actions exposed by the service - Containers of sets, functions and actions exposed by the service - Additional annotations, such as visualization hints and updatability, which may be applied to metadata elements as well as individual data entries - Binding of a particular ontology provided by shared vocabularies to an entity or property description or instance - An addressing scheme for addressing metadata elements as required Interaction Semantics (request types and associated responses) for a REST-ful Data-Oriented Service: - Hypermedia-driven mechanisms for enumerating, navigating, and updating resources exposed by the service - Mechanisms to: - Retrieve entity sets, entries, service documents, individual properties, links between entities, and metadata and service documents - Navigate through responses split across multiple pages - Create new entries, media link entries - Update entries, individual properties - Delete entries - Create, remove, and replace links between entries - Invoke operations (functions and actions) on resources in the service - Retrieve changes (deltas) from a result, including tombstones for deleted or removed entries - Batch a group of requests to send to an OData service in a single request - Conventions for constructing URIs to obtain metadata, identify, query, and navigate resources exposed by an OData service - Conventions for querying resources exposed by the data-oriented service, including: - Select, Filter, OrderBy, Expand, Count, Top, Skip - Built-in String, Math, and Date functions - Custom functions - Any/All operations on collections - Filter by type, casting operators The core OData protocol shall be designed to support multiple formats. The TC will focus on specific representations for Data-Oriented Service request / response payloads in the following formats: - Atom - JSON Protocol Extensibility: - Versioning mechanism for understanding rules for processing requests/responses - Resiliency to future payload and URL convention extensions - Extensibility points for describing (i.e., through metadata annotations), invoking (i.e., through headers or URI extensibility), and representing (i.e., through payload extensibility) custom behaviors and content - Namespacing mechanism for vendor-specific extensions 2. Extensions - Capabilities such as queryability/sortability defined through additional metadata. - Representation and semantics for aggregation of data supporting multidimensional modeling - Annotate entity sets and /or entity types with annotations representing analytic concepts such as dimensions, hierarchies, measures and key performance indicators - Define semantics and operations for querying aggregated data - Define results format for queries containing aggregated data - Representation and semantics for temporal data - Annotate entity sets and/or entity types as representing temporal data with application time periods and/or system time periods - Support querying temporal types as of a particular time or time range - Support operations on, navigating between, and updating of temporal entities - Retrieval and manipulation of properties representing XML documents in OData - Identify properties that represent XML documents using annotations - Define query and update operations over XML properties - Retrieval and manipulation of properties representing JSON documents in OData - Identify properties that represent JSON documents using annotations - Define query and update operations over JSON properties 3. Considerations - Use of free text search across entities and entity sets and representation of results 4. Patterns and Guidance: - Patterns and guidance for how to do repeatable requests using OData - Guidance around data authorization model and secure authenticated access to an OData Service - Guidance for using OData endpoints with cross-origin access (e.g. CORS) - Prevention of Cross Site Request Forgery attacks (XSRF) when exposing OData endpoints Out of Scope The following is a non-exhaustive list provided only for the sake of clarity. If some function, mechanism or feature is not mentioned here, and it is not mentioned as in-scope in the Scope of Work section, then it will be deemed to be out of scope. The following items are specifically out of scope of the work of the TC: - Mapping to models, representations or protocols not scoped above - Adding unnecessary complication to the protocol by extending beyond the scope described above or redefining mechanisms for authentication, encryption, security, cross-origin access, etc. - State based protocol Contributions to this TC which are out of scope for this charter may be accumulated and taken into consideration for potential development of a charter for another technical committee that may be created to address future extensions or modifications to OData. (1) (d) List of Deliverables The TC has the following set of deliverables: - OASIS standards track OData core specification(s) to be completed by the TC within nine months after the initial TC meeting: - OData Protocol - OData Conceptual Schema Definition Language (CSDL) - OData ABNF Construction Rules - OData URL Conventions - OASIS standards track OData format specifications to be completed by the TC within nine months after the initial TC meeting: - A JSON representation for OData request / response payloads - An AtomPub representation for OData request / response payloads - A Batch processing format - OASIS standards track OData extension specifications, to be completed by the TC within twelve months after the initial TC meeting: - An OData extension defining the representation and semantics for aggregation of data supporting multidimensional modeling - An OData extension defining representation and semantics of temporal data - An OData extension defining retrieval and manipulation of properties representing XML documents in OData - An OData extension defining retrieval and manipulation of properties representing JSON documents in OData Optionally, such other non-standards track deliverables within the scope outlined above, such as tutorials, within twelve months after the initial TC meeting. Maintenance Once the TC has successfully produced the deliverables, the TC will enter into a maintenance mode. The purpose of the maintenance mode is to provide minor revisions to previously adopted deliverables, in order to clarify ambiguities, inconsistencies, and obvious errors. The maintenance mode will not functionally enhance a previously adopted deliverable, or extend its functionality. (1) (e) IPR Mode This TC will operate under the "RF (Royalty Free) on RAND" IPR mode as defined in the OASIS Intellectual Property Rights (IPR) Policy effective 15 October 2010. (1) (f) Anticipated Audience The anticipated audience for this work includes: - Vendors and service providers offering products that produce data services. - Vendors and application developers who consume data services. - Software architects who design, write and deploy data producers and/or consumers. - End users implementing solutions that require an interoperable solution for querying and updating data. (1) (g) Language TC business will be conducted in English. The output documents will be written in (US) English. (2) Non-normative information regarding the startup of the TC (2) (a) Similar or Applicable Work OData adopts Representational State Transfer (REST) principles for exposing and consuming data from a data-oriented service over Hypertext Transfer Protocol (HTTP) based systems. It is based on, and extends, the Atom Publishing Protocol (AtomPub), and defines both ATOM and JSON based formats for representing data to/from the data-oriented service. OData provides a vocabulary mechanism for defining common ontologies. Schema.org is oriented around defining common schemas for consumer oriented searchable items. (2) (b) Date, Time, and Location of First Meeting The first meeting of the OData TC will be a face-to-face meeting to be held in Redmond, Washington on July 26-27, 2012 from 9 AM PT to 5 PM PT. This meeting will be sponsored by Microsoft. (2)(c) On-Going Meeting Plans & Sponsors It is anticipated that the OData TC will meet via teleconference every week for 60 minutes at a time determined by the TC members during the TC's first meeting. It is anticipated that the OData TC will meet face-to-face every 2-3 months at a time and location to be determined by the TC members. The actual pace of face-to-face and teleconference meetings will be determined by TC members. One of the proposers, as listed below, will sponsor the teleconferences unless other TC members offer to donate their own facilities. (2)(d) Proposers of the TC Shishir Pardikar, Shishir.Pardikar@citrix.com, Citrix Susan Malaika, malaika@us.ibm.com, IBM Andrew Eisenberg, andrew.eisenberg@us.ibm.com, IBM Hubert Heijkers, Hubert.Heijkers@nl.ibm.com, IBM Pablo Castro, pablocas@microsoft.com, Microsoft Lance Olson, lanceo@microsoft.com, Microsoft Michael Pizzo, mpizzo@microsoft.com, Microsoft Mark Biamonte, Mark.Biamonte@progress.com, Progress Software Jonathan Bruce, Jonathan.Bruce@progress.com, Progress Software Jesse Davis, Jesse.Davis@progress.com, Progress Software Michael Johnson, Michael.Johnson@progress.com, Progress Software Ralf Handl, ralf.handl@sap.com, SAP Martin Zurmuehl, martin.zurmuehl@sap.com, SAP Gerald Krause, gerald.krause@sap.com, SAP Barbara Hartel, barbara.hartel@sap.com, SAP Paul Fremantle , paul@wso2.com, WSO2 Chintana Wilamuna, chintana@wso2.com, WSO2 (2)(e) Statements of Support Shishir Pardikar, Shishir.pardikar@citrix.com Citrix OData specification is an important development in the arena of interoperable web standards. Citrix is excited to support OData and as the primary OASIS representative from Citrix I support creating a Technical committee for this purpose. I approve of the OData TC-charter and am happy to be listed as a co-proposer. Dave Ings, ings@ca.ibm.com Emerging Software Standards, IBM As IBM's primary OASIS rep, I approve the OData TC Charter, and endorse our proposers (listed above) as named co-proposers. Ram Jeyaraman, ram.jeyaraman@microsoft.com Microsoft As Microsoft's Primary Representative, I am excited to support the creation of the OASIS OData Technical Committee and its goal of providing open data for the open Web. I approve the OASIS OData TC Charter, and endorse our proposers (listed above) as named co-proposers. Jaime Meritt, jmeritt@progress.com Progress Software Progress Software has reviewed the OData charter and recommends the formation of a technical committee to drive it towards standardization. Sanjay Patil, sanjay.patil@sap.com Industry Standards & Open Source, SAP AG As SAP's Primary Representative to OASIS, I approve the OASIS OData TC Charter, and endorse our proposers (listed above) as named co-proposers. Paul Fremantle, paul@wso2.com WSO2 As WSO2's Primary Representative, I strongly support the creation of the OASIS OData Technical Committee and its goal of providing open data for the open Web. I approve the OASIS OData TC Charter, (2)(f) TC Convener The TC Convener for the first meeting will be Barbara Hartel from SAP. (2)(g) Affiliation to Member Section None (2)(h) Initial contributions: OData V3 (27 April 2012): - OData: http://www.odata.org/media/30002/OData.html - OData URL Conventions: http://www.odata.org/media/30002/OData%20URL%20Conventions.html - ABNF for OData: http://www.odata.org/media/30002/OData%20ABNF.html - OData Common Schema Definition Language (CSDL): http://www.odata.org/media/30002/OData%20CSDL%20Definition.html - OData ATOM Format: http://www.odata.org/media/30002/OData%20Atom%20Format.html - OData Verbose JSON Format: http://www.odata.org/media/30002/OData%20JSON%20Verbose%20Format.html - Open Data Protocol (OData) Batch Processing: http://www.odata.org/media/30002/OData%20Batch%20Processing%20Format.html OData V3 extensions, located at dated 18 May 2012: - OData Extension for Data Aggregation - OData Extension for Temporal Data - OData Extension for XML Data - OData Extension for JSON Data -- /chet ---------------- Chet Ensign Director of Standards Development and TC Administration OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298 Mobile: +1 201-341-1393 Follow OASIS on: LinkedIn: http://linkd.in/OASISopen Twitter: http://twitter.com/OASISopen Facebook: http://facebook.com/oasis.open
Attachment:
OData Extension for Data Aggregation v1.0.pdf
Description: Adobe PDF document
Attachment:
OData Extension for JSON Data v1.0.pdf
Description: Adobe PDF document
Attachment:
OData Extension for Temporal Data v1.0.pdf
Description: Adobe PDF document
Attachment:
OData Extension for XML Data v1.0.pdf
Description: Adobe PDF document
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]