-
Proposal:
Hide
1. Rephrase wording in section 3 to have clear definitions referenced throughout the text:
- input set for the input of a transformation
- output set for the result of a transformation
- the final result of the $apply option is the output set of the last transformation
2. Add general remark for the whole $apply section 3: Navigation properties in the final result set are carried over to the final result of the $apply option. Navigation properties in this final result can be further expanded using $expand.
3. Section 3.1 and 3.12: Accompany "mental bridge" by more normative text.
The necessary text changes are provided in this file, marked with the ID of this issue as comments.
Show
1. Rephrase wording in section 3 to have clear definitions referenced throughout the text:
input set for the input of a transformation
output set for the result of a transformation
the final result of the $apply option is the output set of the last transformation
2. Add general remark for the whole $apply section 3: Navigation properties in the final result set are carried over to the final result of the $apply option. Navigation properties in this final result can be further expanded using $expand.
3. Section 3.1 and 3.12: Accompany "mental bridge" by more normative text.
The necessary text changes are provided in this file , marked with the ID of this issue as comments.
When a transformation adds entities reached via navigation to its result, the request must specifically ask to expand them in order to have them appear in the response.
Example from ODATA-1409 that triggered the discussion: The join transformation in
GET ~/Products?$apply=join(Sales as Sale) creates a Sale dynamic property with Sales instances as values which are entities. Another $expand=Sale is required to include these entities in the response.
Cross-check this with other cases such that all behave in the same way:
- transformation nest that can be used to add related entities to the input set
- transformation groupby applied to single-valued navigation properties (see
ODATA-971)
- transformation aggregate on related entities (see
ODATA-945)
{"report":{"apdex":0.5,"isInitial":true,"journeyId":"4739ba65-4779-4eda-bee7-058a46d74e27","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":1301.5999999998603,"redirectCount":0,"resourceLoadedEnd":1378,"resourceLoadedStart":438.69999999995343,"resourceTiming":[{"duration":384.80000000004657,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":438.69999999995343,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":438.69999999995343,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":823.5,"responseStart":0,"secureConnectionStart":0},{"duration":385.80000000004657,"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":439,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":439,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":824.8000000000466,"responseStart":0,"secureConnectionStart":0},{"duration":385.69999999995343,"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":439.30000000004657,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":439.30000000004657,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":825,"responseStart":0,"secureConnectionStart":0},{"duration":387.30000000004657,"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":439.5,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":439.5,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":826.8000000000466,"responseStart":0,"secureConnectionStart":0},{"duration":388.60000000009313,"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":439.69999999995343,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":439.69999999995343,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":828.3000000000466,"responseStart":0,"secureConnectionStart":0},{"duration":449.39999999990687,"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":440,"connectEnd":440,"connectStart":440,"domainLookupEnd":440,"domainLookupStart":440,"fetchStart":440,"redirectEnd":0,"redirectStart":0,"requestStart":440,"responseEnd":889.3999999999069,"responseStart":889.3999999999069,"secureConnectionStart":440},{"duration":478.5,"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":440.5,"connectEnd":440.5,"connectStart":440.5,"domainLookupEnd":440.5,"domainLookupStart":440.5,"fetchStart":440.5,"redirectEnd":0,"redirectStart":0,"requestStart":440.5,"responseEnd":919,"responseStart":919,"secureConnectionStart":440.5},{"duration":486.69999999995343,"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":440.69999999995343,"connectEnd":440.69999999995343,"connectStart":440.69999999995343,"domainLookupEnd":440.69999999995343,"domainLookupStart":440.69999999995343,"fetchStart":440.69999999995343,"redirectEnd":0,"redirectStart":0,"requestStart":440.69999999995343,"responseEnd":927.3999999999069,"responseStart":927.3999999999069,"secureConnectionStart":440.69999999995343},{"duration":487,"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":440.89999999990687,"connectEnd":440.89999999990687,"connectStart":440.89999999990687,"domainLookupEnd":440.89999999990687,"domainLookupStart":440.89999999990687,"fetchStart":440.89999999990687,"redirectEnd":0,"redirectStart":0,"requestStart":440.89999999990687,"responseEnd":927.8999999999069,"responseStart":927.8999999999069,"secureConnectionStart":440.89999999990687},{"duration":487.20000000018626,"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":441.0999999998603,"connectEnd":441.0999999998603,"connectStart":441.0999999998603,"domainLookupEnd":441.0999999998603,"domainLookupStart":441.0999999998603,"fetchStart":441.0999999998603,"redirectEnd":0,"redirectStart":0,"requestStart":441.0999999998603,"responseEnd":928.3000000000466,"responseStart":928.3000000000466,"secureConnectionStart":441.0999999998603},{"duration":487.39999999990687,"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":441.30000000004657,"connectEnd":441.30000000004657,"connectStart":441.30000000004657,"domainLookupEnd":441.30000000004657,"domainLookupStart":441.30000000004657,"fetchStart":441.30000000004657,"redirectEnd":0,"redirectStart":0,"requestStart":441.30000000004657,"responseEnd":928.6999999999534,"responseStart":928.6999999999534,"secureConnectionStart":441.30000000004657},{"duration":600.3000000000466,"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":441.39999999990687,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":441.39999999990687,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":1041.6999999999534,"responseStart":0,"secureConnectionStart":0},{"duration":487.69999999995343,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/a29179d70fa8562374ee16707692af77/shortcuts.js?context=issuenavigation&context=issueaction","startTime":441.5,"connectEnd":441.5,"connectStart":441.5,"domainLookupEnd":441.5,"domainLookupStart":441.5,"fetchStart":441.5,"redirectEnd":0,"redirectStart":0,"requestStart":441.5,"responseEnd":929.1999999999534,"responseStart":929.1999999999534,"secureConnectionStart":441.5},{"duration":559.6999999999534,"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":482.19999999995343,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":482.19999999995343,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":1041.8999999999069,"responseStart":0,"secureConnectionStart":0},{"duration":447.39999999990687,"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":482.5,"connectEnd":482.5,"connectStart":482.5,"domainLookupEnd":482.5,"domainLookupStart":482.5,"fetchStart":482.5,"redirectEnd":0,"redirectStart":0,"requestStart":482.5,"responseEnd":929.8999999999069,"responseStart":929.8999999999069,"secureConnectionStart":482.5},{"duration":722.0999999998603,"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":493,"connectEnd":493,"connectStart":493,"domainLookupEnd":493,"domainLookupStart":493,"fetchStart":493,"redirectEnd":0,"redirectStart":0,"requestStart":493,"responseEnd":1215.0999999998603,"responseStart":1215.0999999998603,"secureConnectionStart":493}],"threshold":1000,"fetchStart":0,"domainLookupStart":332,"domainLookupEnd":332,"connectStart":332,"connectEnd":381,"secureConnectionStart":357,"requestStart":382,"responseStart":430,"responseEnd":512,"domLoading":433,"domInteractive":1550,"domContentLoadedEventStart":1550,"domContentLoadedEventEnd":1675,"domComplete":2111,"loadEventStart":2111,"loadEventEnd":2113,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"2b64542af513e2","effectiveType":"4g","downlink":9.5,"rtt":0,"serverDuration":95,"dbReadsTimeInMs":19,"dbConnsTimeInMs":24,"applicationHash":"4d4040e0714d65b7fffa4801569d014c0b16eaa9","experiments":[]}}
2021-03-18