Versions Summary
This pages summarises the contents of the successive SData versions. It is presented in reverse chronological version (most recent version first).
Minor edits to the wiki are not reflected here. On the other hand, any change that may break compatiblity is listed in this page. The History of Changes page gives detailed information on the pages that have been modified between versions.
Version 1.1
|
Feature |
Summary |
Category |
Wiki Pages |
|---|---|---|---|
|
Update payloads for relationships |
Clarified the rules for the different relationship types: single child, list
of children, reference, association |
Clarification |
9.2 Update Payloads |
|
Schema tagging |
Introduced sme:tags attribute to allow contracts to add tags to schema elements |
New Feature |
4.8 Simple Metadata Extensions Summary |
|
Schema version |
Added a standard format for schema versions: major.minor.revision, with associated compatibility rules. |
New Feature |
4.9 Schema Rules |
|
Sync tick management |
Clarified sync tick management section |
Clarification |
|
|
Sync requires complete payloads |
Clarified the fact that sync feeds must transport complete payloads |
Clarification |
|
|
Standard conflict priority values for sync |
Added a table with standard conflict priority values that endpoints should use. |
New Convention |
|
|
sme:syncOrder attribute |
New schema attribute to indicate order in which resource kinds should be synched |
New Feature |
|
|
Polymorphic relations |
Added schema rules for polymorphic relations |
New Feature |
4.7 Polymophic relations |
|
Protocol filter variables |
Added protocol filter variables like $uuid and $updated to query language and sme:protocolFilters attribute |
New Feature |
2.12 Query Language |
|
Query parameters for named queries |
Named queries can take query paramters (where, orderBy, include, select) |
New Feature |
12.2 Named Query URL |
Version 1.0
Released Nov 2, 2009
|
Feature |
Summary |
Category |
Wiki Pages |
|---|---|---|---|
|
Case sensitivity rules for URLs |
Clarified the rules for case handling in URLs |
Clarification |
2.12 Naming Conventions for URLs |
|
SData Registry |
The registry contract is used to register and discover application endpoints |
New Feature |
14 SData Registry |
|
select query parameter |
New parameter to control the properties returned in SData payloads. |
New Feature |
2.11 Query Parameters |
|
returnDelta query parameter |
New parameter to optimize POST and PUT operations by asking the service to return the delta instead of the full payload. |
New Feature |
2.11 Query Parameters |
|
URL extensibility syntax |
Convention that applications should use to extend the SData URL syntax |
New Feature |
2.15 Extensibility |
|
Template for service operations |
$template can also be used to retrieve default values for input parameters of service operations. |
New Feature |
11.7 Operation Template |
|
Named Queries |
Variant of service operations, for queries that take complex parameters and return a feed. |
New Feature |
12 Named Queries |
|
sme:mandatory renamed |
sme:mandatory has been renamed sme:isMandatory for consistency. |
Breaking Change | 4.7 Simple Metadata Extensions Summary |
|
<sdata:schema> element for inlined schemas |
Inlined schemas have been moved to an <sdata:schema> element as the previous solution did not comply with the Atom rules (<link> elements cannot contain elements) |
Breaking Change | 4.9 Inlined Schemas |
|
Schema import and include |
Schemas may import or include other schemas. |
New Feature |
4.10 Importing and including schemas |
|
Reliable posting supported on regular POST operations |
Previous version did not allow the trackingID parameter to be used directly
on POST operations that create resources. It imposed an additional service
operation. |
Restriction lifted. |
8.4 Reliable Posting |
|
Internationalized URLs |
Precise rules have been given for non-ASCII characters in URLs |
Clarification |
2.16 Internationalized URLs |
|
New mechanism to express relationships between resources |
3 new attributes have been introduced to encode links between resources
directly in the payload: sdata:url, sdata:key and sdata:uuid. |
Breaking Change |
3.9 Resource Linking and Embedding |
|
New protocol to update child resources |
The protcol to update child resources has been modified. The consumer should
not send the complete list of child resources any more. Instead, it should flag
deleted resources with the sdata:isDeleted flag. |
Breaking Change | 9.2 Partial Updates |
|
sme:maxLength |
New attributes to advertise type constraints in the schema. |
New Feature |
4.7 Simple Metadata Extensions Summary |
|
Rules for parent/child relationships |
More precise rules have been given to differentiate parent/child relationships from reference and association relationships |
Clarification |
4.4 Relationship Definitions |
|
Link & Sync |
Complete protocol to link and sync resources |
New Feature |
|
|
Atom conformance |
More precise rules to make SData feeds fully conformant with Atom rules |
Clarification |
3.2 Feed Elements |
|
Schema conventions |
Added the --enum suffix convention for enum types |
New Feature |
4.6 Auxiliary Type Definitions |
|
MAY/SHOULD/MUST language |
Used MAY, SHOULD and MUST language, as specified in RFC 2119 to make the
specification more precise. |
Clarification |
All wiki pages |
|
Delete concurrency handling |
Relaxed the concurrency handling rules for delete operations. |
Relaxed existing rule |
10.2 Delete Concurrency Handling |
|
SSO |
Added Single Sign On section stating that SData will support the Sage Single Sign-On protocol. Technical details will be provided later. |
Placeholder for upcoming feature |
5.3 Single Sign-On |
Version 0.9
Released Feb 1st, 2009
SData Core Specification - version 1.1
