About the ONLYOFFICE and Jira integration
ONLYOFFICE offers an official connector to integrate ONLYOFFICE Docs with Jira Software to collaborate on office documents attached to your Jira issues. You can download it from the official Atlassian Marketplace or GitHub. The application is distributed under the Apache license.
Main features
- Creating new documents, spreadsheets, presentations, and forms.
- Viewing and editing text documents, spreadsheets, presentations, and forms using the Edit in ONLYOFFICE option.
To learn more about forms please read the corresponding articles for
creating and
filling out forms.
- Co-editing documents in real-time: two co-editing modes (Fast and Strict), Track Changes, comments, and a built-in chat.
- JWT support to secure your traffic so that no one can have access to your documents with the exception of the users with proper rights.
Start using ONLYOFFICE Docs within Jira
Creating, viewing and editing files
You can open the ONLYOFFICE editors from any Attachments block of an issue. This option is available for issues from any module where an issue can be opened, e.g., issue list, backlog, issues, etc.
To open an existing text document, spreadsheet, presentation, or form, move the mouse pointer over the necessary file and click the Edit in ONLYOFFICE icon. If the file format is not supported for editing, the View in ONLYOFFICE option is available. For the .oform files, the Fill in form in ONLYOFFICE option is available.
The file will be opened in a new browser tab in the corresponding ONLYOFFICE editor.
To create a new file using the ONLYOFFICE editors:
- In the Attachments block of an issue, click the Create file with ONLYOFFICE option.
- Choose the needed file type: Document, Spreadsheet, Presentation, or Form template.
- Type in the file name and click Create.
- The file will be opened in a new browser tab in the corresponding ONLYOFFICE editor.
Access permissions
Access permissions for files depend on a user's access rights to the corresponding issue.
Editing files. To be able to edit files, a user must have permissions for creating attachments (Create attachments
).
Viewing files. File preview in the ONLYOFFICE viewers is available for all users who can view an issue, but do not have permissions for editing the issue or permissions for creating attachments. If the file format is not supported for editing, the file will be opened for viewing.
Converting documents
To convert a document to the Office Open XML format:
- Move the mouse pointer over the necessary file and click the ONLYOFFICE conversion service icon.
- Optionally, you can change the file name.
- Click the Convert button.
- The converted file will be stored in the Attachments block.
Saving changes
The changes made to a file are saved to a new file with the same name as the original file, with a postfix added at the end of the file name, e.g. Sample-1.docx
.
The changes made to a file during the co-editing process are only saved to the first version of the file. If the document is being edited by several users simultaneously, the changes will be displayed only in the first file. Until the last user closes the editor, a new version of the file is not added to the issue.
Downloading files
To download a document in a different format:
- Move the mouse pointer over the necessary file and click the ONLYOFFICE conversion service icon.
- Optionally, you can change the file name.
- Select the necessary format from the Target type list.
- Click the Download button.
- The downloaded file will be stored on your computer.