-
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":"c2c65807-1b23-412f-93bf-e366dd73e649","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":573.5,"redirectCount":0,"resourceLoadedEnd":543.7000002861023,"resourceLoadedStart":137.60000038146973,"resourceTiming":[{"duration":99.5,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":137.60000038146973,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":137.60000038146973,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":237.10000038146973,"responseStart":0,"secureConnectionStart":0},{"duration":99.5,"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":137.90000009536743,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":137.90000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":237.40000009536743,"responseStart":0,"secureConnectionStart":0},{"duration":99.39999961853027,"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":138.10000038146973,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":138.10000038146973,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":237.5,"responseStart":0,"secureConnectionStart":0},{"duration":99.2999997138977,"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":138.2000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":138.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":237.5,"responseStart":0,"secureConnectionStart":0},{"duration":99.10000038146973,"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":138.5,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":138.5,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":237.60000038146973,"responseStart":0,"secureConnectionStart":0},{"duration":107.90000009536743,"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":138.7000002861023,"connectEnd":138.7000002861023,"connectStart":138.7000002861023,"domainLookupEnd":138.7000002861023,"domainLookupStart":138.7000002861023,"fetchStart":138.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":138.7000002861023,"responseEnd":246.60000038146973,"responseStart":246.60000038146973,"secureConnectionStart":138.7000002861023},{"duration":126.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":139.2000002861023,"connectEnd":139.2000002861023,"connectStart":139.2000002861023,"domainLookupEnd":139.2000002861023,"domainLookupStart":139.2000002861023,"fetchStart":139.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":139.2000002861023,"responseEnd":265.80000019073486,"responseStart":265.7000002861023,"secureConnectionStart":139.2000002861023},{"duration":128.59999990463257,"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":139.40000009536743,"connectEnd":139.40000009536743,"connectStart":139.40000009536743,"domainLookupEnd":139.40000009536743,"domainLookupStart":139.40000009536743,"fetchStart":139.40000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":139.40000009536743,"responseEnd":268,"responseStart":267.90000009536743,"secureConnectionStart":139.40000009536743},{"duration":128.89999961853027,"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":139.60000038146973,"connectEnd":139.60000038146973,"connectStart":139.60000038146973,"domainLookupEnd":139.60000038146973,"domainLookupStart":139.60000038146973,"fetchStart":139.60000038146973,"redirectEnd":0,"redirectStart":0,"requestStart":139.60000038146973,"responseEnd":268.5,"responseStart":268.5,"secureConnectionStart":139.60000038146973},{"duration":129.09999990463257,"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":139.7000002861023,"connectEnd":139.7000002861023,"connectStart":139.7000002861023,"domainLookupEnd":139.7000002861023,"domainLookupStart":139.7000002861023,"fetchStart":139.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":139.7000002861023,"responseEnd":268.80000019073486,"responseStart":268.80000019073486,"secureConnectionStart":139.7000002861023},{"duration":129.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":139.90000009536743,"connectEnd":139.90000009536743,"connectStart":139.90000009536743,"domainLookupEnd":139.90000009536743,"domainLookupStart":139.90000009536743,"fetchStart":139.90000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":139.90000009536743,"responseEnd":269.2000002861023,"responseStart":269.2000002861023,"secureConnectionStart":139.90000009536743},{"duration":129.69999980926514,"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":140.10000038146973,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":140.10000038146973,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":269.80000019073486,"responseStart":0,"secureConnectionStart":0},{"duration":129.59999990463257,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/a29179d70fa8562374ee16707692af77/shortcuts.js?context=issuenavigation&context=issueaction","startTime":140.2000002861023,"connectEnd":140.2000002861023,"connectStart":140.2000002861023,"domainLookupEnd":140.2000002861023,"domainLookupStart":140.2000002861023,"fetchStart":140.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":140.2000002861023,"responseEnd":269.80000019073486,"responseStart":269.80000019073486,"secureConnectionStart":140.2000002861023},{"duration":100.7000002861023,"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":170,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":170,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":270.7000002861023,"responseStart":0,"secureConnectionStart":0},{"duration":101,"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":170.30000019073486,"connectEnd":170.30000019073486,"connectStart":170.30000019073486,"domainLookupEnd":170.30000019073486,"domainLookupStart":170.30000019073486,"fetchStart":170.30000019073486,"redirectEnd":0,"redirectStart":0,"requestStart":170.30000019073486,"responseEnd":271.30000019073486,"responseStart":271.2000002861023,"secureConnectionStart":170.30000019073486},{"duration":132.09999990463257,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:bigpipe-js/jira.webresources:bigpipe-js.js","startTime":178.90000009536743,"connectEnd":178.90000009536743,"connectStart":178.90000009536743,"domainLookupEnd":178.90000009536743,"domainLookupStart":178.90000009536743,"fetchStart":178.90000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":178.90000009536743,"responseEnd":311,"responseStart":311,"secureConnectionStart":178.90000009536743},{"duration":334.2000002861023,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:bigpipe-init/jira.webresources:bigpipe-init.js","startTime":209.5,"connectEnd":209.5,"connectStart":209.5,"domainLookupEnd":209.5,"domainLookupStart":209.5,"fetchStart":209.5,"redirectEnd":0,"redirectStart":0,"requestStart":209.5,"responseEnd":543.7000002861023,"responseStart":543.7000002861023,"secureConnectionStart":209.5}],"threshold":1000,"fetchStart":0,"domainLookupStart":35,"domainLookupEnd":35,"connectStart":35,"connectEnd":83,"secureConnectionStart":58,"requestStart":83,"responseStart":129,"responseEnd":209,"domLoading":133,"domInteractive":627,"domContentLoadedEventStart":627,"domContentLoadedEventEnd":672,"domComplete":903,"loadEventStart":903,"loadEventEnd":905,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"73a4461ca57e55","effectiveType":"4g","downlink":10,"rtt":0,"serverDuration":101,"dbReadsTimeInMs":14,"dbConnsTimeInMs":16,"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.