<!-- 
RSS generated by JIRA (9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b) at Mon Feb 12 09:34:17 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>[MGNLUI-6215] DOC: Restructure uploadField documentation</title>
                <link>https://jira.magnolia-cms.com/browse/MGNLUI-6215</link>
                <project id="10625" key="MGNLUI">Magnolia UI</project>
                    <description>&lt;ul&gt;
	&lt;li&gt;Using &lt;tt&gt;uploadField&lt;/tt&gt; to upload a file directly to an app&apos;s workspace has drawbacks. We decided to call it bad practice and point to the fact using an @MgnlDeprecated annotation in the classes. We should document this at&#160;&lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&lt;/a&gt;. Reasons why it is bad practice:
	&lt;ul&gt;
		&lt;li&gt;It does not centralize &quot;assets&quot; to a single &quot;asset&quot; workspace, which can be problematic if you want to migrate data to an external DAM.&lt;/li&gt;
		&lt;li&gt;Exports with binaries throw an exception unless configured to XML exports.&lt;/li&gt;
		&lt;li&gt;Binaries increase the space needed by a workspace.&lt;/li&gt;
		&lt;li&gt;Indexing, backup/restore, publishing, difficulties in manipulation (thumbnails, scaling and other operations to be applied).&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;Add information to the&#160;&lt;tt&gt;uploadField&lt;/tt&gt; page&#160;about best practice (advise to avoid using this field and to use &lt;tt&gt;linkField&lt;/tt&gt; instead. This is already mentioned in the &lt;tt&gt;damUploadField&lt;/tt&gt; page). We should keep the &lt;tt&gt;uploadField&lt;/tt&gt; page in DOCS62, mark it as deprecated and mention that it is not good practice to use the field.&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;damUploadField&lt;/tt&gt; makes only sense in the context of the Assets app. Details about it should probably be mentioned in the Assets app page instead. So it would be best to move the content there and delete the &lt;tt&gt;damUploadField&lt;/tt&gt; page altogether to avoid suggesting that the field can be used generically in other contexts. The example should be removed too.&lt;/li&gt;
	&lt;li&gt;While &lt;tt&gt;damUploadField&lt;/tt&gt; is not deprecated, it is no longer annotated as a field type. Both&#160;&lt;tt&gt;UploadFieldDefinition&lt;/tt&gt; and&#160;&lt;tt&gt;UploadViewDefinition&lt;/tt&gt;&#160;are now deprecated.&lt;/li&gt;
	&lt;li&gt;Delete both&#160;&lt;tt&gt;uploadField&lt;/tt&gt; and&#160;&lt;tt&gt;damUploadField&lt;/tt&gt; and their fully qualified class names&#160;from &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Field+definition#Fielddefinition-Fieldtypes&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Field+definition#Fielddefinition-Fieldtypes&lt;/a&gt;.&lt;/li&gt;
	&lt;li&gt;Introduce &lt;tt&gt;UploadViewDefinition&lt;/tt&gt; docs based on &lt;a href=&quot;https://jira.magnolia-cms.com/browse/MGNLUI-5656?focusedCommentId=210839&amp;amp;page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-210839&quot; class=&quot;external-link&quot; rel=&quot;nofollow&quot;&gt;this comment&lt;/a&gt;:
	&lt;ul&gt;
		&lt;li&gt;Won&apos;t address, see reason in comments below.&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;
</description>
                <environment></environment>
        <key id="90619">MGNLUI-6215</key>
            <summary>DOC: Restructure uploadField documentation</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="akhamis">Ashraf Khamis</assignee>
                                    <reporter username="sdemocko">&#352;imon Demo&#269;ko</reporter>
                        <labels>
                            <label>fields</label>
                            <label>new-UI-framework</label>
                            <label>new-form</label>
                    </labels>
                <created>Wed, 16 Sep 2020 15:59:49 +0200</created>
                <updated>Tue, 18 Jan 2022 17:49:04 +0100</updated>
                            <resolved>Wed, 18 Nov 2020 13:26:19 +0100</resolved>
                                    <version>6.2.4</version>
                                                        <due></due>
                            <votes>0</votes>
                                    <watches>3</watches>
                                                                                                                <comments>
                            <comment id="232884" author="sdemocko" created="Thu, 17 Sep 2020 11:15:58 +0200"  >&lt;p&gt;&lt;del&gt;Note to self: Might need to add an example to deprecated Upload Field, that if they want to use it they need to specify class: UploadViewDefinition, b/c uploadField type points to the UploadFieldDefinition and if anyone still would use the UF even tho it&apos;s not recommended, they need to use the UVD.&lt;/del&gt;&#160;&lt;/p&gt;

&lt;p&gt;Outdated info. We don&apos;t want users to use Upload Fields at all but rather link fields pointing to asset app. This has been documented here &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&lt;/a&gt;&#160;UploadViewDefinition is deprecated externally but we do use it internally correctly.&lt;/p&gt;</comment>
                            <comment id="240594" author="sdemocko" created="Wed, 18 Nov 2020 09:58:22 +0100"  >&lt;p&gt;The UploadViewDefinition was introduced, originally inteded for user purposes as well, but as per above comment, now only intended for internal use only. For this reason, we&apos;re not documenting anything about it in docs. This cancels out the need to address the last point in description.&lt;/p&gt;</comment>
                            <comment id="240630" author="akhamis" created="Wed, 18 Nov 2020 11:20:22 +0100"  >&lt;ul&gt;
	&lt;li&gt;Added a deprecation note to &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Upload+field&lt;/a&gt;&#160;(warning against its use and pointing to the link field instead) and moved the page to the &lt;b&gt;Magnolia 5 UI documentation&lt;/b&gt; tree.&lt;/li&gt;
	&lt;li&gt;Moved all info on the DAM upload field to &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Magnolia+Assets+subapp&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Magnolia+Assets+subapp&lt;/a&gt;&#160;(warning against using the field in any other context) and deleted the original page.&lt;/li&gt;
	&lt;li&gt;Fixed dead links at &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/DAM+upload+field+-+5+UI&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/DAM+upload+field+-+5+UI&lt;/a&gt;.&lt;/li&gt;
	&lt;li&gt;Deleted &lt;tt&gt;uploadField&lt;/tt&gt; and &lt;tt&gt;damUploadField&lt;/tt&gt; from &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Field+definition#Fielddefinition-Fieldtypes&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Field+definition#Fielddefinition-Fieldtypes&lt;/a&gt;.&lt;/li&gt;
	&lt;li&gt;Added a&#160;&lt;b&gt;Deprecated upload field&lt;/b&gt; section to &lt;a href=&quot;https://documentation.magnolia-cms.com/display/DOCS62/Release+notes+for+Magnolia+CMS+6.2.4&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://documentation.magnolia-cms.com/display/DOCS62/Release+notes+for+Magnolia+CMS+6.2.4&lt;/a&gt;.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;Reviewed by&#160;&#352;imon and Roman.&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10160">
                    <name>Relates</name>
                                                                <inwardlinks description="relates to">
                                        <issuelink>
            <issuekey id="106728">MGNLUI-7017</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10050">
                    <name>documentation</name>
                                            <outwardlinks description="documents">
                                        <issuelink>
            <issuekey id="90318">MGNLDAM-880</issuekey>
        </issuelink>
            <issuelink>
            <issuekey id="86965">MGNLUI-5886</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 Nov 2020 11:20:22 +0100</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_10246" key="com.pyxis.greenhopper.jira:gh-epic-link">
                        <customfieldname>Epic Link</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>MGNLUI-4966</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>mgeljic</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_13136" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            3 years, 12 weeks, 4 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>akhamis</customfieldvalue>
            <customfieldvalue>sdemocko</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10833" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|y03gha:</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="1304">UI FW 14</customfieldvalue>
    <customfieldvalue id="1317">UI FW 15</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                            <customfield id="customfield_10242" key="com.atlassian.jira.plugin.system.customfieldtypes:float">
                        <customfieldname>Story Points</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</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>
                                                                                                                                                                                                            <customfield id="customfield_13933" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Urgency (resolution)</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="15724"><![CDATA[Normal]]></customfieldvalue>

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