<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:17:21 CET 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>Magnolia - Issue tracker</title>
    <link>https://jira.magnolia-cms.com</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-uk</language>    <build-info>
        <version>9.4.2</version>
        <build-number>940002</build-number>
        <build-date>19-01-2023</build-date>
    </build-info>


<item>
            <title>[DOCU-1349] How to get items in natural order with the REST delivery endpoint</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-1349</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;The only way to definitely get items in natural order is to use a &quot;readNode&quot; to get a parent item and all the children will be listed in natural order. This should be clearly documented.&lt;/p&gt;

&lt;p&gt;It should also be documented that if you supply no parameters or path - then the QUERY is used, not the READNODE.&lt;/p&gt;

&lt;p&gt;It should be documented that when the QUERY is used with no ordering paramaters - than the &quot;nagtural&quot; repositories order will be used. But that this unfortunately often does not reflect the order in the app. There should be some information about JCR indexing etc. See forum posts linked here: &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLREST-169?focusedCommentId=156550&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-156550&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.magnolia-cms.com/browse/MGNLREST-169?focusedCommentId=156550&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-156550&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;hr /&gt;

&lt;p&gt;It might be possible to do this on items in the root by requesting the root node - but im not sure.&lt;/p&gt;

&lt;p&gt;After a ticket is fixed it may be possible to get items from the &quot;query&quot; but it depends on a bug being fixed and on strange JCR behaviour as mentioned in linked ticket.&lt;/p&gt;

&lt;p&gt;See comments on: &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLREST-169&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.magnolia-cms.com/browse/MGNLREST-169&lt;/a&gt;&lt;/p&gt;</description>
                <environment></environment>
        <key id="64650">DOCU-1349</key>
            <summary>How to get items in natural order with the REST delivery endpoint</summary>
                <type id="3" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10898&amp;avatarType=issuetype">Task</type>
                                            <priority id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/priorities/neutral.gif">Neutral</priority>
                        <status id="6" iconUrl="https://jira.magnolia-cms.com/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="11">Done</resolution>
                                        <assignee username="mdrapela">Martin Dr&#225;pela</assignee>
                                    <reporter username="czimmermann">Christopher Zimmermann</reporter>
                        <labels>
                    </labels>
                <created>Wed, 28 Feb 2018 14:54:32 +0100</created>
                <updated>Wed, 16 May 2018 16:37:02 +0200</updated>
                            <resolved>Wed, 16 May 2018 09:06:30 +0200</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="156560" author="czimmermann" created="Wed, 28 Feb 2018 16:07:39 +0100"  >&lt;p&gt;Note that there is an existing limitation i that you (apparently) can not get readNode from the ROOT: &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLREST-173&quot; title=&quot;Get ordered tree of content from configured root of endpoint&quot; class=&quot;issue-link&quot; data-issue-key=&quot;MGNLREST-173&quot;&gt;&lt;del&gt;MGNLREST-173&lt;/del&gt;&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="160473" author="cmeier" created="Mon, 14 May 2018 03:42:48 +0200"  >&lt;p&gt;&lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=mdrapela&quot; class=&quot;user-hover&quot; rel=&quot;mdrapela&quot;&gt;mdrapela&lt;/a&gt; - I have reviewd. &lt;br/&gt;
 I was adding one sentence somewhere (you will be notified by wiki mail).&lt;/p&gt;

&lt;p&gt;Note the following: &lt;br/&gt;
The related dev tickets&#160;REST-173 and REST-186&#160;have been released with rest-2.1.1 - hence the first bundle getting it was 5.6.6 (not 5.6.5)&lt;br/&gt;
 So ... the mentioned Magnolia versions at the &lt;tt&gt;orderBy&lt;/tt&gt; param must be changed, I guess. See:&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;&lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS56/Delivery+endpoint+API+v1#DeliveryendpointAPIv1-anc-orderBy&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS56/Delivery+endpoint+API+v1#DeliveryendpointAPIv1-anc-orderBy&lt;/a&gt;&lt;/li&gt;
	&lt;li&gt;&lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS56/Delivery+endpoint+API+v2#DeliveryendpointAPIv2-anc-orderBy&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS56/Delivery+endpoint+API+v2#DeliveryendpointAPIv2-anc-orderBy&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;I anyway could not completely follow your text&lt;/p&gt;
&lt;blockquote&gt;&lt;p&gt;&quot;Please note that until Magnolia 5.6.5 ...&quot;&lt;br/&gt;
 &quot;Since Magnolia 5.6.5 the results are returned unsorted if no ...&quot;&lt;/p&gt;&lt;/blockquote&gt;
&lt;p&gt;I am still not sure about the order when using no query params, no path and not using &lt;tt&gt;@nodes&lt;/tt&gt; . I was asking &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=dai.ha&quot; class=&quot;user-hover&quot; rel=&quot;dai.ha&quot;&gt;dai.ha&lt;/a&gt; and he checks for me with the VN Core team. (He also was not fully sure at first sight).&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;

&lt;p&gt;&#160;&lt;/p&gt;</comment>
                            <comment id="160477" author="cmeier" created="Mon, 14 May 2018 06:07:13 +0200"  >&lt;p&gt;After having discussed the whoe thing with &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=hieu.nguyen&quot; class=&quot;user-hover&quot; rel=&quot;hieu.nguyen&quot;&gt;hieu.nguyen&lt;/a&gt; -I have realized, that we actually have no 3 &quot;sub resources&quot;&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;readNode&lt;/li&gt;
	&lt;li&gt;queryNodes&lt;/li&gt;
	&lt;li&gt;getChildren&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;There is indeed a new public method. In docs we mention this as the &lt;tt&gt;@nodes&lt;/tt&gt; handle.&lt;br/&gt;
 Hieu and me, we think we should change the docs, and mention the &quot;@nodes&quot; handle&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;either as a 3rd mentioned sub resource&lt;/li&gt;
	&lt;li&gt;or within the readNode section.&lt;/li&gt;
&lt;/ul&gt;


&lt;hr /&gt;
&lt;p&gt;And we should clarify the point concerning how things are ordered, of no &lt;tt&gt;orderBy&lt;/tt&gt; param is used.&lt;br/&gt;
 The following requests would respond with &quot;naturally&quot; ordered nodes:&lt;/p&gt;
&lt;ul class=&quot;alternate&quot; type=&quot;square&quot;&gt;
	&lt;li&gt;&lt;tt&gt;/.rest/ep/&lt;/tt&gt;&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;/.rest/ep/@nodes&lt;/tt&gt;&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;/.rest/ep/travel/@nodes&lt;/tt&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;But the request&lt;br/&gt;
 &lt;tt&gt;/.rest/ep/travel&lt;/tt&gt;&lt;br/&gt;
 &lt;em&gt;not&lt;/em&gt;!&lt;/p&gt;</comment>
                            <comment id="160480" author="hieu.nguyen" created="Mon, 14 May 2018 07:06:47 +0200"  >&lt;p&gt;&lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=cmeier&quot; class=&quot;user-hover&quot; rel=&quot;cmeier&quot;&gt;cmeier&lt;/a&gt; Sorry, I meant readNode has no order for properties because they are written manually.&#160;&lt;b&gt;For child nodes, they&apos;re returned in natural order.&lt;/b&gt;&lt;/p&gt;

&lt;p&gt;&lt;span class=&quot;image-wrap&quot; style=&quot;&quot;&gt;&lt;a id=&quot;44582_thumb&quot; href=&quot;https://jira.magnolia-cms.com/secure/attachment/44582/44582_requests-and-the-order-of-their-nodes-in-response_edited.png&quot; title=&quot;requests-and-the-order-of-their-nodes-in-response_edited.png&quot; file-preview-type=&quot;image&quot; file-preview-id=&quot;44582&quot; file-preview-title=&quot;requests-and-the-order-of-their-nodes-in-response_edited.png&quot;&gt;&lt;img src=&quot;https://jira.magnolia-cms.com/secure/thumbnail/44582/_thumb_44582.png&quot; style=&quot;border: 0px solid black&quot; role=&quot;presentation&quot;/&gt;&lt;/a&gt;&lt;/span&gt;&lt;/p&gt;</comment>
                            <comment id="160521" author="czimmermann" created="Mon, 14 May 2018 13:24:14 +0200"  >&lt;p&gt;&quot;Get children&quot; basically means using the &quot;@nodes&quot; handle right?&#160;&lt;/p&gt;

&lt;p&gt;If so, wouldnt it make sense to include that as a part of &quot;Read node&quot; or directly underneath it, since it behaves almost the same as &quot;Read node&quot;? - Its kind of a special way to use &quot;Read node&quot;.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>relation</name>
                                            <outwardlinks description="is related to">
                                        <issuelink>
            <issuekey id="64076">MGNLREST-169</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="64652">MGNLREST-173</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                            <attachment id="44581" name="requests-and-the-order-of-their-nodes-in-response.JPG" size="2007802" author="cmeier" created="Mon, 14 May 2018 06:30:19 +0200"/>
                            <attachment id="44582" name="requests-and-the-order-of-their-nodes-in-response_edited.png" size="3636627" author="hieu.nguyen" created="Mon, 14 May 2018 07:09:41 +0200"/>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                            <customfield id="customfield_14166" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Acceptance criteria</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10111" key="com.atlassian.jira.toolkit:reporterdomain">
                        <customfieldname>Company</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>magnolia-cms.com</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10031" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Wed, 25 Apr 2018 11:44:59 +0200</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_12730" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_14151" key="com.atlassian.jira.toolkit:message">
                        <customfieldname>Docu info</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_12130" key="com.atlassian.jira.plugin.system.customfieldtypes:multicheckboxes">
                        <customfieldname>Documentation update required</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="13300"><![CDATA[Yes]]></customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10061" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comm is not jira-dev</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10071" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last participant</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>cmeier</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            5 years, 39 weeks, 6 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10011" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>czimmermann</customfieldvalue>
            <customfieldvalue>cmeier</customfieldvalue>
            <customfieldvalue>hieu.nguyen</customfieldvalue>
            <customfieldvalue>mdrapela</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|o002jo:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10244" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10245" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="705">Docu Sprint 48</customfieldvalue>
    <customfieldvalue id="712">Docu Sprint 49</customfieldvalue>
    <customfieldvalue id="724">Docu Sprint 50</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10242" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.5</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_14167" key="com.okapya.jira.checklist:checklist">
                        <customfieldname>Task DoR</customfieldname>
                        <customfieldvalues>
                            
        <checklist>
        <![CDATA[
                            




                
                                    <div class="o-completion" style="display: flex; flex-shrink: 0;"><span  class="aui-lozenge aui-lozenge-complete" style="font-size: 12px; font-weight: normal; display: flex; flex-direction: row; align-items: center;" ><span style="padding-right: 4px; vertical-align: middle;"><svg width="15" height="15" viewBox="0 0 15 15" xmlns="http://www.w3.org/2000/svg" fill="white"><path clip-rule="evenodd" d="m10.41037,3.42544l-7.86501,0c-0.72395,0 -1.31084,0.58688 -1.31084,1.31084l0,7.86508c0,0.7239 0.58689,1.3108 1.31084,1.3108l7.86501,0c0.724,0 1.3109,-0.5869 1.3109,-1.3108l0,-7.86508c0,-0.72396 -0.5869,-1.31084 -1.3109,-1.31084zm-7.86501,-0.65542c-1.08593,0 -1.96626,0.88032 -1.96626,1.96626l0,7.86508c0,1.0859 0.88033,1.9662 1.96626,1.9662l7.86501,0c1.086,0 1.9663,-0.8803 1.9663,-1.9662l0,-7.86508c0,-1.08594 -0.8803,-1.96626 -1.9663,-1.96626l-7.86501,0z" fill-rule="evenodd"/><path d="m5.09049,10.18526l-1.82767,-1.82766l-0.78479,0.78479l2.61246,2.61246l5.38758,-5.38754l-0.78483,-0.78479l-4.60275,4.60274z"/></svg></span><span>Empty</span></span></div>
                        ]]>
    </checklist>


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                    <customfield id="customfield_14145" key="com.intenso.jira.issue-templates:issue-templates-customfield">
                        <customfieldname>Template</customfieldname>
                        <customfieldvalues>
                            


                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_15131" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Time in Discovery</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10032" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        </customfields>
    </item>
</channel>
</rss>