Tasks
Create tasks, find them and update their status, priority or assignees.
Last updated on
With these steps an automation creates and updates tasks, so that a colleague picks something up. They are in the Tasks group. For how the outputs work, read Outputs of an action.
How does this fit together?
A task created by an automation is an ordinary task: you find it on the tasks page, in the views it fits and on the customer or record it is linked to.
More about what colleagues see and do is in Tasks and Tasks with choice buttons.
Create task
Creates a task in the task system. The task is created in the name of Workflow.
| Field | What you enter |
|---|---|
| Title | The name of the task. Required |
| Description | An explanation for the task |
| Assign to | Choose one or more colleagues. Click a name to switch it on or off |
| Assign to groups | Choose one or more groups. The task then applies to everyone who is in the group at that moment |
| Labels | Choose one or more labels |
| Also assign whoever caused the event | Also assigns the task to the colleague who caused the event, for example whoever ended the occupancy. If the system caused the event, nobody is added |
| Priority | Low, Medium, High or Urgent. Medium by default |
| Add to board | Choose a board the task is placed on, or leave it empty |
| Column | Choose a column of the board above. The list shows the columns as [board] · [column] |
| Subtasks | One subtask per line, or exactly one variable containing a list, such as {result} from Run code |
| Due after | How many minutes, hours, days or weeks after the step runs the deadline falls. At 0 the task gets no deadline. 1 day by default |
| Link to records | Links the task to the records below and to their customer, terrain, invoice, reservation or meter. On by default |
| Link to | Appears when Link to records is on. Choose which records the task appears on. Everything the step knows is ticked beforehand: the records of the trigger and whatever an earlier lookup step found |
| Only the flow can finish it | Colleagues cannot complete or delete the task. Add a Delete task or Set task status step later in the flow to finish it |
Keep in mind:
- If you choose nobody under Assign to or Assign to groups and leave Also assign whoever caused the event off, the task has no assignee. Workflow is never assigned itself
- Subtasks get the title you enter, no assignee and no deadline. Empty lines are skipped. You may use variables in the lines
- Link to concerns customers, terrains, invoices, reservations and meters. For an occupancy that ends, the task is therefore linked to the terrain, the customer and the reservation by default. If you remove a record from the list, the task stays away from it. Records that join the flow later are not added automatically by Tillor once you have edited the list yourself. Choose everything again and the step follows all available records once more
- If a task is only on a personal board, only the people involved see it. See Private tasks
For later steps the action provides {createdTask.id} and {createdTask.name}. With those you can, for example, set the status afterwards.
If you do not want a second task when an open task already exists for the same terrain or customer, first add a Find task step and create the task only via Not found. The Holiday caravan check example does that.
If you switch on Only the flow can finish it, the task shows Finished by its automation. Colleagues cannot complete or delete it.
Delete task
Deletes a task, for example the task this flow created once it is no longer needed.
| Field | What you enter |
|---|---|
| Task | The id of the task. {createdTask.id} by default. Required |
A task that is already gone is skipped. The flow then simply continues.
Set task status
Changes the status of an existing task, for example to complete it.
| Field | What you enter |
|---|---|
| Task | The id of the task. {task.id} by default. Required |
| Status | Pending, In Progress, Waiting for reply or Completed. Completed by default |
{task.id} works when the automation starts on a task event, such as task:created. After a Create task step, use {createdTask.id}. The action provides {updatedTask.id} and {updatedTask.status}.
Find task
Looks for an existing task by title. The step has two outputs: Found and Not found. That way you can update a task if it already exists, and otherwise create a new one.
| Field | What you enter |
|---|---|
| Title | The title the task must have exactly, for example Nalopen {occupation.terrain.name}. Variables are filled in first. Required |
| Linked to the records of the event | Only tasks linked to at least one of the same records, such as the terrain or the customer. On by default |
| Only tasks that are not completed | Skips completed tasks. On by default |
| Skip subtasks | Looks only for main tasks. On by default |
If several tasks match, the step takes the newest. If Linked to the records of the event is on but the event has no customer, terrain, invoice, reservation or meter, the flow goes via Not found.
Via Found, later steps can use {foundTask.id}, {foundTask.name}, {foundTask.priority} and {foundTask.status}.
Set task priority
Changes the priority of an existing task.
| Field | What you enter |
|---|---|
| Task | The id of the task. {foundTask.id} by default. Required |
| Change | One step higher (default), One step lower or To a fixed priority |
| Priority | Only with To a fixed priority: Low, Medium, High or Urgent |
| Raise up to | Only with One step higher: the highest priority the step may give. High by default. A task that is already that high or higher stays as it is |
The order is Low, Medium, High, Urgent. One step lower stops at Low. If nothing changes, the step simply succeeds without changing the task. The action provides {updatedTask.id} and {updatedTask.priority}.
Update task
Changes an existing task. Fields you leave empty stay as they are.
| Field | What you enter |
|---|---|
| Task | The id of the task. {foundTask.id} by default. Required |
| New title | The new name of the task. Empty leaves the title as it is |
| Assignees | Choose one or more colleagues |
| Groups | Choose one or more groups |
| Also assign whoever caused the event | Also adds the colleague who caused the event. If the system caused the event, nobody is added |
| Assignees | Add to the current ones (default) or Replace the current ones |
| Add labels | Choose one or more labels. They are added, existing labels stay |
| Due after | Sets the deadline to this many minutes, hours, days or weeks after the step runs. At 0 the deadline stays as it is |
Keep in mind:
- If you choose Replace the current ones and specify nobody, the task has no assignee afterwards
- If the task no longer exists, the step fails
- The action provides
{updatedTask.id}