-
Proposal:
Hide
To stay downward compatible with the current spec, the parameter default value must be false.
Extend the current definitions (additions are enclosed in *):
<Function Name="isdescendant" IsBound="true">
<Annotation Term="Core.Description" String="Returns true, if and only if the value of the node property of the specified hierarchy is a descendant of the given parent node with a distance of less than or equal to the optionally specified maximum distance"/>
<Parameter Name="Entity" Type="Edm.EntityType" Nullable="false"/>
<Parameter Name="Hierarchy" Type="Edm.String" Nullable="false"/>
<Parameter Name="Node" Type="Edm.PrimitiveType" Nullable="false"/>
<Parameter Name="MaxDistance" Type="Edm.Int16"/>
*
<Parameter Name="IncludeParent" Type="Edm.Boolean">
<Annotation Term="Core.OptionalParameter">
<PropertyValue Property="DefaultValue" String="false"/>
</Annotation>
</Parameter>
*
<ReturnType Type="Edm.Boolean"/>
</Function>
<Function Name="isancestor" IsBound="true">
<Annotation Term="Core.Description" String="Returns true, if and only if the value of the node property of the specified hierarchy is an ancestor of the given child node with a distance of less than or equal to the optionally specified maximum distance"/>
<Parameter Name="Entity" Type="Edm.EntityType" Nullable="false"/>
<Parameter Name="Hierarchy" Type="Edm.String" Nullable="false"/>
<Parameter Name="Node" Type="Edm.PrimitiveType" Nullable="false"/>
<Parameter Name="MaxDistance" Type="Edm.Int16"/>
<ReturnType Type="Edm.Boolean"/>
*
<Parameter Name="IncludeChild" Type="Edm.Boolean">
<Annotation Term="Core.OptionalParameter">
<PropertyValue Property="DefaultValue" String="false"/>
</Annotation>
</Parameter>
*
</Function>
Note that term OptionalParameter has become available in the Core vocabulary with the work on OData version 4.01.
add to proposal:
- extend description by explanation of newly added parameter.
Show
To stay downward compatible with the current spec, the parameter default value must be false.
Extend the current definitions (additions are enclosed in *):
<Function Name="isdescendant" IsBound="true">
<Annotation Term="Core.Description" String="Returns true, if and only if the value of the node property of the specified hierarchy is a descendant of the given parent node with a distance of less than or equal to the optionally specified maximum distance"/>
<Parameter Name="Entity" Type="Edm.EntityType" Nullable="false"/>
<Parameter Name="Hierarchy" Type="Edm.String" Nullable="false"/>
<Parameter Name="Node" Type="Edm.PrimitiveType" Nullable="false"/>
<Parameter Name="MaxDistance" Type="Edm.Int16"/>
*
<Parameter Name="IncludeParent" Type="Edm.Boolean">
<Annotation Term="Core.OptionalParameter">
<PropertyValue Property="DefaultValue" String="false"/>
</Annotation>
</Parameter>
*
<ReturnType Type="Edm.Boolean"/>
</Function>
<Function Name="isancestor" IsBound="true">
<Annotation Term="Core.Description" String="Returns true, if and only if the value of the node property of the specified hierarchy is an ancestor of the given child node with a distance of less than or equal to the optionally specified maximum distance"/>
<Parameter Name="Entity" Type="Edm.EntityType" Nullable="false"/>
<Parameter Name="Hierarchy" Type="Edm.String" Nullable="false"/>
<Parameter Name="Node" Type="Edm.PrimitiveType" Nullable="false"/>
<Parameter Name="MaxDistance" Type="Edm.Int16"/>
<ReturnType Type="Edm.Boolean"/>
*
<Parameter Name="IncludeChild" Type="Edm.Boolean">
<Annotation Term="Core.OptionalParameter">
<PropertyValue Property="DefaultValue" String="false"/>
</Annotation>
</Parameter>
*
</Function>
Note that term OptionalParameter has become available in the Core vocabulary with the work on OData version 4.01.
add to proposal:
extend description by explanation of newly added parameter.
-
Resolution:
Show
https://github.com/oasis-tcs/odata-vocabularies/pull/77
The current definitions of the two hierarchy filter functions isancestor and isdescendant specify that the functions return true only if the current entity is a strict ancestor/descendant of the given start node.
Practical applications sometimes require the start node to be included in the result. For this purpose, both functions could be extended by an optional Boolean parameter that allows the OData client to specify, if the start node shall be included in the result. With this, the filter expression $it/Aggregation.isdescendant(Hierarchy='SalesOrgHierarchy',Node='EMEA',IncludeParent=”true”) could avoid the clumsier $it/Aggregation.isdescendant(Hierarchy='SalesOrgHierarchy',Node='EMEA') or ID eq 'EMEA'
{"report":{"apdex":0.5,"isInitial":true,"journeyId":"2522a7dc-0b5c-41ea-b870-dd2e891ccb98","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":2788.2999997138977,"redirectCount":0,"resourceLoadedEnd":2672.0999999046326,"resourceLoadedStart":304.69999980926514,"resourceTiming":[{"duration":39.80000019073486,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":304.69999980926514,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":304.69999980926514,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":344.5,"responseStart":0,"secureConnectionStart":0},{"duration":52.69999980926514,"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":305,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":305,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":357.69999980926514,"responseStart":0,"secureConnectionStart":0},{"duration":56.299999713897705,"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":305.09999990463257,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":305.09999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":361.3999996185303,"responseStart":0,"secureConnectionStart":0},{"duration":57,"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":305.2999997138977,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":305.2999997138977,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":362.2999997138977,"responseStart":0,"secureConnectionStart":0},{"duration":59.89999961853027,"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":305.5,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":305.5,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":365.3999996185303,"responseStart":0,"secureConnectionStart":0},{"duration":449,"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":305.69999980926514,"connectEnd":517.5999999046326,"connectStart":468.8999996185303,"domainLookupEnd":468.8999996185303,"domainLookupStart":468.8999996185303,"fetchStart":305.69999980926514,"redirectEnd":0,"redirectStart":0,"requestStart":517.6999998092651,"responseEnd":754.6999998092651,"responseStart":563.8999996185303,"secureConnectionStart":492.7999997138977},{"duration":2299.2000002861023,"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":305.7999997138977,"connectEnd":523.5,"connectStart":474.69999980926514,"domainLookupEnd":474.69999980926514,"domainLookupStart":474.69999980926514,"fetchStart":305.7999997138977,"redirectEnd":0,"redirectStart":0,"requestStart":523.5,"responseEnd":2605,"responseStart":560.2999997138977,"secureConnectionStart":498.7999997138977},{"duration":334.80000019073486,"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":305.8999996185303,"connectEnd":606.8999996185303,"connectStart":557.5,"domainLookupEnd":557.5,"domainLookupStart":557.3999996185303,"fetchStart":305.8999996185303,"redirectEnd":0,"redirectStart":0,"requestStart":607,"responseEnd":640.6999998092651,"responseStart":639.8999996185303,"secureConnectionStart":581.8999996185303},{"duration":589.6999998092651,"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":306.19999980926514,"connectEnd":868.5,"connectStart":819.6999998092651,"domainLookupEnd":819.6999998092651,"domainLookupStart":819.5999999046326,"fetchStart":306.19999980926514,"redirectEnd":0,"redirectStart":0,"requestStart":868.5999999046326,"responseEnd":895.8999996185303,"responseStart":894.5999999046326,"secureConnectionStart":843.7999997138977},{"duration":617.3000001907349,"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":306.2999997138977,"connectEnd":896.8999996185303,"connectStart":848.8999996185303,"domainLookupEnd":848.8999996185303,"domainLookupStart":848.8999996185303,"fetchStart":306.2999997138977,"redirectEnd":0,"redirectStart":0,"requestStart":897,"responseEnd":923.5999999046326,"responseStart":922.6999998092651,"secureConnectionStart":872.6999998092651},{"duration":653,"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":306.5,"connectEnd":930.8999996185303,"connectStart":881.8999996185303,"domainLookupEnd":881.8999996185303,"domainLookupStart":881.8999996185303,"fetchStart":306.5,"redirectEnd":0,"redirectStart":0,"requestStart":931,"responseEnd":959.5,"responseStart":958.6999998092651,"secureConnectionStart":906.0999999046326},{"duration":90.59999990463257,"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":306.59999990463257,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":306.59999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":397.19999980926514,"responseStart":0,"secureConnectionStart":0},{"duration":665.7000002861023,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/a29179d70fa8562374ee16707692af77/shortcuts.js?context=issuenavigation&context=issueaction","startTime":306.7999997138977,"connectEnd":944.3999996185303,"connectStart":895.6999998092651,"domainLookupEnd":895.6999998092651,"domainLookupStart":895.6999998092651,"fetchStart":306.7999997138977,"redirectEnd":0,"redirectStart":0,"requestStart":944.5999999046326,"responseEnd":972.5,"responseStart":971.5999999046326,"secureConnectionStart":919.8999996185303},{"duration":319.69999980926514,"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":370.09999990463257,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":370.09999990463257,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":689.7999997138977,"responseStart":0,"secureConnectionStart":0},{"duration":1837.7000002861023,"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":370.3999996185303,"connectEnd":2180.0999999046326,"connectStart":2131.199999809265,"domainLookupEnd":2131.199999809265,"domainLookupStart":2131.199999809265,"fetchStart":370.3999996185303,"redirectEnd":0,"redirectStart":0,"requestStart":2180.0999999046326,"responseEnd":2208.0999999046326,"responseStart":2207.2999997138977,"secureConnectionStart":2155.3999996185303},{"duration":2290.7999997138977,"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":379,"connectEnd":2642.7999997138977,"connectStart":2593.8999996185303,"domainLookupEnd":2593.8999996185303,"domainLookupStart":2593.8999996185303,"fetchStart":379,"redirectEnd":0,"redirectStart":0,"requestStart":2642.7999997138977,"responseEnd":2669.7999997138977,"responseStart":2669,"secureConnectionStart":2618},{"duration":2272.5999999046326,"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":399.5,"connectEnd":2645.8999996185303,"connectStart":2598,"domainLookupEnd":2598,"domainLookupStart":2597.8999996185303,"fetchStart":399.5,"redirectEnd":0,"redirectStart":0,"requestStart":2646,"responseEnd":2672.0999999046326,"responseStart":2671.2999997138977,"secureConnectionStart":2621.699999809265},{"duration":1454.9000000953674,"initiatorType":"xmlhttprequest","name":"https://issues.oasis-open.org/rest/webResources/1.0/resources","startTime":901.8999996185303,"connectEnd":2326.3999996185303,"connectStart":2277.8999996185303,"domainLookupEnd":2277.8999996185303,"domainLookupStart":2277.7999997138977,"fetchStart":901.8999996185303,"redirectEnd":0,"redirectStart":0,"requestStart":2326.5999999046326,"responseEnd":2356.7999997138977,"responseStart":2356.0999999046326,"secureConnectionStart":2301.8999996185303}],"threshold":1000,"fetchStart":1,"domainLookupStart":134,"domainLookupEnd":154,"connectStart":154,"connectEnd":235,"secureConnectionStart":179,"requestStart":235,"responseStart":299,"responseEnd":400,"domLoading":304,"domInteractive":2833,"domContentLoadedEventStart":2833,"domContentLoadedEventEnd":2880,"domComplete":3467,"loadEventStart":3467,"loadEventEnd":3469,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"a43f0ccbf97b73","effectiveType":"4g","downlink":9.9,"rtt":0,"serverDuration":130,"dbReadsTimeInMs":27,"dbConnsTimeInMs":38,"applicationHash":"4d4040e0714d65b7fffa4801569d014c0b16eaa9","experiments":[]}}
New Feature
Minor
Resolved 2018-02-22