Статусы задач
Как устроены статусы в FlowWorker
Заголовок раздела «Как устроены статусы в FlowWorker»Каждая задача имеет поле statusKey - внутренний ключ статуса. Система поддерживает системные статусы и custom-слоты:
| Ключ | Описание | IsDone по умолчанию |
|---|---|---|
Todo | Новая задача, ещё не начата | false |
InProgress | В работе | false |
Done | Завершена | true |
Blocked | Заблокирована | false |
Custom1 .. Custom12 | Кастомные слоты, название задаётся per-project | зависит от настройки |
Проект может переопределить название и isDone для любого слота через настройки kanban-доски. Например, Custom1 может называться «На ревью» (isDone=false), а Custom3 - «Архив» (isDone=true).
Структура task.status в payload
Заголовок раздела «Структура task.status в payload»Начиная с v2.0, поле status в PublicTaskDto - это объект, а не строка:
{ "id": 42, "title": "Написать тесты", "status": { "key": "Custom1", "label": "На ревью", "isDone": false, "color": "#f59e0b" }}| Поле | Тип | Описание |
|---|---|---|
key | string | Системный ключ: Todo, InProgress, Done, Blocked, Custom1..Custom12 |
label | string | Название из настроек проекта или системное название по умолчанию |
isDone | boolean | true если статус считается завершённым |
color | string | null | HEX-цвет из настроек проекта, либо null если цвет не задан |
Когда label - override, а когда - default
Заголовок раздела «Когда label - override, а когда - default»- Override (из настроек проекта): если проект настроил название колонки, например «Беклог» вместо «Todo», или «На ревью» для
Custom1- вlabelпридёт именно это название. - По умолчанию
labelсодержит системное название. ДляTodoэто «К выполнению», дляInProgress— «В работе», дляCustom1—Custom 1.
Для чтения isDone не полагайтесь только на системный список - используйте поле isDone из payload, так как custom-слоты могут быть настроены как «завершённые».
Передача status в поиске
Заголовок раздела «Передача status в поиске»GET /api/public/v1/tasks/search?status=... поддерживает три формата и принимает несколько значений одновременно. Передайте их через запятую или повторите параметр:
GET /api/public/v1/tasks/search?status=open,blockedGET /api/public/v1/tasks/search?status=open&status=blockedНесколько значений объединяются через OR (задача включается в результат, если хотя бы один из статусов совпадает). Остальные фильтры при этом по-прежнему объединяются через AND.
1. Semantic alias (lowercase)
Заголовок раздела «1. Semantic alias (lowercase)»Наиболее универсальный вариант - не зависит от конкретной конфигурации проекта:
| Alias | Что возвращает |
|---|---|
open | Все задачи, где isDone = false |
closed или done | Все задачи, где isDone = true |
todo | Задачи со StatusKey Todo |
in-progress | Задачи со StatusKey InProgress |
blocked | Задачи со StatusKey Blocked |
GET /api/public/v1/tasks/search?status=openGET /api/public/v1/tasks/search?status=closed2. System key (case-insensitive)
Заголовок раздела «2. System key (case-insensitive)»Точный поиск по системному ключу:
GET /api/public/v1/tasks/search?status=InProgressGET /api/public/v1/tasks/search?status=inprogressGET /api/public/v1/tasks/search?status=Custom13. Per-project label
Заголовок раздела «3. Per-project label»Поиск по названию колонки в конкретном проекте. Для точного результата укажите projectId:
GET /api/public/v1/tasks/search?status=На%20ревью&projectId=12GET /api/public/v1/tasks/search?status=Беклог&projectId=5Без projectId - first-match по аккаунту (если несколько проектов имеют колонку с одинаковым названием, результат может быть неожиданным).
Рекомендации
Заголовок раздела «Рекомендации»- Для general queries (все открытые, все закрытые) - используйте semantic aliases
open/closed. Они корректно обрабатывают custom-слоты с нестандартнымisDone. - Для конкретного project workflow - используйте label с
projectIdдля точного scope:?status=На%20ревью&projectId=12. - Для программных интеграций - читайте
task.status.key, а неtask.status.label(labels могут меняться при переименовании колонок). - Для отображения пользователю - используйте
task.status.labelиtask.status.color.
См. также: Поиск задач и проектов.