[ODATA-756] Clarify when odata.metadataEtag will be returned - OASIS Technical Committees Issue Tracker

XML

Word

Printable

Proposal:

Hide

If an ETag is returned when requesting the metadata document, then the service SHOULD set the odata.metadataEtag annotation to the metadata document's ETag in all responses when using odata.metadata=minimal or full. If no ETag is returned when requesting the metadata document, then the service SHOULD NOT set the odata.metadataEtag annotation in any responses.

Show
If an ETag is returned when requesting the metadata document, then the service SHOULD set the odata.metadataEtag annotation to the metadata document's ETag in all responses when using odata.metadata=minimal or full. If no ETag is returned when requesting the metadata document, then the service SHOULD NOT set the odata.metadataEtag annotation in any responses.
Resolution:

Hide

https://www.oasis-open.org/committees/download.php/54711/odata-json-format-v4.0-wd08-2014-12-12.docx

Show
https://www.oasis-open.org/committees/download.php/54711/odata-json-format-v4.0-wd08-2014-12-12.docx

In the JSON format doc, section 4.5.2, there is this partial statement about odata.metadataEtag:

"The odata.metadataEtag annotation MAY appear in a response in order to specify..."

The "MAY" in this statement needs to be clarified so it is clear when the metadata ETag will be returned.