Document:
02844: Deprecate certain v2 methods for resource preview

Draft (A preliminary unapproved sketch, outline, or version.)

Details

Submitted By Dr. Martin Sarabura on 2015-07-30 12:22 pm UTC

Publication Type

None at this time.

Group / Folder

OASIS OSLC Lifecycle Integration Core (OSLC Core) TC / System Ballot Results

Modified by

Not modified.

Copy

This document is not a copy.

Technical Contact

None at this time.

Download Count

436

Download Agreement

None at this time.

Description

1. Preview Discovery To preserve compatibility with OSLC2, preview discovery must continue to support the Accept: application/x-oslc-compact+xml header to get the Compact resource. This usage will be noted as deprecated. OLSC3 clients should use the Link header with rel="http://open-services.net/ns/core#Compact" and the Prefer header with include="http://open-services.net/ns/core#PreferCompact”, using the Accept header with standard MIME types such as text/turtle, application/rdf+xml, application/ld+json, etc. to get the Compact resource in the desired format. 2. Preview Resource Representation OSLC3 must continue to support the OSLC2 Compact resource XML representation. This format will be noted as deprecated. OSLC3 clients should use the Accept and Prefer headers to get the compact resource in Turtle or JSON format. Servers may support other formats such as application/rdf+xml and application/ld+json. 3. Preview Resize OSLC3 will continue to support the OSLC2 oslc-preview-height resize message, but this usage will be noted as deprecated. OSLC3 servers should use the oslc-resize message. OSLC3 servers should send both the oslc-preview-height and oslc-resize messages if OSLC2 compatibility is a requirement. This results in very few changes to Resource Preview - just including the x- MIME type and XML format for the OSLC2 Compact resource, and handling the oslc-preview-height resize message for OSLC2 compatibility.