<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:12:58 UTC 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>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-15456] [Realm] Correct details on RQL page</title>
                <link>https://jira.mongodb.org/browse/DOCS-15456</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;Reading though the page on the Realm Query Language (&lt;a href=&quot;https://www.mongodb.com/docs/realm/reference/realm-query-language/),&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://www.mongodb.com/docs/realm/reference/realm-query-language/),&lt;/a&gt;&#160;I found a few missing and/or confusing parts:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;Arithmetic is supported in expressions but not mentioned anywhere.
	&lt;ul&gt;
		&lt;li&gt;see tests here for examples: &lt;a href=&quot;https://github.com/realm/realm-core/blob/master/test/test_parser.cpp#L5194-L5203&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/realm/realm-core/blob/master/test/test_parser.cpp#L5194-L5203&lt;/a&gt;&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;How do you do substitutions?
	&lt;ul&gt;
		&lt;li&gt;(NSPredicate uses &lt;tt&gt;%K&lt;/tt&gt; for keypaths, &lt;tt&gt;%@&lt;/tt&gt; for variables. Not clear what to do in RQL)&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;Subqueries section should be after Collection operators&lt;/li&gt;
	&lt;li&gt;Between should be written as &lt;tt&gt;between {a, b&lt;/tt&gt;}&#160;in the operator list&#160;(otherwise you have to hunt for an example to know how to actually define the range)&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;In general it is a bit confusing that this information is spread out over multiple pages. If you come from js, you will also hit into &lt;a href=&quot;https://www.mongodb.com/docs/realm/sdk/node/advanced/query-engine/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://www.mongodb.com/docs/realm/sdk/node/advanced/query-engine/&lt;/a&gt;&#160;and &lt;a href=&quot;https://www.mongodb.com/docs/realm/sdk/node/examples/read-and-write-data/#std-label-node-filter-queries&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://www.mongodb.com/docs/realm/sdk/node/examples/read-and-write-data/#std-label-node-filter-queries&lt;/a&gt;, both of which contains an incomplete subset of the information on the RQL page. It would be nice if they could be consolidated.&lt;/p&gt;</description>
                <environment></environment>
        <key id="2078748">DOCS-15456</key>
            <summary>[Realm] Correct details on RQL page</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="4" iconUrl="https://jira.mongodb.org/images/icons/priorities/minor.svg">Minor - P4</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="ben.p@mongodb.com">Ben Perlmutter</assignee>
                                    <reporter username="alexander.stigsen@mongodb.com">Alexander Stigsen</reporter>
                        <labels>
                    </labels>
                <created>Tue, 28 Jun 2022 16:41:30 +0000</created>
                <updated>Wed, 4 Jan 2023 17:04:38 +0000</updated>
                            <resolved>Tue, 12 Jul 2022 15:59:30 +0000</resolved>
                                                                    <component>Realm</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                <comments>
                            <comment id="4681867" author="JIRAUSER1262314" created="Fri, 15 Jul 2022 13:24:22 +0000"  >&lt;p&gt;thx for additional feedback and clarification on these operators. i&apos;m actually working on another ticket to expand RQL documentation, so will loop this feedback into that ticket, DOCSP-20137. &#160;&lt;/p&gt;</comment>
                            <comment id="4678859" author="alexander.stigsen" created="Thu, 14 Jul 2022 11:21:34 +0000"  >&lt;p&gt;Thanks. The changes look good.&lt;/p&gt;

&lt;p&gt;It is still missing putting the section about subqueries in a more appropriate location. Since it only works on collections, it should really be listed under the collection operators (also since ANY, ALL and NONE really are shortcuts for something that would otherwise be expressed as a subquery).&lt;/p&gt;

&lt;p&gt;Might also be worth adding a note about why you would use a subquery over the generic collection operators (if you need to match each object on multiple conditions, and/or specifically need the count).&lt;/p&gt;

&lt;p&gt;Users are often confused over the subtle difference between:&lt;/p&gt;

&lt;p&gt;&quot;ANY tasks.isComplete == false AND ANY tasks.assignee == &apos;Alex&apos;&quot;&lt;/p&gt;

&lt;p&gt;&quot;SUBQUERY(tasks, $task, $task.isComplete == false AND $task.assignee == &apos;Alex&apos;).@count &amp;gt; 0&quot;&lt;/p&gt;

&lt;p&gt;(the first will run as two separate conditions, so not ensuring that the matches are on the same object in the list)&lt;/p&gt;</comment>
                            <comment id="4673941" author="JIRAUSER1262314" created="Tue, 12 Jul 2022 15:59:30 +0000"  >&lt;p&gt;merged and deployed - &lt;a href=&quot;https://www.mongodb.com/docs/realm/realm-query-language/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://www.mongodb.com/docs/realm/realm-query-language/&lt;/a&gt;&#160;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                                                <inwardlinks description="is duplicated by">
                                                        </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                                        </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>3.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Tue, 12 Jul 2022 15:59:30 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        1 year, 29 weeks, 5 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10857" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>DOCSP-20136</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>jess.mokrzecki@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            1 year, 29 weeks, 5 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>alexander.stigsen@mongodb.com</customfieldvalue>
            <customfieldvalue>ben.p@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|i10c3j:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr1rye:i</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10555" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|i0zy8v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>