<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 01:17:44 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-1390] Delivery endpoint: how to filter on specific languages</title>
                <link>https://jira.magnolia-cms.com/browse/DOCU-1390</link>
                <project id="10190" key="DOCU">Documentation</project>
                    <description>&lt;p&gt;When you provide a string in a filter - the endpoint will only return items where the english result matches. This should be documented, and how to filter on another language should be documented ie &quot;How to filter on a specific language&quot;.&lt;/p&gt;

&lt;p&gt;For example if I filter on the tours with ?body&lt;span class=&quot;error&quot;&gt;&amp;#91;like&amp;#93;&lt;/span&gt;=%25einmalig%25&#160;I will get no results.&lt;/p&gt;

&lt;p&gt;To filter on a foreign language I must filter on ?body_de&lt;span class=&quot;error&quot;&gt;&amp;#91;like&amp;#93;&lt;/span&gt;=%25einmalig%25, and then I will get the Tiger beach tour.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_de[like]=%25einmalig%25&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_de[like]=%25einmalig%25&lt;/a&gt;&lt;/p&gt;

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

&lt;p&gt;(See &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLREST-181&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.magnolia-cms.com/browse/MGNLREST-181&lt;/a&gt;&#160;for extended discussion)&lt;/p&gt;

&lt;p&gt;(cc &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=mgeljic&quot; class=&quot;user-hover&quot; rel=&quot;mgeljic&quot;&gt;mgeljic&lt;/a&gt;)&lt;/p&gt;</description>
                <environment></environment>
        <key id="65204">DOCU-1390</key>
            <summary>Delivery endpoint: how to filter on specific languages</summary>
                <type id="4" iconUrl="https://jira.magnolia-cms.com/secure/viewavatar?size=xsmall&amp;avatarId=10890&amp;avatarType=issuetype">Improvement</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>Tue, 27 Mar 2018 10:35:18 +0200</created>
                <updated>Mon, 23 Jul 2018 09:12:16 +0200</updated>
                            <resolved>Fri, 20 Jul 2018 13:27:42 +0200</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="164872" author="mdrapela" created="Wed, 18 Jul 2018 15:00:00 +0200"  >&lt;p&gt;A nice ticket - thx for it &lt;a href=&quot;https://jira.magnolia-cms.com/secure/ViewProfile.jspa?name=czimmermann&quot; class=&quot;user-hover&quot; rel=&quot;czimmermann&quot;&gt;czimmermann&lt;/a&gt; -&#160; resulting in a seemingly &quot;simple&quot; doc change it actually points again to a more general question of de-i18nizing the property names in REST responses (except in the case of adding &quot;lang=all&quot;).&lt;/p&gt;

&lt;p&gt;As a user I may not be aware of which language content is the default for a given site and so while - staying in the language-specifying mood for a while - the following&#160;&#160;&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_de[like]=%25einmalige%25&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_de[like]=%25einmalige%25&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;does produce a result (actually two entries), an analogy in English&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_en[like]=%25once-in-a-lifetime%25&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body_en[like]=%25once-in-a-lifetime%25&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;produces nothing.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;In order to get the English content you need to remove the _en locale suffix:&lt;/b&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body[like]=%25once-in-a-lifetime%25&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://demo.magnolia-cms.com/.rest/delivery/tours/v1?body[like]=%25once-in-a-lifetime%25&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;and only then you get:&lt;/p&gt;
&lt;div class=&quot;preformatted panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;preformattedContent panelContent&quot;&gt;
&lt;pre&gt;&#160;{
&quot;results&quot;:[
{
&quot;@name&quot;: &quot;Last-Bike-out-of-Hanoi&quot;,
&quot;@path&quot;: &quot;/magnolia-travels/Last-Bike-out-of-Hanoi&quot;,
&quot;@id&quot;: &quot;4d0b919a-99d3-469e-95d9-491f83eaab2c&quot;,
&quot;@nodeType&quot;: &quot;mgnl:content&quot;,
&quot;isFeatured&quot;: &quot;true&quot;,
&quot;name&quot;: &quot;Last Bike out of Hanoi&quot;,
&quot;description&quot;: &quot;Roam Vietnam&apos;s northern province on a trusty Minsk motorcycle&quot;,
&quot;location&quot;: &quot;Hanoi, Vietnam&quot;,
&quot;tourTypes&quot;:[{&quot;@name&quot;: &quot;offPath&quot;, &quot;@path&quot;: &quot;/tour-types/offPath&quot;,&#8230;],
&quot;author&quot;: &quot;Magnolia Travels&quot;,
&quot;body&quot;: &quot;&amp;lt;p&amp;gt;H&amp;amp;agrave; Giang, Vietnam&amp;amp;#39;s northern province, is an enchanting landscape of misty mountains and winding backroads. Roam this far-flung corner of civilization on a trusty Minsk motorcycle, the mule of the mountains. Reliable, simple and ideally suited for harsh mountain roads, the Minsk enjoys a cult following in Vietnam. Like the bike, our weathered guide Quy&#7873;n is a native of H&amp;amp;agrave; Giang.&amp;lt;/p&amp;gt;\n&amp;lt;p&amp;gt;A week-long motorbike roadtrip in North Vietnam is a once-in-a-lifetime experience. Movement takes over the consciousness as you ride through emerald green valleys and past centuries-old rice terraces, into a different state of mind.&amp;lt;/p&amp;gt;\n&amp;lt;p&amp;gt;Stark cliffs cut through the gray sky. Pouring rain turns the road into a glorious soup. The bike plows through the cappuccino-colored substance effortlessly on wide knobby tyres. Until it no longer does. A water buffalo watches as you push your bike through the mud. After a day you tend to forget about the weather, focusing instead on staying on the road that seems too narrow for any vehicle. You wonder how the local truck drivers manage to keep keep from falling into the ravine as you struggle to keep even two wheels on the pavement.&amp;lt;/p&amp;gt;\n&amp;lt;p&amp;gt;Lunch break at a village market. The chicken you nearly hit on the way in now enriches the steaming bowl of pho. Scents of lemongrass and coriander fill your brain. The smiling host added too much chili but you don&amp;amp;#39;t mind. The pho warms your core, a welcome feeling after the rain. This beautiful backwater of the world gets few visitors and you begin to understand why.&amp;lt;/p&amp;gt;\n&amp;lt;p&amp;gt;Accommodation in North Vietnam is affordable and easy to find. Lodging here is all-inclusive in the Buddhist sense: everything you need but nothing you want. Wood fire to keep you dry, peace of mind, good night sleep.&amp;lt;/p&amp;gt;\n&amp;lt;p&amp;gt;Magnolia Travels organizes week-long motorcycle tours in H&amp;amp;agrave; Giang six times a year. Book your adventure now.&amp;lt;/p&amp;gt; &quot;,
&quot;destination&quot;:[{&quot;@name&quot;: &quot;asia&quot;, &quot;@path&quot;: &quot;/destinations/asia&quot;,&#8230;],
&quot;duration&quot;: &quot;7&quot;,
&quot;image&quot;:{&quot;@name&quot;: &quot;flickr_hanoi_motorbike_by20_Khanh_Hmoong_15358008654_4081834552_k.jpg&quot;, &quot;@path&quot;: &quot;/tours/flickr_hanoi_motorbike_by20_Khanh_Hmoong_15358008654_4081834552_k.jpg&quot;,&#8230;},
&quot;@nodes&quot;:[]
}
]
}
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;(Thinking about a convenient way to describe this in the DOCS.)&lt;/p&gt;</comment>
                            <comment id="164999" author="cmeier" created="Fri, 20 Jul 2018 13:27:15 +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; -&lt;/p&gt;

&lt;p&gt;2 comments / things &lt;em&gt;I&lt;/em&gt; would change:&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;I would rather &lt;em&gt;not&lt;/em&gt; using the &quot;rest-path&quot; &lt;tt&gt;/.rest/delivery/tours/v1&lt;/tt&gt;.&lt;br/&gt;
 We both know that this one points to an &lt;b&gt;ep&lt;/b&gt; which actually is using version 2 of the API. But the URL is misleading - some people may misunderstand and think it is a using version 1.&lt;br/&gt;
 Hence: Instead of &lt;tt&gt;/.rest/delivery/tours/v1&lt;/tt&gt; use something like &lt;tt&gt;/.rest/ep&lt;/tt&gt; as we did for all the other examples.&lt;/li&gt;
&lt;/ol&gt;


&lt;ol&gt;
	&lt;li&gt;I also would add a note that using &lt;tt&gt;q&lt;/tt&gt; instead of a distinct property such as &lt;tt&gt;body&lt;/tt&gt; (or &lt;tt&gt;body_de&lt;/tt&gt;) eases lang. specific search. An example query here could be
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
http:&lt;span class=&quot;code-comment&quot;&gt;//localhost:8080/magnoliaAuthor/.&lt;span class=&quot;code-keyword&quot;&gt;rest&lt;/span&gt;/ep-tours?q=Erleben&amp;amp;lang=de&lt;/span&gt;&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;p&gt;But yeah ... it is &lt;em&gt;not&lt;/em&gt; the same.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;
</comment>
                            <comment id="165045" author="mdrapela" created="Mon, 23 Jul 2018 09:11:56 +0200"  >&lt;p&gt;&lt;tt&gt;ep&lt;/tt&gt; point added, as well as the general &lt;tt&gt;q=&lt;/tt&gt; search hint, copied to DOCS56.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10160">
                    <name>Relates</name>
                                            <outwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="65030">MGNLREST-181</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </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, 18 Jul 2018 15:00:00 +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_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>mdrapela</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            5 years, 29 weeks, 6 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10020" key="com.atlassian.jira.toolkit:attachments">
                        <customfieldname>Number of attachments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10150" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname>Number of comments</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.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>mdrapela</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|y002m5:</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>
    <customfieldvalue id="761">Docu Sprint 54</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_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>