Project

Profile

Help

Create a custom workflow for recurring tasks » History » Sprint/Milestone 11

Jan Schulz-Hofen, 03/19/2014 05:24 AM

1 1 Jan Schulz-Hofen
# Create a custom workflow for recurring tasks
2
3
Planio is not only great for [one-off projects](https://plan.io/project-management/). It really shines when it comes to [recurring tasks](https://plan.io/task-management/) that follow a certain workflow within your organization.
4
5 4 Jan Schulz-Hofen
Follow along this guide to create a simple vacation approval workflow for your team members - and apply what you've learned to create your own custom workflows.
6 1 Jan Schulz-Hofen
7
## Planio workflow basics
8
9
{{>toc}}
10
11
In Planio, every issue must belong to a tracker which defines its workflow. Let's look at this in more detail:
12
13
### Trackers
14
15
We'd like to see trackers as special issue types. An issue must belong to exactly one tracker. **Task**, **Support incident**, **Software bug**, or -- you guessed it -- **Vacation request** would be great examples for a tracker.
16
17
### Issue statuses
18
19
Issue statuses describe the different states, that an issue in Planio can have at any given moment. For instance, an issue can be **Open**, **In progress**, **Waiting for review**, or **Closed**. An issue will always have exactly one status and the status will likely change over time as people work on the issue.
20
21
### Roles
22
23
Users in Planio have their own user account using which they take part in projects using one or more roles: While some users may take part as **Manager**, others may be **Assistant** or e.g. **Client**. The role defines what a user can and cannot see or do in a given project. It also defines the user's workflow.
24
25
### Workflows
26
27
The workflow brings it all together: A workflow defines for every possible combination of tracker and role which issue statuses are available. It defines for all its tracker's issues which status changes are allowed and which issue properties are visible and/or changeable.
28
29
Say what!? This is arguably the most complex (and powerful) part of Planio, but don't worry -- we will walk you through it and you will be a workflow expert in no time!
30
31
![](sample_task_workflow.png)  
32
*Sample workflow for **Managers** working on **Tasks**.*
33
34 4 Jan Schulz-Hofen
## Technicalities of going on a vacation
35 2 Jan Schulz-Hofen
36
We knew you would love this section. Dreaming of that deserted beach in the Caribbean? Let's request some vacation days and off we go.
37
38
In many companies, taking a vacation requires approval by a manager. Employees must submit a request mentioning the start and end date of the requested vacation and managers will approve or disapprove the request. Upon approval, the dates of that vacation can not be altered, and the vacation request is final. If disapproved, employees can alter their requested dates and re-request approval until -- hopefully -- they will be allowed their well-deserved days in the Caribbean.
39
40
We will now build this workflow in Planio allowing for actual vacation requests being made and approved. We will also show you how to visualise them on Planio's calendar, so you can get a great overview on how is on vacation at which point in time.
41
42 4 Jan Schulz-Hofen
## Tracker, Statuses, Roles, and Workflow
43 2 Jan Schulz-Hofen
44
To implement this, we will create a **Tracker** called *Vacation request*, three **Issue statuses** called *Open*, *Approved*, and *Rejected*, and two **Roles**, called *Manager* and *Employee*.
45 3 Jan Schulz-Hofen
46 1 Jan Schulz-Hofen
Finally, we will tie all those together using a custom **Workflow** in Planio.
47
48 9 Jan Schulz-Hofen
### Create the tracker
49 4 Jan Schulz-Hofen
50
First things first. Let's get down to business:
51
52 6 Jan Schulz-Hofen
  - Navigate to **Administration** -\> **Trackers**, then click on **New tracker**.
53 1 Jan Schulz-Hofen
  - Enter *Vacation request* as **Name**.
54 9 Jan Schulz-Hofen
  - Uncheck the **Issues displayed in roadmap** checkbox since we do not want to see vacation days on our project roadmaps.
55
  - Uncheck all **Standard fields** checkboxes except the ones for **Start date** and **Due date**. We'll actually use those for the start and end of our vacations.
56
  - Do not select anything in the **Copy workflow from** drop down.
57
  - Click **Create**.
58
59
![](creating_a\_new_tracker.png)  
60
*Your tracker should look like this.*
61
62
### Create issue statuses
63
64 10 Jan Schulz-Hofen
The steps are similar but slightly different for the three statuses *Open*, *Approved*, and *Rejected*.
65 6 Jan Schulz-Hofen
66 10 Jan Schulz-Hofen
  - Navigate to **Administration** -\> **Issue statuses**.
67
  - Do you see a status called *Open*? Great, click on it, and make sure that the **Default value** checkbox is checked. This will make *Open* the default status that's always the first status for a newly created issue.
68
  - Do not see the status? Simply click on **New status**, enter *Open* in the **Name** field, and check the **Default value** checkbox. Uncheck the **Add to all workflows** checkbox since we only want it for our *Vacation request* workflow.
69
  - Click on **Save** or **Create** respectively.
70
  - Create the remaining statuses *Approved* and *Rejected* following the same pattern and make sure the *Approved* status has the **Issue closed** checkbox checked.
71 11 Jan Schulz-Hofen
72
![](create_an_issue_status.png)  
73
*This is what your **Approved** status will look like.*