helpcenter/Web/Controls/Help/GettingStarted/Integration/Redmine/RedmineGettingStarted.ascx
svetlana maleeva 1d145f3dbf Merge branch 'feature/Docs-Cloud' into develop
# Conflicts:
#	Web/Controls/Help/GettingStarted/Integration/Jira/GettingStartedJira.ascx
#	Web/Controls/Help/GettingStarted/Integration/Redmine/RedmineGettingStarted.ascx
2022-12-14 12:57:20 +03:00

355 lines
29 KiB
Plaintext
Raw Blame History

<%@ Control Language="C#" Inherits="BaseContentUserControls"%>
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
<%@ Register TagPrefix="cc" TagName="LinuxVersionTag" Src="~/Controls/Help/Tags/linux-version/linux-version.ascx" %>
<script runat="server">
protected override void Init()
{
PageTitle = PageCaption = "Integration. Getting Started. Redmine";
MetaKeyWords = "integration, connector, online editing, redmine, edit, share, store";
MetaDescription = "Integrate ONLYOFFICE with Redmine collaboration software";
var guides = new GuidesModel();
(Page as BasePage).Guides = guides;
}
</script>
<div class="MainHelpCenter GettingStarted">
<ul class="TableOfContents">
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Overview_block")%>">About the ONLYOFFICE and Redmine integration</a>
<ul class="TableOfContentsSub">
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#MainFeatures_block")%>">Main features</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#SupportedFormats_block")%>">Supported formats</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Whatsnew_block")%>">What's new</a></li>
</ul>
</li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#OnlineEditorsIntegration_block")%>">Connecting ONLYOFFICE Docs to Redmine</a>
<ul class="TableOfContentsSub">
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Requirements_block")%>">Requirements</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Install_block")%>">Installing the ONLYOFFICE connector for Redmine</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Configure_block")%>">Configuring the ONLYOFFICE connector for Redmine</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#JWT_block")%>">Enabling JWT for the ONLYOFFICE and Redmine integration</a></li>
<li><a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#Demo_block")%>">Connecting to the demo ONLYOFFICE Docs</a></li>
</ul>
</li>
<li>
<a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#StartUsing_block")%>">Start using ONLYOFFICE Docs within Redmine</a>
</li>
</ul>
<div class="keyword_block">
<ul>
<li><cc:localizecontent runat="Server" controlname="~/Controls/Help/Tags/integrate-redmine/integrate-redmine.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/collaborative-editing/collaborative-editing.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/docker-version/docker-version.ascx" /></li>
<li><cc:LinuxVersionTag ID="LinuxVersionTag1" runat="server" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/local-server/local-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/document-server/document-server.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/open-source-version/open-source-version.ascx" /></li>
<li><cc:LocalizeContent runat="Server" ControlName="~/Controls/Help/Tags/install-onlyoffice/install-onlyoffice.ascx" /></li>
</ul>
</div>
<div class="gs_content" id="Overview_block">
<h2>About the ONLYOFFICE and Redmine integration</h2>
<div class="PortalHelp">
<p>ONLYOFFICE offers an official connector to integrate ONLYOFFICE Docs with <a href="https://www.redmine.org/" target="_blank">Redmine</a> to collaborate on office documents attached to the following Redmine modules: Issues, Files, Documents, Wiki, and News. You can download the ONLYOFFICE connector from the<68>Redmine <a href="https://www.redmine.org/plugins/onlyoffice_redmine" target="_blank"><b>Marketplace</b></a> or the ONLYOFFICE <a href="https://github.com/ONLYOFFICE/onlyoffice-redmine" target="_blank"><b>GitHub page</b></a>. The application is distributed under the Apache license.</p>
<%--<div class="notehelp">
<p>To learn more about how the ONLYOFFICE connector for Redmine works, please visit our <a href="https://api.onlyoffice.com/editors/redmine" target="_blank"><b>API documentation</b></a>.</p>
</div>--%>
<div class="gs_content gs_submenu" id="MainFeatures_block">
<h3>Main features</h3>
<p> </p>
<ul>
<li>Viewing and editing text documents, spreadsheets, and presentations from the Redmine modules depending on the user access rights.</li>
<li>Creating and filling out online forms.</li>
<li>Co-editing documents in real-time: two co-editing modes (Fast and Strict), Track Changes, comments, and a built-in chat.</li>
<li><b>JWT support</b> to secure your traffic so that no one, besides the users with proper rights, can have access to your documents.</li>
</ul>
</div>
<div class="gs_content gs_submenu" id="SupportedFormats_block">
<h3>Supported formats</h3>
<p> </p>
<ul>
<li>For creating and editing: DOCX, DOCXF, PPTX, XLSX</li>
<li>For filling forms: OFORM</li>
<li>For viewing: DOC, DOCX, DOCM, DOT, DOTX, DOTM, ODT, FODT, OTT, RTF, TXT, HTML, HTM, MHT, XML, PDF, DJVU, FB2, EPUB, XPS, XLS, XLSX, XLSM, XLT, XLTX, XLTM, ODS, FODS, OTS, CSV, PPS, PPSX, PPSM, PPT, PPTX, PPTM, POT, POTX, POTM, ODP, FODP, OTP.</li>
</ul>
</div>
<div class="gs_content gs_submenu" id="Whatsnew_block">
<h3>What's new in version 2.0.0</h3>
<p>Added</p>
<ul>
<li>Documents conversion.</li>
<li>Connection to a demo document server.</li>
<li>Advanced server settings for specifying internal addresses.</li>
<li>Settings validation.</li>
<li>Ignoring self-signed certificates.</li>
</ul>
<p>Fixed</p>
<ul>
<li>Issues with permissions.</li>
</ul>
<p>The full change log is available <a href="https://github.com/ONLYOFFICE/onlyoffice-redmine/blob/main/CHANGELOG.md" target="_blank"><b>here</b></a>.</p>
</div>
</div>
</div>
<div class="gs_content" id="OnlineEditorsIntegration_block">
<h2>Connecting ONLYOFFICE Docs to Redmine</h2>
<div class="gs_content gs_submenu" id="Requirements_block">
<h3>Requirements</h3>
<p> </p>
<ul>
<li>ONLYOFFICE Docs version 6.4 and later
<p>You need an instance of ONLYOFFICE Docs that is resolvable and connectable both from Redmine and any end clients. It must be able to POST to Redmine directly.</p>
<div class="notehelp">
Please refer to the official <a href="https://helpcenter.onlyoffice.com/installation/docs-index.aspx" target="_blank"><b>documentation page</b></a> to learn more about installing ONLYOFFICE Docs.
</div>
<p>You can also use <a href="<%=VirtualPathUtility.ToAbsolute("~/installation/docs-cloud-index.aspx")%>"><b>ONLYOFFICE Docs Cloud</b></a> (SaaS version).</p>
</li>
<li>Redmine v4.0.0 - v5.0.x. If you're new to Redmine, install it following these <a href="https://www.redmine.org/projects/redmine/wiki/RedmineInstall" target="_blank">instructions</a>.</li>
<li>ONLYOFFICE connector v2.0.0 for Redmine</li>
</ul>
</div>
<div class="gs_content gs_submenu" id="Install_block">
<h3>Installing the ONLYOFFICE connector for Redmine</h3>
<div class="PortalHelp">
<ol>
<li>Download the ONLYOFFICE integration plugin for Redmine. There are several ways to do that:
<ol type="a">
<li>Download the latest archived version from the Redmine <a href="https://www.redmine.org/plugins/onlyoffice_redmine" target="_blank"><b>Marketplace</b></a>.</li>
<li>Download the latest archived version from the ONLYOFFICE <a href="https://github.com/ONLYOFFICE/onlyoffice-redmine" target="_blank"><b>GitHub page</b></a>:
<pre><code>wget https://github.com/ONLYOFFICE/onlyoffice-redmine/archive/refs/tags/vX.X.X.tar.gz</code></pre>
<p>Where vX.X.X is the necessary connector version.</p>
<p>Unzip the archive:</p>
<pre><code>tar -xvzf vX.X.X.tar.gz</code></pre>
</li>
<li>Clone the master branch:
<pre><code>git clone https://github.com/ONLYOFFICE/onlyoffice-redmine</code></pre>
</li>
</ol>
<div class="notehelp">The plugin sub-directory must be named as <b>onlyoffice_redmine</b>. Rename the cloned <b>onlyoffice-redmine</b> or unzipped <b>onlyoffice_redmine-X.X.X</b> folder to <b>onlyoffice_redmine</b>.
<pre><code>mv onlyoffice-redmine onlyoffice_redmine
mv onlyoffice-redmine-X.X.X onlyoffice_redmine</code></pre>
</div>
<p>Before installing the plugin, make sure that the Redmine instance is stopped.</p>
</li>
<li>Put the <b>onlyoffice_redmine</b> plugin directory into the <b>plugins</b> directory, e.g:
<pre><code>cp -r /root/onlyoffice_redmine/. /redmine/plugins/onlyoffice_redmine</code></pre>
<div class="notehelp">The path to the <b>plugins</b> directory may differ depending on your Redmine installation options. You can use the <code>find / -type d -name plugins</code> command to find the path.
</div>
</li>
<li>Go to the Redmine<6E>s root directory:
<pre><code>cd redmine</code></pre>
</li>
<li>Install dependencies:
<pre><code>bundle install</code></pre>
</li>
<li>Initialize/Update the database:
<pre><code>RAILS_ENV=production bundle exec rake db:migrate</code></pre>
<pre><code>RAILS_ENV=production bundle exec rake redmine:plugins:migrate NAME=onlyoffice_redmine</code></pre>
</li>
<li>Restart the Redmine instance.</li>
</ol>
</div>
</div>
<div class="gs_content gs_submenu" id="Configure_block">
<h3>Configuring the ONLYOFFICE connector for Redmine</h3>
<div class="PortalHelp">
<p>Go to the <b>Administration</b> panel -> <b>Plugins</b>, find the ONLYOFFICE integration plugin for Redmine and click <b>Configure</b>. Specify the following parameters:</p>
<ul>
<li><b>Document Editing Service address</b> - enter the URL address and port where ONLYOFFICE Docs is installed (e.g.<2E><code>https://documentserver:8080</code>). This field is obligatory.
<div class="notehelp nh_important"><span class="important_notice_label">Important</span>The address of ONLYOFFICE Docs must be accessible from Redmine, as well as the address of Redmine must be accessible from ONLYOFFICE Docs.</div>
</li>
<li>The<68><b>Advanced server settings</b><3E>section can be used if your network configuration does not allow for requests between the installed Redmine and ONLYOFFICE Docs using the public addresses. In this case, specify addresses for internal requests in the corresponding fields:
<ul>
<li><b>ONLYOFFICE Docs address for internal requests from the server</b> - specify the address that is used to access Document Editing Service from Redmine.</li>
<li><b>Server address for internal requests from ONLYOFFICE Docs</b> - specify the address that is used to access Redmine from Document Editing Service.</li>
</ul>
</li>
<li><b>Secret key</b> - specify the secret used to sign the data.
<div class="notehelp">Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to enable it on the Redmine side as well: find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings. For more details, see the <a href="<%=VirtualPathUtility.ToAbsolute("~/integration/gettingstarted-redmine.aspx#JWT_block")%>">Enabling JWT for the ONLYOFFICE and Redmine integration</a> section of this article.</div>
</li>
<li><b>Disable certificate verification (insecure)</b> - check this box to disable the certificate verification and allow Redmine to establish connection with ONLYOFFICE Docs if you are using a self-signed certificate for your ONLYOFFICE Docs (otherwise, Redmine will not validate a self-signed certificate and will not allow for connection to/from ONLYOFFICE Docs). This is an insecure solution, and we strongly recommend that you replace the certificate with the one issued by some CA.</li>
<li>Check the following customization settings if necessary:
<ul>
<li>Display the Chat menu button.</li>
<li>Display the header in a more compact way.</li>
<li>Display the Feedback & Support menu button.</li>
<li>Display the Help menu button.</li>
<li>Display the monochrome toolbar header.</li>
</ul>
</li>
</ul>
<p>Click the <b>Apply</b> button at the bottom to save changes.</p>
<div class="screen_block">
<img alt="ONLYOFFICE_configure" target="ONLYOFFICE_configure_1" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/config.png")%>" />
<img alt="ONLYOFFICE_configure" id="ONLYOFFICE_configure_1" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/config.png")%>" />
<div target="ONLYOFFICE_configure_1" class="screenphoto magnifier"></div>
</div>
</div>
</div>
<div class="gs_content gs_submenu" id="JWT_block">
<h3>Enabling JWT for the ONLYOFFICE and Redmine integration</h3>
<p>To protect documents from unauthorized access, ONLYOFFICE editors use the JSON Web Token (JWT). The <b>token</b> is added in the configuration when the Document Editor is initialized and during the exchange of commands between inner ONLYOFFICE Docs services. The <b>secret key</b> is used to sign the JSON web token and validate the token upon the request to ONLYOFFICE Docs.</p>
<p>Starting from ONLYOFFICE Docs <b>v7.2</b>, JWT is enabled by default and the secret key is generated automatically. You need to find your secret key in the ONLYOFFICE Docs configuration file, then specify the same secret key in the connector settings.</p>
<p><b>Step 1</b>: Find your secret key in the ONLYOFFICE Docs configuration file</p>
<ol>
<li>Open the local.json file with any available text editor.
<ul>
<li>For Linux - <code>/etc/onlyoffice/documentserver/local.json</code></li>
<li>For Windows - <code>%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json</code></li>
<li>For Docker <20> enter the ONLYOFFICE Docs container using the <code>docker exec -it &lt;containerID&gt; bash</code> command and open <code>/etc/onlyoffice/documentserver/local.json</code>
<p>Alternatively, you can use the following command to find the default secret key without opening local.json:</p>
<pre><code>sudo docker exec &lt;containerID&gt; /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'</code></pre>
</li>
</ul>
<p>The local.json file should look like this:</p>
<pre><code>{
"services": {
"CoAuthoring": {
"token": {
"enable": {
"request": {
"inbox": true,
"outbox": true
},
"browser": true
}
},
"secret": {
"inbox": {
"string": "yoursecret"
},
"outbox": {
"string": "yoursecret"
},
"session": {
"string": "yoursecret"
}
}
}
}
}
</code></pre>
</li>
<li>The <code>true</code> value is specified in three sections. It means that token validation is enabled.
<ul>
<li><code>services.CoAuthoring.token.enable.browser</code></li>
<li><code>services.CoAuthoring.token.enable.request.inbox</code></li>
<li><code>services.CoAuthoring.token.enable.request.outbox</code></li>
</ul>
</li>
<li>The automatically generated secret key is specified in three sections. You can replace the default secret value with your own secret key. The secret key must be the same in three sections.
<ul>
<li><code>services.CoAuthoring.secret.inbox.string</code></li>
<li><code>services.CoAuthoring.secret.outbox.string</code></li>
<li><code>services.CoAuthoring.secret.session.string</code></li>
</ul>
</li>
<li>If you make changes, save them and restart the services for the config changes to take effect.
<pre><code>supervisorctl restart all</code></pre>
</li>
</ol>
<p><b>Step2</b>: Specify the same secret key in the connector settings</p>
<p>In the connector settings, specify the same secret in the <b>Secret key</b> field and save the settings.</p>
</div>
<div class="gs_content gs_submenu" id="Demo_block">
<h3>Connecting to the demo ONLYOFFICE Docs</h3>
<p>Starting from <a href="https://github.com/ONLYOFFICE/onlyoffice-redmine/releases/tag/v2.0.0" target="_blank"><b>ONLYOFFICE connector version 2.0.0</b></a>, you can try the ONLYOFFICE online editors within Redmine without installing ONLYOFFICE Docs.</p>
<p>To turn the connection on, click the <b>Connect to demo ONLYOFFICE Document Server</b> checkbox and click the <b>Save</b> button.</p>
<div class="notehelp">This is a public test server that will be available during a 30-day period. Don<6F>t share your sensitive data there.</div>
</div>
</div>
<div class="gs_content" id="StartUsing_block">
<h2>Start using ONLYOFFICE Docs within Redmine</h2>
<div class="PortalHelp">
<div class="notehelp">
All file changes are saved in the original file.
</div>
<h3>Changing permissions</h3>
<p>Please note that available file actions (viewing or editing) for each particular module depend on the permissions of the user role. </p>
<p>Go to <b>Administration</b> -> <b>Roles and permissions</b>, choose the necessary role in the list, check/uncheck the necessary permissions and click <b>Save</b>.</p>
<p>You can refer to the official Redmine <a href="https://www.redmine.org/projects/redmine/wiki/RedmineRoles" target="_blank">documentation</a> for more details.</p>
<h3>Viewing and editing files</h3>
<h5>Issues module</h5>
<p>To open the files attached to issues or to issue comments in the corresponding editor, click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/icon.png")%>" /> <b>Edit in ONLYOFFICE</b> / <b>Open in ONLYOFFICE</b> button to the right of the file name.</p>
<p>The ability to edit documents is available for user roles with the <b>Edit issues</b> permission.</p>
<p>The ability to open files for viewing is available for user roles with the <b>View issues</b> permission.</p>
<div class="screen_block">
<img alt="Issues module" target="img_2" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/issues.png")%>" />
<img alt="Issues module" id="img_2" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/issues.png")%>" />
<div target="img_2" class="screenphoto magnifier"></div>
</div>
<h5>Files module</h5>
<p>Files are available for viewing only and exclusively to the users with <b>View files</b> or <b>Manage files</b> permissions. To open a file in the corresponding editor, click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/icon.png")%>" /> <b>Open in ONLYOFFICE</b> button to the right of the file name.</p>
<div class="screen_block">
<img alt="Issues module" target="img_3" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/files.png")%>" />
<img alt="Issues module" id="img_3" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/files.png")%>" />
<div target="img_3" class="screenphoto magnifier"></div>
</div>
<h5>Documents module</h5>
<p>To open files in the corresponding editor, click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/icon.png")%>" /> <b>Edit in ONLYOFFICE</b> / <b>Open in ONLYOFFICE</b> button to the right of the file name.</p>
<p>The ability to edit documents is available for user roles with the <b>Edit documents</b> permission.</p>
<p>The ability to open files for viewing is available for user roles with the <b>View documents</b> permission.</p>
<div class="screen_block">
<img alt="Issues module" target="img_4" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/documents.png")%>" />
<img alt="Issues module" id="img_4" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/documents.png")%>" />
<div target="img_4" class="screenphoto magnifier"></div>
</div>
<p>To create a form, click the <b>Create in ONLYOFFICE</b> link and choose the <b>Form Template</b> option.</p>
<div class="screen_block">
<img alt="create a form" target="img_5" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/form.png")%>" />
<img alt="create a form" id="img_5" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/form.png")%>" />
<div target="img_5" class="screenphoto magnifier"></div>
</div>
<p>Fill in the required fields and click <b>Create</b>.</p>
<div class="notehelp">To learn more about forms please read the corresponding articles for <a href="https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/UsageInstructions/CreateFillableForms.aspx">creating</a> and <a href="https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/UsageInstructions/FillingOutForm.aspx">filling out</a> forms.</div>
<h5>Wiki module</h5>
<p>To open files in the corresponding editor, click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/icon.png")%>" /> <b>Edit in ONLYOFFICE</b> / <b>Open in ONLYOFFICE</b> button to the right of the file name.</p>
<p>The ability to edit documents is available for user roles with the <b>Edit Wiki pages</b> permission.</p>
<p>The ability to open files for viewing is available for user roles with the <b>View Wiki</b> permission.</p>
<div class="screen_block">
<img alt="Issues module" target="img_6" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/wiki.png")%>" />
<img alt="Issues module" id="img_6" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/wiki.png")%>" />
<div target="img_6" class="screenphoto magnifier"></div>
</div>
<h5>News module</h5>
<p>To open files in the corresponding editor, click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/icon.png")%>" /> <b>Edit in ONLYOFFICE</b> / <b>Open in ONLYOFFICE</b> button to the right of the file name.</p>
<p>The ability to edit documents is available for user roles with the <b>Edit news</b> permission.</p>
<p>The ability to open files for viewing is available for user roles with the <b>View news</b> permission.</p>
<div class="screen_block">
<img alt="Issues module" target="img_7" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/news.png")%>" />
<img alt="Issues module" id="img_7" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/news.png")%>" />
<div target="img_7" class="screenphoto magnifier"></div>
</div>
<h3>Converting files</h3>
<p>The ability to convert files is available in the following Redmine modules: Issues, Documents, Wiki, and News.</p>
<div class="screen_block">
<img alt="Converting files" target="img_8" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/convert.png")%>" />
<img alt="Converting files" id="img_8" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/convert.png")%>" />
<div target="img_8" class="screenphoto magnifier"></div>
</div>
<p>Click the <img alt="ONLYOFFICE icon" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/converticon.png")%>" /> <b>Convert with ONLYOFFICE</b> button to the right of the file name.</p>
<p>Choose the necessary format from the list. Optionally, you can change the file name.</p>
<div class="screen_block">
<img alt="Converting files" target="img_9" class="screenphoto screen_guides" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/small/convert2.png")%>" />
<img alt="Converting files" id="img_9" class="bigphoto_screen" src="<%=VirtualPathUtility.ToAbsolute("~/images/help/GettingStarted/Integration/Redmine/big/convert2.png")%>" />
<div target="img_9" class="screenphoto magnifier"></div>
</div>
<p>Click the <b>Convert</b> button to save the converted file within the corresponding Redmine section. Click the <b>Download</b> button to save the converted file on your computer locally.</p>
</div>
</div>
</div>