Previous Page Arrow Next Page Arrow

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
Allowed two modes for lists: full list and delta, with sdata:deleteMissing to distinguish between the two (full mode was only a compat mode in 1.0, it is now back in the standard)
Reserved sdata:index for future use in the XSD (no mention in the wiki)

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

2.2 Tick Management

Sync requires complete payloads

Clarified the fact that sync feeds must transport complete payloads

Clarification

4.4 Synchronization Feed

Standard conflict priority values for sync

Added a table with standard conflict priority values that endpoints should use.

New Convention

4.2 Synchronization Digest

sme:syncOrder attribute

New schema attribute to indicate order in which resource kinds should be synched

New Feature

4.5 Synchronization Metadata

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.
This limitation has been lifted

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.
This mechanism supersedes the <link> mechanism from the previous version.
sdata:lookup and sdata:descriptor have also been added to support generic interactive clients.
sme:hasUuid has been introduce to advertise if resource payloads carry an sdata:uuid attribute or not.

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.
A flag (sdata:deleteMissing) has been introduced to allow providers to support the old protocol.

Breaking Change 9.2 Partial Updates

sme:maxLength
sme:averageLength
sme:totalDigits
sme:fractionDigits

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

Link & Sync

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
Compliance paragraphs

Used MAY, SHOULD and MUST language, as specified in RFC 2119 to make the specification more precise.
Added compliance paragraphs to clarify what is mandatory and what is optional for SData compliance.

Clarification

All wiki pages

Delete concurrency handling

Relaxed the concurrency handling rules for delete operations.
Provider should not return an error if the ETag value is absent.

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


Previous Page Arrow Next Page Arrow