Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

When file attachments are enabled, your users will be allowed to attach files and screenshots to JIRA issues. This requires space on the server for storing the attachments.
(warning) Attachments are not stored in JIRA's database and so will need to be backed up separately.

File attachments are enabled by default. If you wish, you can configure the way JIRA handles attachments, or disable this feature altogether.

注意:

  • your users must also have the Create Attachments permissions to attach files to issues
  • to allow users to attach a file when creating a new issue, you need to ensure that the Attachment field is not hidden within the field configuration(s) associated with the specific issue type(s).

On this page:

添付の設定を行う

  1. Log in as a user with the JIRA System Administrators or JIRA Administrators global permission.
    (info) If you do not have the JIRA System Administrators global permission, you will not be able to enable or disable file attachments.
  2. Choose Administration at the top right of your screen. Then choose System > Advanced > Attachments (tab) to open the 'Attachment' page, which states whether attachments are on or off.
    (tick)Keyboard shortcut: g + g + start typing attachments
  3. Click the Edit Settings button, which opens the Edit Attachment Settings dialog box:
  4. In the Attachment Path field, choose the Use Default Directory option. If you see more attachment path options than what is shown in the screenshot above, please refer to the note below.
    (info) As mentioned above, if you have not logged in as a user with the JIRA System Administratorsglobal permission, then this option will not be available to you.
  5. 「添付ファイルのサイズ」フィールドで、添付ファイルの最大サイズを指定します。既定は 10485760 バイト (10 MB) です。 最大添付ファイルサイズは 2147483647 バイト (2 GB) です。
  6. (Optional) In the Enable Thumbnails field, ensure that ON is selected if you wish to display image file attachments as thumbnails (or miniature previews) when viewing an issue. When this setting is enabled, JIRA automatically creates thumbnails of the following types of image attachments:
    - GIF
    - JPEG
    - PNG
    Please refer to the info note below for more information about thumbnails. If you use Linux, please refer to the Linux note below.
  7. (Optional) In the Enable ZIP Support field, ensure that ON is selected if you wish to view the contents of zip files attached to an issue and allow all files attached to an issue to be downloaded as a single ZIP file.
  8. 更新ボタンをクリックして JIRA 添付設定を更新します。
    課題にファイルを添付するには、適切なユーザ、グループ、プロジェクトのロールに添付ファイル作成権限を関連するプロジェクトに割り当てる必要があります。
    ユーザーやグループ/プロジェクト ロールのメンバーが自信の添付ファイルを課題から削除できるようにするには、添付ファイル削除権限をこれらのプロジェクトに割り当てる必要があります。
    以下の場合、これ以上進める必要はありません。
    - 権限スキームが添付ファイル作成 (や添付ファイル削除) 権限を持ったプロジェクトに使用されている場合
    - プロジェクトがデフォルト権限スキームで構築されている場合
    これらの権限を設定したい場合、以下のセクションの手順に進みます。

添付ファイル作成／削除権限の設定

  1. Choose Administration at the top right of your screen. Then choose Issues > Permission Schemes to open the 'Permission Schemes' page, which displays a list of all permission schemes in your JIRA system and the projects which use each scheme.
    (tick)Keyboard shortcut: g + g + start typing permission schemes
  2. それぞれの関連のある権限スキームに対して:
    1. Click the Permissions link associated with the relevant permission scheme to edit that scheme's permissions.
    2. On the Edit Permissions page, locate Create Attachments within the Attachment Permissions section and click the Add link.
    3. In the user selection options on the right of the Add New Permission page, select the relevant (groups of) users or roles and then click the Add button.

      (tick) To allow these users or group/project role members to delete their own attachments, do not forget to assign them the Delete Own Attachments permission too.


(info) カスタム添付ファイルのパスを選択します：

  • If you upgraded JIRA with an XML backup from a JIRA version prior to 4.2 and used a custom directory for your attachment path, you can choose between using this custom directory (which cannot be edited) or the default directory for your attachment path location. However, once you switch to using the default directory, you can no longer choose the custom directory option.
  • The default directory location is the data/attachments subdirectory of the JIRA Home Directory.


(info) サムネイルに関する詳細情報：

  • You can configure the Issue Navigator column layout to display the thumbnails in an Images column.
  • すべてのサムネイル画像は、元の添付ファイルとともに attachments ディレクトリに JPEG 形式で保存されています。サムネイル画像は、ファイル名に "_thumb_" を加えた形式で表示されます。


(info) Linux上のサムネイル画像生成：

  • Your system must have X11 support. This web page details the minimum set of libraries needed to use JDK 1.4.2 under RedHat Linux 9.0.
  • 次の Java システム プロパティを設定する必要があります: -Djava.awt.headless=true

高度な設定

You can implement the following advanced configurations to modify the way JIRA handles attachments. However, these are not accessible through JIRA's attachment settings (above). One of these advanced configurations can be modified as an 'Advanced Setting' in JIRA's administration area, although the remaining two are implemented by defining properties in your jira-config.properties file.

添付ファイル サイズを設定する

デフォルトでは、サムネイルは200ピクセルの幅と200ピクセルの高さです。サムネイル画像の大きさを変更するには：

  1. Jira を停止します。
  2. Edit the jira-config.properties file in your JIRA Home Directory.
    (info) See Making changes to the jira-config.properties file for more information.
  3. 次のプロパティの値を編集します:
    • jira.thumbnail.maxwidth — thumbnail width in pixels

    • jira.thumbnail.maxheight — thumbnail height in pixels
      (info) If neither of these properties exist in your jira-config.propertiesfile, add them to the file. For example, specify the following for a thumbnails that are 100 pixels wide:

      jira.thumbnail.maxwidth = 100
  4. Delete all existing thumbnail images within the attachments directory (that is, those containing '_thumb_' in the filename).
  5. Jira を再起動します。

JIRAを再起動した後、すべてのサムネイルが自動的に新しい大きさで再作成されます。

ZIP形式のファイルのアクセシビリティを構成する

By default, JIRA allows you to access common ZIP-format files, with file extensions like '.zip' and '.jar' (Java archive files). However, there are numerous other ZIP-format files to which JIRA does not permit access by default. You can permit access to these files by doing the following:

  1. Jira を停止します。
  2. Edit the jira-config.properties file in your JIRA Home Directory.
    (info) See Making changes to the jira-config.properties file for more information.
  3. Remove the extensions from the jira.attachment.do.not.expand.as.zip.extensions.list property of the file types whose contents you wish to access in JIRA.
    (tick) If this property does not exist in your jira-config.properties file, add the name of this property, followed '=', followed by the content of the <default-value/> element copied from your JIRA installation's jpm.xml file. Then begin removing the exensions of file types whose contents you wish to access in JIRA.
  4. Jira を再起動します。

課題の ZIP 形式ファイルのコンテンツ表示されるファイルの数を設定

既定では、課題に添付できる ZIP ファイルの中身は最大で 30 ファイルになっています。最大値を変更するには:

  1. Access JIRA's Advanced Settings page. (See Configuring Advanced Settings for more information.)
  2. Edit the value of the jira.attachment.number.of.zip.entries property by clicking the existing value and specifying the maximum number of attachments you want to show on an issue.
  3. Click the Update button to save the new value in the JIRA database.



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.