-
Proposal:
Show
Specify in Section 10 of [ATOM] that an individual property is serialized as an element named "value" in the odata metadata namespace (that may contain metadata:type and metadata:null attributes, following the same rules as the d:<propertyname> element (which should be updated in 5.1.11.1 to include the metadata:null attribute) and correct examples in Section 10 and 11 accordingly.
Accepted: https://www.oasis-open.org/committees/download.php/48346/odata-meeting-26_on-20130221-minutes.html#odata-254
-
Resolution:
Show
https://www.oasis-open.org/committees/download.php/48383/odata-atom-format-v4.0-wd01-2013-02-26-RH.doc
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/metadata.xsd?rev=204
https://www.oasis-open.org/committees/download.php/48441/odata-atom-format-v4.0-wd01-2013-03-05-RH.doc
https://tools.oasis-open.org/version-control/browse/wsvn/odata/trunk/spec/schemas/metadata.xsd?rev=205
Accepted: https://www.oasis-open.org/committees/download.php/48549/odata-meeting-29_on-20130314-minutes.html#odata-254
Currently, the example in Section 10 of [ATOM] implies that when selecting a single property (i.e., ~Customers('ALFKI')/FirstName), the payload would contain the name of the property in the d: namespace:
<Title xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices">CEO<Title>
This implies that what is represented is a property with a given name, which is not the case; what should be represented is the value of the property, which is independent of the property itself (and can thus be used, for example, in passing as a parameter to an action). This is also inconsistent with how a function that returns a single property is represented, and is inconsistent with the JSON format (which represents this as a name/value pair with the name "value").
We should specify that an individual property is serialized in ATOM as an element named "value" in the odata metadata namespace.
{"report":{"apdex":1,"isInitial":true,"journeyId":"96835234-83a5-4eec-8571-47661607ceb5","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":937.3000001907349,"redirectCount":0,"resourceLoadedEnd":1215.3000001907349,"resourceLoadedStart":281.7000002861023,"resourceTiming":[{"duration":236.89999961853027,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":281.7000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":281.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":518.5999999046326,"responseStart":0,"secureConnectionStart":0},{"duration":294.59999990463257,"initiatorType":"link","name":"https://issues.oasis-open.org/s/7d2823769c2e7b66e860863fe879b7f8-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/css/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.css?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&richediton=true","startTime":282,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":282,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":576.5999999046326,"responseStart":0,"secureConnectionStart":0},{"duration":294.6000003814697,"initiatorType":"link","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.css","startTime":282.09999990463257,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":282.09999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":576.7000002861023,"responseStart":0,"secureConnectionStart":0},{"duration":294.69999980926514,"initiatorType":"link","name":"https://issues.oasis-open.org/s/645acc233eb869f48a571293b8358a7d-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static-adgs/jira.webresources:global-static-adgs.css","startTime":282.2000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":282.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":576.9000000953674,"responseStart":0,"secureConnectionStart":0},{"duration":294.5,"initiatorType":"link","name":"https://issues.oasis-open.org/s/a0dd6509771c1de0667aae5429c04cda-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static/jira.webresources:global-static.css","startTime":282.40000009536743,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":282.40000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":576.9000000953674,"responseStart":0,"secureConnectionStart":0},{"duration":305.59999990463257,"initiatorType":"script","name":"https://issues.oasis-open.org/s/e5479157e7a0c08b005e6522f2f04104-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/js/_super/batch.js?locale=en-US","startTime":282.5,"connectEnd":282.5,"connectStart":282.5,"domainLookupEnd":282.5,"domainLookupStart":282.5,"fetchStart":282.5,"redirectEnd":0,"redirectStart":0,"requestStart":282.5,"responseEnd":588.0999999046326,"responseStart":588.0999999046326,"secureConnectionStart":282.5},{"duration":342.59999990463257,"initiatorType":"script","name":"https://issues.oasis-open.org/s/83514d5d4e8543747b02042eafcdc99c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/js/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.js?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":282.7000002861023,"connectEnd":282.7000002861023,"connectStart":282.7000002861023,"domainLookupEnd":282.7000002861023,"domainLookupStart":282.7000002861023,"fetchStart":282.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":282.7000002861023,"responseEnd":625.3000001907349,"responseStart":625.3000001907349,"secureConnectionStart":282.7000002861023},{"duration":344.90000009536743,"initiatorType":"script","name":"https://issues.oasis-open.org/s/70bb2263e59e7e1f04fbd137c80b895b-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/aae1242f5fc81cc6a5bb8bc963ccda29/_/download/contextbatch/js/atl.global,-_super/batch.js?locale=en-US","startTime":282.90000009536743,"connectEnd":282.90000009536743,"connectStart":282.90000009536743,"domainLookupEnd":282.90000009536743,"domainLookupStart":282.90000009536743,"fetchStart":282.90000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":282.90000009536743,"responseEnd":627.8000001907349,"responseStart":627.8000001907349,"secureConnectionStart":282.90000009536743},{"duration":345.1000003814697,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-en/jira.webresources:calendar-en.js","startTime":283.09999990463257,"connectEnd":283.09999990463257,"connectStart":283.09999990463257,"domainLookupEnd":283.09999990463257,"domainLookupStart":283.09999990463257,"fetchStart":283.09999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":283.09999990463257,"responseEnd":628.2000002861023,"responseStart":628.2000002861023,"secureConnectionStart":283.09999990463257},{"duration":345.2999997138977,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-localisation-moment/jira.webresources:calendar-localisation-moment.js","startTime":283.2000002861023,"connectEnd":283.2000002861023,"connectStart":283.2000002861023,"domainLookupEnd":283.2000002861023,"domainLookupStart":283.2000002861023,"fetchStart":283.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":283.2000002861023,"responseEnd":628.5,"responseStart":628.5,"secureConnectionStart":283.2000002861023},{"duration":345.30000019073486,"initiatorType":"script","name":"https://issues.oasis-open.org/s/cda37faab827dbdf305de8efe8282062-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.js?locale=en-US","startTime":283.59999990463257,"connectEnd":283.59999990463257,"connectStart":283.59999990463257,"domainLookupEnd":283.59999990463257,"domainLookupStart":283.59999990463257,"fetchStart":283.59999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":283.59999990463257,"responseEnd":628.9000000953674,"responseStart":628.9000000953674,"secureConnectionStart":283.59999990463257},{"duration":449.3999996185303,"initiatorType":"link","name":"https://issues.oasis-open.org/s/07245784f53abc49bad9d9d4d36c577a-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/cadc4f20cc5c138dee060d42cf85f220/_/download/contextbatch/css/jira.global.look-and-feel,-_super/batch.css","startTime":283.7000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":283.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":733.0999999046326,"responseStart":0,"secureConnectionStart":0},{"duration":345.69999980926514,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/a29179d70fa8562374ee16707692af77/shortcuts.js?context=issuenavigation&context=issueaction","startTime":283.80000019073486,"connectEnd":283.80000019073486,"connectStart":283.80000019073486,"domainLookupEnd":283.80000019073486,"domainLookupStart":283.80000019073486,"fetchStart":283.80000019073486,"redirectEnd":0,"redirectStart":0,"requestStart":283.80000019073486,"responseEnd":629.5,"responseStart":629.5,"secureConnectionStart":283.80000019073486},{"duration":416.3999996185303,"initiatorType":"link","name":"https://issues.oasis-open.org/s/f77fd89aa211a76b20e9b0e63564383c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/css/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.css?jira.create.linked.issue=true&richediton=true","startTime":316.7000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":316.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":733.0999999046326,"responseStart":0,"secureConnectionStart":0},{"duration":313.2000002861023,"initiatorType":"script","name":"https://issues.oasis-open.org/s/41525c48ddceeb9b11e54085268fc285-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/js/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.js?jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":317,"connectEnd":317,"connectStart":317,"domainLookupEnd":317,"domainLookupStart":317,"fetchStart":317,"redirectEnd":0,"redirectStart":0,"requestStart":317,"responseEnd":630.2000002861023,"responseStart":630.2000002861023,"secureConnectionStart":317}],"threshold":1000,"fetchStart":0,"domainLookupStart":177,"domainLookupEnd":177,"connectStart":177,"connectEnd":226,"secureConnectionStart":201,"requestStart":226,"responseStart":272,"responseEnd":359,"domLoading":280,"domInteractive":1245,"domContentLoadedEventStart":1245,"domContentLoadedEventEnd":1299,"domComplete":2342,"loadEventStart":2342,"loadEventEnd":2347,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"5b257f2626da95","effectiveType":"4g","downlink":10,"rtt":0,"serverDuration":105,"dbReadsTimeInMs":14,"dbConnsTimeInMs":17,"applicationHash":"4d4040e0714d65b7fffa4801569d014c0b16eaa9","experiments":[]}}
Using metadata:type and metadata:null attributes within an metadata:value element feels odd, and we already use a local attribute "type" for the metadata:annotation element, so I defined the metadata:value element with local attributes "type" and "null":
<!-- payload format for property value responses -->
<xs:element name="value">
<xs:complexType mixed="true">
<xs:sequence>
<xs:any namespace="http://docs.oasis-open.org/odata/ns/data" processContents="lax" minOccurs="0"
maxOccurs="unbounded" />
</xs:sequence>
<xs:attribute name="type" type="edm:TPropertyType" />
<xs:attribute name="null" type="xs:boolean" />
</xs:complexType>
</xs:element>
Looking at how collections of primitive or complex scalar values are now represented, it feels extremely odd that the "element" element is "defined" in the (probably forever) schema-less "data" namespace instead of also being defined in the metadata namespace like its siblings metadata:annotation and metadata:value.