添付ファイルの設定

添付ファイルが有効になっている場合、ユーザーは Jira 課題にファイルやスクリーンショットを添付できます。 

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. Learn more about how attachments are stored .

 

Attachments are enabled by default. You can configure the way Jira handles attachments, or disable attachments altogether. If you use a custom permission scheme, you might need to update the permissions to allow users to add and remove attachments.

  • To allow users to attach a file when creating a new issue, ensure that the Attachment field is not hidden within the field configuration(s) associated with the specific issue type(s).
  • 次のすべての手順を行うには、Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。

添付ファイルの設定を編集する

  1. Choose   > System
  2. Select Advanced > Attachments.

  3. Click Edit Settings, which opens the Edit Attachment Settings dialog:

  4. 添付ファイルのサイズで、添付ファイルの最大サイズを指定します。既定は 10485760 バイト (10 MB) です。 最大添付ファイル サイズは 2147483647 バイト (2 GB) です。
  5. In Attachment Path, choose Use Default Directory. If you see more attachment path options than what is shown in the screenshot above, refer to the note below.

  6. (オプション) 画像添付ファイルを課題のサムネイルとして表示するには、サムネイルを有効化 で ON を選択します。この設定がオンになっている場合、Jira は次のファイルタイプのサムネイルを作成します。
    • gif
    • JPEG
    • PNG

    詳細については、これらのノートを参照してください。

  7. (オプション) ユーザーが ZIP 添付ファイルの内容をプレビューし、1 つの課題のすべての添付ファイルを 1 つの ZIP ファイルとしてダウンロードすることを許可するには、ZIP サポートを有効化で ON を選択します。
  8. [更新] をクリックします。

(info) Choosing a custom attachment path:

  • Jira 4.2 より前のバージョンの XML バックアップで Jira のバックアップを行い、添付ファイルのパスにカスタム ディレクトリを使用していた場合、添付ファイルのパスとして、そのディレクトリを使う (編集不可) か、既定のディレクトリを使うか選ぶことができます。ただし、既定のディレクトリに切り替えた場合、以降はカスタム ディレクトリを選択することはできません。
  • 既定ディレクトリの場所は、Jira ホーム ディレクトリdata/attachments サブディレクトリです。
  • 既定のパスを変更するためには、新しいパスのシンボリックリンクを作成します。
(info) サムネイルに関する詳細情報:

  • 課題ナビゲーターの列のレイアウトを設定し、Images 列にサムネイルを表示することができます。
  • すべてのサムネイル画像は元の添付ファイルとともに attachments ディレクトリ内に JPEG 形式で保存されます。サムネイル画像は、ファイル名に " _thumb_ " を加えた形式で表示されます。

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

  • ご利用のシステムが X11 をサポートしている必要があります。この Web ページ では、JDK 1.4.2 をRedHat Linux 9.0 で使用するために必要なライブラリの最小設定を説明します。
  • 次のように java のシステム プロパティを設定する必要があります: -Djava.awt.headless=true

添付ファイルの権限を編集する

プロジェクト権限スキームに 添付ファイルの作成 (および 自分の添付ファイルの削除) 権限がある場合や、プロジェクトが Jira に付属の 既定の権限スキームを使用している場合は、プロジェクト権限を更新する必要はありません。

カスタム権限スキームを使用する場合、ユーザーが次の権限を持っていることを確認してください。

  • 課題にファイルを添付するには、ユーザー、グループ、またはプロジェクトのロールが、関連するプロジェクトの添付ファイル作成権限が必要です。
  • 課題から自分の添付ファイルを削除するには、ユーザーはそのプロジェクトについて自分の添付ファイルを削除権限を持っている必要があります。

これらの権限を更新する必要がある場合は、以下の手順を実施して下さい。

  1. Choose   > Issues
  2. Select Permission Schemes. Jira lists all permission schemes in your Jira system and the projects that use each scheme.

  3. それぞれの関連のある権限スキームに対して:
    1. 更新するスキームの隣の [権限] をクリックします。権限と、それらが許可されているユーザーの一覧が表示されます。
    2. Next to Create Attachments, click Edit. The Grant permission dialog displays.
       
    3. [権限] フィールドで、[自分の添付ファイルの削除] を追加します。
    4. 付与で、権限を付与するユーザーを選択します。
    5. [許可] をクリックします。

高度な設定

次の詳細設定を実装し、Jira による添付ファイルの処理方法を変更できます。ただし、これらには Jira の添付ファイル設定からアクセスすることはできません。これらの詳細設定の 1 つは Jira の管理領域で "詳細設定" として変更できますが、残りの 2 つは jira-config.properties ファイルでプロパティを定義することで実装されます。

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

デフォルトでは、サムネイルは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 — サムネイルの幅 (ピクセル単位)
    • 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. attachments ディレクトリ内の既存のすべてのサムネイル画像 (つまり、ファイル名に "_thumb_" が含まれるもの) を削除します。
  5. Jira を再起動します。

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

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

既定では、Jira は ".zip" や ".jar" (Java アーカイブファイル) などの拡張子の付いた一般的な zip 形式ファイルへのアクセスを許可します。ただし、Jira が既定ではアクセスを許可していない、多数の zip 形式のファイルがあります。次の操作を実行して、これらのファイルへのアクセスを許可できます。

  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 extensions of file types whose contents you wish to access in Jira.
  4. Jira を再起動します。

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

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

  1. Jira の詳細設定ページに移動します (詳細については、「高度な Jira アプリケーション設定」を参照して下さい)。
  2. jira.attachment.number.of.zip.entries プロパティの既存の値をクリックし、課題に表示する添付ファイルの最大数を指定して、値を編集します。
  3. [更新] ボタンをクリックして、新しい値を Jira データベースに保存します。

最終更新日 2018 年 4 月 19 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.