Project

Profile

Help

Learn all about issues » History » Sprint/Milestone 22

Jan Schulz-Hofen, 04/02/2014 01:58 AM

1 2 Jan Schulz-Hofen
# Learn how to use issues
2 3 Jan Schulz-Hofen
3
Let's have a look at new issues and introduce the different fields you’ll encounter when creating one.
4
5
## Issue fields
6
7 4 Jan Schulz-Hofen
{{>toc}}
8
9 15 Jan Schulz-Hofen
Issues can be comprised of much more than their four required fields (tracker, subject, status and priority); in fact, there are a ton of useful fields that can really bring your Planio issues to life. Let’s explore them by walking through the process of creating a new issue.
10 1 Jan Schulz-Hofen
11 16 Jan Schulz-Hofen
*Please note that based on your role and the enabled modules in your project not all of the shown fields may be available.*
12 15 Jan Schulz-Hofen
13 8 Jan Schulz-Hofen
### The basics: tracker, private, subject, and description
14
15
![](basic_issue_fields.png)
16
17 10 Jan Schulz-Hofen
  - In the **Tracker** field, select the most appropriate issue tracker category (learn [[Create_a_custom_workflow_for_recurring_tasks|more about trackers here]]).
18 3 Jan Schulz-Hofen
  - In the **Private** field, select the check box to indicate that the issue is a private issue. Based on role permissions, a private issue will not be visible to other users, though they may see other issues within the same project.
19
  - In the **Subject** field, enter a brief yet meaningful subject title for the issue.
20 9 Jan Schulz-Hofen
  - In the **Description** field, describe the nature of the issue. You can use the formatting buttons at the top to add basic formatting. To learn more about Planio's default formatting language *Textile*, click the small **Help** icon.
21 8 Jan Schulz-Hofen
22 11 Jan Schulz-Hofen
### Planning and project related fields
23
24
![](project_management_fields.png)
25 8 Jan Schulz-Hofen
26 3 Jan Schulz-Hofen
  - In the **Status** field, select the current status of the new issue.
27
  - In the **Priority** field, select the relative importance of the issue in terms of its priority with other issues.
28 6 Jan Schulz-Hofen
  - In the **Assignee** field, select the person to whom the issue should be assigned. The assignee, like a watcher (see below), receives e-mail notifications when an update to the issue occurs.
29
  - In the **Category** field, select the relevant category for this issue. If you'd like to create a new category, click on the small + icon next to it.
30 1 Jan Schulz-Hofen
  - In the **Target milestone** field, select a milestone. Milestones will be displayed alongside their issues on the roadmap of your project. To create a new milestone, click on the + icon next to it.
31 6 Jan Schulz-Hofen
  - In the **Parent task** field, enter a task/issue number or enter keyword text of a task that is a parent to your task - Planio will actively display all tasks that match your text. Click the parent task when it appears.
32 7 Jan Schulz-Hofen
  - In the **Start date** field, enter the date when the issue should begin in `yyyy-mm-dd` format or click the icon to launch the mini-calendar.
33 1 Jan Schulz-Hofen
  - In the **Due date** field, enter the date when the issue is due in `yyyy-mm-dd` format or click the icon to launch the mini-calendar.
34 13 Jan Schulz-Hofen
  - In the **Estimated time** field, enter the number of hours to be allocated to the issue.
35 1 Jan Schulz-Hofen
  - In the **% Done** field, select the current percentile value of the issue’s completion rate.
36 16 Jan Schulz-Hofen
37
*Please note that if you don't have issue categories or milestones yet, the fields will not be shown. You can create them within your project **Settings**.*
38 12 Jan Schulz-Hofen
39 17 Jan Schulz-Hofen
### Customer related fields
40 1 Jan Schulz-Hofen
41 19 Jan Schulz-Hofen
Planio lets you work together with your customers even when they haven't got their own user account. If an issue is associated with a customer company and contact, you can optionally send issue updates to your customers via e-mail. Their response will automatically update the respective issue in Planio. Both companies and contacts can be managed in the **Customers** tab within your project.
42 17 Jan Schulz-Hofen
43 18 Jan Schulz-Hofen
![](customer_fields.png)
44
45 17 Jan Schulz-Hofen
  - In the **Customer company** field, enter the name of an existing company - Planio will actively display all companies that match the name. Click the company when it appears.
46 19 Jan Schulz-Hofen
  - In the **Customer contact** field, select the name of the contact within the company who is associated with the issue. 
47 20 Jan Schulz-Hofen
  - In the **Additional customer contacts** field, you can add additional contacts from within the customer company that should receive issue updates in CC. Simply enter names or e-mail addresses - Planio will select or create contacts automatically for you. You can add as many additional contacts as you like, to add a new line, simply click on **Add contact**.
48 12 Jan Schulz-Hofen
49 19 Jan Schulz-Hofen
### Files and watchers
50 12 Jan Schulz-Hofen
51 21 Jan Schulz-Hofen
![](files_and_watchers.png)
52
53
  - In the **Files** field, click **Choose Files** to launch the file upload tool. This field is used to attach files that are relevant to the issue. Alternatively, you can simply drag and drop files from your computer onto the issue form to attach them.
54
  - In the **Watchers** field, select the check box(es) to indicate other people within the project team who should be kept aware of the issue via e-mail notifications.
55
56
### Finalize your issue
57
58 3 Jan Schulz-Hofen
  - Click **Create** to finalize the issue and view its details; or,
59
  - Click **Create and continue** to finalise the issue and create an additional issue; or,
60 5 Jan Schulz-Hofen
  - Click **Preview** to view the appearance of the issue’s description (very useful if you have included wiki syntax text in your description).
61 3 Jan Schulz-Hofen
62
image
63
64
Spotlight: The Status Field
65
66
Assigning a status to an issue is pretty straightforward: during issue creation or editing just select the most appropriate option (if you want to define custom statuses or workflows, you may want to check out this FAQ entry).
67
68
Status field options, like many fields in Planio, can be customized according to your organization’s needs. For example, in a change management or customer service environment, status options might include new, in progress, resolved, feedback, closed and rejected:
69
70
image
71
72
Of course if your organization is a bit more laid-back, you may prefer something along these lines…
73
74
image
75
76
If you’re a PM, using watchers is a great way to keep everyone in your organization in the loop when it comes to project issues. Do you include issue watchers? Tell us how you customize your Planio issues via a Comment below!
77
78
Your dedicated Planio blogger, Brian, is currently studying German, reading “The Canterbury Tales,” and (of course) preparing a cheeseburger for dinner.