<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:58:49 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-9647] Documentation on GridFS on arbitrary fields in the files collection incorrect</title>
                <link>https://jira.mongodb.org/browse/DOCS-9647</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;p&gt;Hello,&lt;/p&gt;

&lt;p&gt;There is a discrepancy between the GridFS spec and the MongoDB GridFS documentation.&lt;/p&gt;

&lt;p&gt;In the MongoDB &lt;a href=&quot;https://docs.mongodb.com/manual/core/gridfs/#gridfs-files-collection&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;GridFS doc&lt;/a&gt; doc it says:&lt;/p&gt;

&lt;p&gt;&quot;Applications may create additional arbitrary fields.&quot;&lt;/p&gt;

&lt;p&gt;In the &lt;a href=&quot;https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.rst&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;GridFS Spec&lt;/a&gt; it says:&lt;/p&gt;

&lt;p&gt;&quot;Note: some older versions of GridFS implementations allowed applications to add arbitrary fields to the files collection document at the root level. New implementations of GridFS will not allow this, but must be prepared to handle existing files collection documents that might have additional fields.&quot;&lt;/p&gt;

&lt;p&gt;I&apos;ve been told in HELP-3290 that the MongoDB documentation is wrong and that it needs to be updated to follow the spec.&lt;/p&gt;</description>
                <environment></environment>
        <key id="338597">DOCS-9647</key>
            <summary>Documentation on GridFS on arbitrary fields in the files collection incorrect</summary>
                <type id="3" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14718&amp;avatarType=issuetype">Task</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</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="steve.renaker@mongodb.com">Steve Renaker</assignee>
                                    <reporter username="roy.rim@mongodb.com">Roy Rim</reporter>
                        <labels>
                    </labels>
                <created>Tue, 13 Dec 2016 20:33:24 +0000</created>
                <updated>Tue, 22 Aug 2017 23:32:12 +0000</updated>
                            <resolved>Tue, 22 Aug 2017 18:23:23 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>4</watches>
                                                                                                                <comments>
                            <comment id="1638657" author="steve.renaker" created="Wed, 2 Aug 2017 14:36:23 +0000"  >&lt;p&gt;OK, I&apos;m going to change the existing doc to instruct users to put arbitrary fields into the metadata object and not even mention arbitrary fields at the top level of the document, since it&apos;s a gray area and more likely to confuse than to clarify.&lt;/p&gt;</comment>
                            <comment id="1638160" author="behackett" created="Tue, 1 Aug 2017 22:40:26 +0000"  >&lt;p&gt;That HELP ticket is specifically about the legacy GridFS API in the Java driver. Part of the reason we did a spec for this is that each driver had a completely different API for GridFS. Hence something you try that works in the legacy API of one driver may not be supported in the legacy API of another driver.&lt;/p&gt;</comment>
                            <comment id="1638153" author="behackett" created="Tue, 1 Aug 2017 22:38:04 +0000"  >&lt;p&gt;Since GridFS is entirely a client side feature, the server docs should match the behavior defined by the driver spec.&lt;/p&gt;</comment>
                            <comment id="1637897" author="steve.renaker" created="Tue, 1 Aug 2017 19:26:43 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=behackett&quot; class=&quot;user-hover&quot; rel=&quot;behackett&quot;&gt;behackett&lt;/a&gt; Hi Bernie, would you like to weigh in on this? Apparently the drivers will allow users to add arbitrary fields to GridFS documents, but we&apos;re trying to encourage them to confine arbitrary fields to the &quot;metadata&quot; field. How should I handle this in the GridFS documentation?&lt;/p&gt;</comment>
                            <comment id="1637673" author="roy.rim" created="Tue, 1 Aug 2017 16:42:44 +0000"  >&lt;p&gt;Hey &lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=steve.renaker&quot; class=&quot;user-hover&quot; rel=&quot;steve.renaker&quot;&gt;steve.renaker&lt;/a&gt; I think that would be ok but I wonder what the driver team thinks. They may want us to actively guide customers away from doing things the old way since it will be removed at some point.&lt;/p&gt;</comment>
                            <comment id="1637515" author="steve.renaker" created="Tue, 1 Aug 2017 14:56:25 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=roy.rim&quot; class=&quot;user-hover&quot; rel=&quot;roy.rim&quot;&gt;roy.rim&lt;/a&gt; Then what I&apos;ll say in the docs is that arbitrary fields SHOULD go in the metadata field, but not that they are not allowed elsewhere at all. OK?&lt;/p&gt;</comment>
                            <comment id="1632806" author="roy.rim" created="Wed, 26 Jul 2017 21:18:29 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=steve.renaker&quot; class=&quot;user-hover&quot; rel=&quot;steve.renaker&quot;&gt;steve.renaker&lt;/a&gt; according to this comment on my help ticket arbitrary fields are meant to go in the metadata field going forward.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/browse/HELP-3290?focusedCommentId=1456802&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-1456802&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;https://jira.mongodb.org/browse/HELP-3290?focusedCommentId=1456802&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-1456802&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="1631449" author="steve.renaker" created="Tue, 25 Jul 2017 18:10:50 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=roy.rim&quot; class=&quot;user-hover&quot; rel=&quot;roy.rim&quot;&gt;roy.rim&lt;/a&gt; Hi Roy, I haven&apos;t been able to confirm this myself. I used pymongo version 3.2 to add arbitrary fields to a GridFS collection with mongod 3.4:&lt;/p&gt;

&lt;p&gt;&amp;gt;&amp;gt;&amp;gt; a = fs.put(b&quot;hello world&quot;, bar=&quot;baz&quot;)&lt;/p&gt;

{
	&quot;_id&quot; : ObjectId(&quot;5977835ce550eb1a233deafa&quot;),
	&quot;bar&quot; : &quot;baz&quot;,
	&quot;chunkSize&quot; : 261120,
	&quot;length&quot; : 11,
	&quot;uploadDate&quot; : ISODate(&quot;2017-07-25T17:43:56.461Z&quot;),
	&quot;md5&quot; : &quot;5eb63bbbe01eeed093cb22bb8f5acdc3&quot;
}

&lt;p&gt;Am I using the wrong environment for testing here? Thanks,&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>8.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_13552" key="com.go2group.jira.plugin.crm:crm_generic_field">
                        <customfieldname>Case</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[[500A000000VpUFnIAN]]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Tue, 24 Jan 2017 16:58:14 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        6 years, 28 weeks 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_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>
                            6 years, 28 weeks ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>bernie@mongodb.com</customfieldvalue>
            <customfieldvalue>roy.rim@mongodb.com</customfieldvalue>
            <customfieldvalue>steve.renaker@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrm9g7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hsqksn:</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_10557" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue id="1324">KANBAN BUCKET</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|hrzk27:</customfieldvalue>

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