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

Versions are points-in-time for a project. They help you schedule and organise your releases. Once a version is created, the following reports are useful:

The Change Log and Road Map reports are driven by the 'Fix For Version' field on each issue.

バージョンは以下のことが可能です。

  • 追加 - 課題を配置する新しいバージョンを作成する。
  • Released — mark a version as released. This changes the Road Map report, Change Log report and some issue fields' drop-downs.
  • スケジュール変更 - バージョンの順序を並び替える。
  • Archived — hide an old version from the Road Map and Change Log reports, and in the JIRA User Interface.
  • マージ - 複数のバージョンを一つにまとめる。

このページの内容

プロジェクトのバージョンを管理する

  1. Login to JIRA as a project administrator. (A project administrator is someone who has the project-specific permission 'Administer Project', but not necessarily the global permission 'JIRA Administrators'. )
  2. Click the 'Administration' link on the top bar.
  3. This will display the Administration page, showing a list of projects which you have permission to manage. Click the project of interest.
  4. You will now see a page displaying the project details. On this page all the configurable actions available on the project are easily accessible. On the lower right, a summary of the versions is displayed along with the link to the version management interface. The summary indicates the version status and the scheduled release date for that version.

    注意

    If you have created a new project and have not assigned a permission scheme with it on creation, then you will not see the above display. Instead under versions it will say "There are no versions at the moment".

  5.  Click the 'Manage' link to display the 'Manage Versions' screen, which shows a list of versions and each version's status. From here you can perform the operations described below.

バージョン ステータス

各バージョンは、次の 4 つのうち、いずれかのステータスを持ちます。

  • リリース済み - バンドルされたパッケージ
  • 未リリース -オープン パッケージ
  • アーカイブ済み - 半透明のパッケージ
  • Overdue — the release date is highlighted

    The status affects where the version appears in drop-down lists for version-related issue fields ('Fix For Version' and 'Affects Version').

Adding a new version

  1. The "Add New Version" form is located at the bottom of the 'Manage Versions' screen.
  2. From here, you enter the name for the version. The name is treated as a plain string by JIRA, so it can be simple numeric, e.g. "2.1", it can be complicated numeric, e.g. "2.1.3", or it can be something zany like the project's internal code-name, e.g. "Memphis".
  3. Optional details such as the version description and release date can be also be specified.
  4. It is also possible to 'schedule' the new version by selecting its position in the version list. The new version is added after the selected version - or it can be placed at the start of the list by selecting 'First'.
  5. Click on the "Add" button. The version management list is updated immediately, with the newly created version added in the specified position.

    注意

    At present, the version release date is only used to indicate the scheduled release date for a version. Currently JIRA only uses the release date for reporting purposes, but in future releases it is intended to add further functionality to take advantage of this data.

バージョンをリリースする

  1. On the 'Manage Versions' screen, click the 'Release' link available in the 'Operations' column for the version you are interested in.
  2. このバージョンを「修正」バージョンとする課題がある場合は、必要であれば、JIRA で「修正」バージョンを変更できます。変更の必要がなければ、これらの課題を修正することなく操作を完了します。
  3. This operation immediately updates the specific version as 'released' throughout JIRA.
  4. The version list indicates the version 'released' status with the bundled package icon. The 'Unrelease' operation replaces the 'Release' operation in the 'Operations' column.
  5. To un-release a version, simply click on the 'Unrelease' link in the 'Operations' column.

Archiving a version

  1. On the 'Manage Versions' screen, click the 'Archive' link available in the 'Operations' column for a version you are interested in.
  2. This operation immediately updates the specific version as 'archived' throughout JIRA.
  3. バージョン一覧で、半透明のアイコンはバージョンが「アーカイブ済み」ステータスであることを示しています。利用可能な操作一覧は、「アーカイブ解除」操作によって置き換えられます。アーカイブを解除しない限り、このバージョンにこれ以上変更を加えることはできません。また、課題の影響バージョンおよび修正バージョン フィールドから既存のアーカイブ済みバージョンを削除したり、新たなアーカイブ済みバージョンを追加したりできません。
  4. To un-archive a version, simply click on the 'Unarchive' link in the operations column.

Merging multiple versions

  1. On the 'Manage Versions' screen, click the 'Merge' link available in the 'Operations' column for a version you are interested in.
  2. This will take you to the 'Merge Versions' page.On this page are two select lists - both listing all un-archived versions. The specified version is highlighted in the 'Merging From Versions' select list on the left. It is possible to select further versions you wish to merge from. Versions selected on this list will be removed from the system. All issues associated with these versions will be updated to reflect the new version selected in the 'Merge To Version' select list on the right. It is only possible to select one version to merge to.
  3. Click on the 'Merge' button. You will be shown a confirmation Page. Click on 'Merge' to complete the operation.
  4. On completion of the merge operation, you are returned to the version management interface. The version list has been updated to reflect the changes that occurred in the merge operation.

Editing a version's details

  1. On the 'Manage Versions' screen, click the 'Edit Details' link available in the 'Operations' column for the version you are interested in.
  2. This will bring you to the "Edit Version: <Version>" page. Here, you can edit the version's Name, Description and Release Date:
  3. Click the 'Update' button to save your changes.
  4. On completion of the update operation, you are returned to the 'Manage Versions' screen — with an updated version list reflecting the changes made.
     

Deleting a version

  1. On the 'Manage Versions' screen, click the 'Delete' link in the 'Operations' column for the version you wish to delete.
  2. This will bring you to the "Delete Version: <Version>" confirmation page.
  3. From here, you can specify the actions to be taken for issues associated with the version to be deleted. You can either associate these issues with another version, or simply remove references to the version to be deleted.
  4. Click the "Delete" button.
  5. On completion of the deletion, you are returned to the 'Manage Versions' screen — with an updated version list reflecting the changes made.
     

Rescheduling a version

  1. On the 'Manage Versions' screen, re-scheduling operations are available through the 'Schedule' column.
  2. It is possible to move a version up/down a position or to the start/end of the list by clicking on the specific arrow icon associated with the specific version row.
  3. The version list is updated immediately with the selected version now occupying the specified position.