添付ファイルの設定

ファイル添付が有効になっている場合、ユーザーは JIRA 課題にファイルやスクリーンショットを添付できます。これには、サーバー上に添付ファイルを保存する空き容量が必要です。

ファイル添付は既定で有効化されています。希望する場合、JIRA が添付ファイルを処理する方法を設定したり、この機能をまとめて無効にできます。(warning)添付ファイルは JIRA データベースには保存されません。そのため、別にバックアップする必要があります。注:

  • ユーザーが課題にファイルを添付するには、添付ファイルの作成権限が必要です。
  • 新しい課題の作成時にファイルの添付を許可するには、特定の課題タイプと関連付られたフィールド構成内で添付ファイルフィールド非表示になっていないことを確認する必要があります。
  • 次のすべての手順を行うには、 JIRA 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。

添付の設定を行う

  1. Choose  > System
  2. [詳細] > [添付ファイル] を選択すると、添付ファイルの有効 / 無効を示す "添付ファイル" ページが開きます。


  3. [設定の編集] ボタンをクリックして [添付の設定] ダイアログ ボックスを開きます:
  4. 添付ファイルパス」フィールドで、「既定ディレクトリを使用」オプションを選択します。上記のスクリーンショットよりも多くの添付ファイルオプションが表示された場合は、以下の注記を参照してください。
    (info)上記のように、JIRA システム管理者グローバル権限を持つユーザーとしてログインしていない場合、このオプションは利用できない可能性があります。
  5. [添付ファイルのサイズ] フィールドで、添付ファイルの最大サイズを指定します。既定 (ファイルあたり) は 10485760 バイト (10 MB) です。最大添付ファイル サイズ (ファイルあたり) は 2147483647 バイト (2 GB) です。
  6. (任意) サムネイルを有効 (Enable Thumbnails)のフィールドが、課題を参照した時に添付画像ファイルをサムネイルと表示したい場合は、ONが選択されていることを確認してください。この設定を有効にすると、JIRAは、自動的に画像の添付ファイルの次の種類のサムネイルを作成します。
    - GIF
    - JPEG
    - PNG
    サムネイルについての詳細は下の情報ノートをご覧ください。Linux をご利用の場合以下の Linux のノート をご覧ください。
  7. (オプション)課題に添付されている zip ファイルのコンテンツを表示し、課題に添付されているすべてのファイルを 1 つの zip ファイルとしてダウンロードすることを許可する場合は、「ZIP サポートの有効化」フィールドで、ON が選択されていること確認します。
  8. 更新ボタンをクリックして JIRA 添付設定を更新します。
    課題にファイルを添付するには、適切なユーザ、グループ、プロジェクトのロールに添付ファイル作成権限を関連するプロジェクトに割り当てる必要があります。
    ユーザーやグループ/プロジェクト ロールのメンバーが自信の添付ファイルを課題から削除できるようにするには、添付ファイル削除権限をこれらのプロジェクトに割り当てる必要があります。
    以下の場合、これ以上進める必要はありません。
    - 権限スキームが添付ファイル作成 (や添付ファイル削除) 権限を持ったプロジェクトに使用されている場合
    - プロジェクトがデフォルト権限スキームで構築されている場合
    これらの権限を設定したい場合、以下のセクションの手順に進みます。

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

  1. Choose  > Issues
  2. 権限スキーム を選択して、権限スキームページを開くと、使用中の JIRA システム内のすべての権限スキームと各スキームを使用するプロジェクトの一覧が表示されます。
  3. それぞれの関連のある権限スキームに対して:
    1. 対象のパーミッション スキームに関連する [パーミッション] リンクをクリックして、そのパーミッションを編集します。
    2. パーミッションの編集 (Edit Permissions) ページで、Attachment Permissions セクションにある添付を作成 (Create Attachements) の中にある添付ファイルのパーミッションに行き、追加 (Add) リンク をクリックします。
    3. [新しい権限の追加] ページの右側にあるユーザー選択オプションで、関連するユーザー、グループ、またはロールを選択し、[追加] ボタンをクリックします。

      (tick)ユーザーやグループ / プロジェクト ロールのメンバーが自身の添付ファイルを課題から削除できるようにするには、自分の添付ファイルを削除権限を割り当てる必要があります。

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

  • JIRA 4.2 以前のバージョンからXML バックアップし、添付ファイルのパスに自分で設定したディレクトリを使用している状態で JIRA をアップデートした場合、添付ファイルのパスにそのディレクトリを使う(変更はできません)か、既定ののディレクトリを使うか選ぶことができます。しかし、一度既定のディレクトリを使うことにすると、カスタムディレクトリを選択することができなくなります。
  • The default directory location is the data/attachments subdirectory of the JIRA home directory.
  • 既定のパスを変更するためには、新しいパスのシンボリックリンクを作成します。

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


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

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

  • ご利用のシステムが X11 をサポートしている必要があります。この web ページでは、RedHat Linux 9.0 で JDK 1.4.2 を使用するために必要なライブラリの最小設定を説明しています。
  • 次の 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. 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 — サムネイルの幅 (ピクセル単位)
    • jira.thumbnail.maxheight — サムネイルの高さ (ピクセル単位)
      (info) これらのプロパティが jira-config.properties ファイルに存在しない場合、それらをファイルに追加します。たとえば、幅が 100 ピクセルのサムネイルについては次のように指定します。

      jira.thumbnail.maxwidth = 100
  4. attachments ディレクトリ内の既存のすべてのサムネイル画像 (つまり、ファイル名に "_thumb_" が含まれるもの) を削除します。
  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 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 データベースに保存します。


最終更新日: 2019 年 2 月 22 日

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

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