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

Sub-task issues are generally used to split up a parent issue into a number of tasks which can be assigned and tracked separately. Splitting issues into smaller tasks often provides a better picture of the progress on the issue, and allows each person involved in resolving the issue to better understand what part of the process they are responsible for.

All the sub-tasks related to a parent issue are summarised on the parent issue's main screen (see "Working with Sub-Tasks" below). Sub-tasks always belong to the same project as their parent issue.

サブタスクのフィールドは、標準課題とまったく同じです。たとえば、要約、説明、報告者、担当者、ステータスなどです。サブタスクには、標準課題のタイプとは異なる課題タイプのセットがあるので注意してください。

Sub-tasks cannot have sub-tasks of their own. However, if you need to break up a sub-task into smaller sub-tasks, you could achieve this by first converting the sub-task to a standard issue (see below). You would then be able to create sub-tasks for it.

注意

Sub-tasks are only available if they have been enabled by your JIRA administrator. To create sub-tasks, you will also need to have the 'Create Issue' permission in the parent issue's project.

On this page:

サブタスクの作成

  1. Navigate to the issue which you would like to be the parent issue of the sub-task you are about to create.
  2. Select 'Create sub-task' from the 'Operations' menu on the left-hand side of the screen.
  3. The 'Step 1. Choose the project and issue type' screen will be displayed. Select the sub-task issue type (the default is 'Sub Task', but others may have been added by your JIRA administrator) and click the 'Next' button.
  4. The 'Step 2. Enter the details of the issue' screen will be displayed, similar to creating a standard issue. Type a summary for the sub-task and complete any other required fields, which are italicised and highlighted by an asterix.
    Note that there is no option to set security on a sub-task, as sub-tasks inherit their parent issue's security levels (if any have been set).
  5. Click the 'Create' button at the bottom of the page. The sub-task will be created and you will see the 'View Issue' screen, showing the sub-task's details that you have provided. The parent issue's summary and issue key are displayed above the sub-task's summary. You can easily return to the parent issue by clicking its summary or issue key.

    In the above screenshot, the new sub-task is DOVE-2 (Buy a dove) and its parent issue is DOVE-1 (Win 'homing dove' contest). Both belong to the Dove project.

サブタスクで作業する

If an issue has sub-tasks, then the issue screen will show a list of all the issue's sub-tasks:

  • The sub-task list has two views: 'All' and 'Open'. The All view lists all sub-tasks, regardless of status, while the Open view only shows sub-tasks that have not been resolved (i.e. do not have a Resolution ). You can switch views by clicking the 'All' and 'Open' links.
  • You can reorder sub-tasks by using the up and down arrows to, for example, organise the list in the order of intended execution or priority.
  • You can perform actions on the sub-tasks by clicking the 'Actions' link in the right-most column, then selecting an option from the drop-down list, e.g. 'Resolve Issue', 'Close Issue', 'Reopen Issue'.
  • Once an issue has one or more sub-tasks, you can quickly create additional sub-tasks by clicking the 'Add Sub-Task' link, typing a description in the 'Summary' field and clicking the 'Add' button. (The other sub-task fields are optional, although 'Issue Type' will default to 'Sub-task' and 'Assignee' will default to 'Unassigned'.)

Additionally, if your JIRA administrator has enabled time-tracking, coloured bars will be displayed showing the 'Original Estimate', 'Remaining Estimate' and 'Time Spent' for the issue and its sub-tasks.

サブタスクを検索する

When sub-tasks are enabled, two extra entries will appear in the 'Issue Type' drop-down list in the Issue Navigator's search form. These entries are: 'Standard Issue Types' and 'Sub-Task Issue Types'.

  • To search standard issues only, click the Standard Issue Types entry.
  • To search sub-task issues only, click Sub-Task Issue Types entry.
  • 課題またはサブタスク課題の特定の1つのタイプを検索するには、1つの課題タイプまたは1つのサブ課題タイプのみを選択します。

If no entries are selected from the Issue Type field then the search will return all the standard issues as well as sub-task issues that meet the rest of the search criteria.

The search results indicate sub-task issues by displaying the parent issue's issue key above the sub-task's summary, as shown below:

Adding the 'Sub-Tasks' column to your Issue Navigator

To add the 'Sub-Tasks' column to your Issue Navigator as shown in the above screenshot, please see Customising your Issue Navigator columns.

標準課題をサブタスクに変換する

  1. Navigate to the issue which you would like convert to a sub-task.
  2. Select 'Convert to sub-task' from the 'Operations' menu on the left-hand side.
  3. The 'Step 1. Select Parent Issue and Sub-Task Type' screen will be displayed:

    Type or select the appropriate parent issue type, select the new issue type (i.e. a sub-task issue type) and click the 'Next' button.
  4. If the issue's current status is not an allowed status for the new issue type, the 'Step 2. Select New Status' screen will be displayed. Select a new status and click the 'Next' button.
  5. The 'Step 3. Update Fields' screen will be displayed. If the new issue type requires any additional fields, you will be prompted to enter them. Otherwise you will see the message 'All fields will be updated automatically':

    Click the 'Next' button.
  6. The 'Step 4. Confirmation' screen will be displayed. If you are satisfied with the new details for the issue, click the 'Finish' button:
  7. The issue will be displayed. You will see that it is now a sub-task, that is, its parent's issue number is now displayed at the top of the screen (see 'Creating a sub-task' above).

サブタスクを標準課題に変換する

  1. Navigate to the sub-task issue which you would like convert to a standard issue.
  2. Select 'Convert to issue' from the 'Operations' menu on the left-hand side of the screen.
  3. The 'Step 1. Select Issue Type' screen will be displayed. Select a new issue type (i.e. a standard issue type) and click the 'Next' button.
  4. If the sub-task's current status is not an allowed status for the new issue type, the 'Step 2. Select New Status' screen will be displayed. Select a new status and click the 'Next' button.
  5. The 'Step 3. Update Fields' screen will be displayed. If the new issue type requires any additional fields, you will be prompted to enter them. Otherwise you will see the message 'All fields will be updated automatically':

    Click the 'Next' button.
  6. The 'Step 4. Confirmation' screen will be displayed. If you are satisfied with the new details for the issue, click the 'Finish' button:
  7. 課題が表示されます。親課題の番号が画面の上部に表示されなくなり、これがサブタスクではなくなったことがわかります。