As we have seen so far, JIRA uses fields such as summary and description to capture data. This works for most cases, but when you have complex data such as application log files or screenshots, fields become insufficient. This is where attachments come in. JIRA allows you to attach files to issues as support documents.
Attachments are saved as files on the JIRA file server and not in the database, so you need to ensure that there is sufficient disk space to accommodate the volume of attachments for now and future growth. As attachments are not stored in the database, JIRA will not backup the files as a part of its backup process. Attachments need to be backed up separately.
Attachments are enabled by default in JIRA, so users will be able to attach files to issues as soon as JIRA is installed. However, if it is disabled for some reason, you can re-enable it. Perform the following steps to enable attachments for JIRA:
On the Attachment Settings page, as shown in the following screenshot, there are a few options that you will need to configure when enabling attachments in JIRA:
The following table summarizes the configuration options:
Options |
Description |
---|---|
This specifies the location where attachments will be stored on the filesystem. The only options are the default directory, which is inside your | |
This specifies the maximum size of the attachment that users can upload. | |
This specifies whether or not to enable thumbnail generation when the attachment is an image. | |
This specifies whether or not to enable ZIP support, which allows users to download multiple attachments as a single ZIP file, and also view the contents of ZIP attachment files. |
Attachments are enabled and disabled globally across JIRA. You cannot selectively enable or disable attachment functions on a per project basis. You can, however, achieve a similar result by controlling the permission around who can attach files. Permissions are discussed in Chapter 8, Securing JIRA.
JIRA allows you to attach any arbitrary files to issues. These can be image files, Microsoft Office documents, and other binary files. Perform the following steps to attach a file to an issue:
Apart from letting you attach any files to an issue, JIRA also allows you to directly attach a screenshot from your system clipboard to issues. This saves you from having to take a screenshot, save it as a physical file on the disk, and finally attach it to JIRA.
Perform the following steps to attach a screenshot:
Just like attaching a file to JIRA, the same file name restriction applies to attaching a screenshot.