Jira
Задачи, комментарии, переходы и поиск JQL в Jira из процессов Pailot
Jira — учёт задач и проектов Atlassian: задачи, комментарии, переходы статусов, вложения и трудозатраты. Поиск — JQL (Jira Query Language — язык запросов Jira).
С Jira в Pailot вы можете:
- Читать, создавать, обновлять и удалять задачи; назначать исполнителя
- Переводить задачу по статусам workflow и искать по JQL
- Комментарии, вложения, worklog, связи между задачами, наблюдатели
- Получать пользователей аккаунта
- Запускать процесс по вебхуку (входящему HTTP-запросу) Jira
Нужен вход по OAuth (вход по разрешению сервиса) или API-токен Atlassian и домен вида yourcompany.atlassian.net. Если сервис шлёт события, включите режим триггера и скопируйте URL вебхука. Не публикуйте URL.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Подробности конкретной задачи Jira.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
projectId | string | Нет | ID проекта (для одной задачи не обязателен) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи (например PROJ-123) |
summary | string | Краткое название |
description | json | Описание задачи |
created | string | Время создания |
updated | string | Время последнего изменения |
issue | json | Полный объект задачи со всеми полями |
Обновить задачу Jira.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
projectId | string | Нет | ID проекта. Если не задан, выборка идёт по всем задачам |
issueKey | string | Да | Ключ задачи |
summary | string | Нет | Новое краткое название |
description | string | Нет | Новое описание |
status | string | Нет | Новый статус |
priority | string | Нет | Новый приоритет |
assignee | string | Нет | Новый исполнитель |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ обновлённой задачи (например PROJ-123) |
summary | string | Краткое название после обновления |
Создать задачу Jira.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
projectId | string | Да | ID проекта |
summary | string | Да | Краткое название |
description | string | Нет | Описание |
priority | string | Нет | ID или имя приоритета (например 10000 или High) |
assignee | string | Нет | Account ID исполнителя |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
issueType | string | Да | Тип задачи (например Task, Story) |
labels | array | Нет | Метки (массив имён) |
duedate | string | Нет | Срок (YYYY-MM-DD) |
reporter | string | Нет | Account ID автора |
environment | string | Нет | Сведения об окружении |
customFieldId | string | Нет | ID пользовательского поля (например customfield_10001) |
customFieldValue | string | Нет | Значение пользовательского поля |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ созданной задачи (например PROJ-123) |
summary | string | Краткое название |
url | string | URL созданной задачи |
assigneeId | string | Account ID исполнителя (если назначен) |
Прочитать несколько задач Jira разом.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
projectId | string | Да | ID проекта |
cloudId | string | Нет | Jira Cloud ID |
| Параметр | Тип | Описание |
|---|
issues | array | Задачи: ts, summary, description, created и updated |
Удалить задачу Jira.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
deleteSubtasks | boolean | Нет | Удалять ли подзадачи. Если false, родительскую задачу с подзадачами удалить нельзя |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ удалённой задачи |
Назначить исполнителя задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
accountId | string | Да | Account ID исполнителя. -1 — автоназначение, null — снять исполнителя |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ назначенной задачи |
assigneeId | string | Account ID исполнителя |
Перевести задачу в другой статус workflow (например To Do → In Progress).
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
transitionId | string | Да | ID перехода (например 11 — To Do, 21 — In Progress) |
comment | string | Нет | Необязательный комментарий при переходе |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ переведённой задачи |
transitionId | string | Применённый ID перехода |
Поиск задач по JQL (Jira Query Language — язык запросов Jira).
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
jql | string | Да | Запрос JQL (например project = PROJ AND status = Open) |
startAt | number | Нет | Индекс первого результата (постраничный вывод) |
maxResults | number | Нет | Максимум результатов (по умолчанию 50) |
fields | array | Нет | Имена полей в ответе (по умолчанию summary, status, assignee, created, updated) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
total | number | Всего подходящих задач |
startAt | number | Индекс начала страницы |
maxResults | number | Максимум на страницу |
issues | array | Найденные задачи: key, summary, status, assignee, created, updated |
Добавить комментарий к задаче.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
body | string | Да | Текст комментария |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи, к которой добавлен комментарий |
commentId | string | ID созданного комментария |
body | string | Текст комментария |
Все комментарии задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
startAt | number | Нет | Индекс первого комментария (по умолчанию 0) |
maxResults | number | Нет | Максимум комментариев (по умолчанию 50) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
total | number | Всего комментариев |
comments | array | Комментарии: id, author, body, created, updated |
Изменить комментарий задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи с комментарием (например PROJ-123) |
commentId | string | Да | ID комментария |
body | string | Да | Новый текст |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
commentId | string | ID комментария |
body | string | Обновлённый текст |
Удалить комментарий задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи с комментарием (например PROJ-123) |
commentId | string | Да | ID комментария |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
commentId | string | ID удалённого комментария |
Все вложения задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
attachments | array | Вложения: id, filename, size, mimeType, created, author |
Удалить вложение задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
attachmentId | string | Да | ID вложения |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
attachmentId | string | ID удалённого вложения |
Добавить запись трудозатрат (worklog) к задаче.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
timeSpentSeconds | number | Да | Затраченное время в секундах |
comment | string | Нет | Необязательный комментарий к записи |
started | string | Нет | Время начала в ISO (по умолчанию сейчас) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
worklogId | string | ID записи трудозатрат |
timeSpentSeconds | number | Затраченное время в секундах |
Все записи трудозатрат задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
startAt | number | Нет | Индекс первой записи (по умолчанию 0) |
maxResults | number | Нет | Максимум записей (по умолчанию 50) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
total | number | Всего записей |
worklogs | array | Записи: id, author, timeSpentSeconds, timeSpent, comment, created, updated, started |
Изменить запись трудозатрат.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
worklogId | string | Да | ID записи |
timeSpentSeconds | number | Нет | Затраченное время в секундах |
comment | string | Нет | Комментарий к записи |
started | string | Нет | Время начала в ISO |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
worklogId | string | ID записи |
Удалить запись трудозатрат.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
worklogId | string | Да | ID записи |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
worklogId | string | ID удалённой записи |
Связать две задачи Jira.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
inwardIssueKey | string | Да | Ключ входящей задачи (например PROJ-123) |
outwardIssueKey | string | Да | Ключ исходящей задачи (например PROJ-456) |
linkType | string | Да | Тип связи (например Blocks, Relates to, Duplicates) |
comment | string | Нет | Необязательный комментарий к связи |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
inwardIssue | string | Ключ входящей задачи |
outwardIssue | string | Ключ исходящей задачи |
linkType | string | Тип связи |
linkId | string | ID созданной связи |
Удалить связь между задачами.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
linkId | string | Да | ID связи |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
linkId | string | ID удалённой связи |
Добавить наблюдателя: уведомления об изменениях задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
accountId | string | Да | Account ID наблюдателя |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
watcherAccountId | string | Account ID добавленного наблюдателя |
Убрать наблюдателя с задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
issueKey | string | Да | Ключ задачи (например PROJ-123) |
accountId | string | Да | Account ID наблюдателя |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
issueKey | string | Ключ задачи |
watcherAccountId | string | Account ID снятого наблюдателя |
Пользователи Jira. Если задан account ID — один пользователь, иначе список всех.
| Параметр | Тип | Обязательный | Описание |
|---|
domain | string | Да | Домен Jira (например yourcompany.atlassian.net) |
accountId | string | Нет | Account ID конкретного пользователя. Если не задан — все пользователи |
startAt | number | Нет | Индекс первого пользователя (постраничный вывод, по умолчанию 0) |
maxResults | number | Нет | Максимум пользователей (по умолчанию 50) |
cloudId | string | Нет | Jira Cloud ID. Если не задан — определяется по домену |
| Параметр | Тип | Описание |
|---|
ts | string | Время операции |
users | json | Пользователи: accountId, displayName, emailAddress, active и avatarUrls |
total | number | Сколько пользователей вернулось |
startAt | number | Индекс начала страницы |
maxResults | number | Максимум на страницу |
