Коннектор Jira синхронизирует задачи из проекта Jira с использованием Jira REST API v3.
Аутентификация
OAuth — требуются области:
read:jira-workoffline_access
Конфигурация
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
| Домен Jira | Ввод | Да | Например, yoursite.atlassian.net |
| Проект | Селектор / Ввод | Да | Ключ проекта |
| JQL-фильтр | Ввод | Нет | Пользовательский JQL для фильтрации задач |
| Макс. задач | Ввод | Нет | Ограничение количества синхронизируемых задач |
Как это работает
- Разрешение Cloud ID — получает ID облака Atlassian из домена
- Построение JQL — формирует
project = "KEY" ORDER BY updated DESCс опциональным пользовательским JQL-фильтром - Поиск задач — использует поисковый эндпоинт Jira REST API v3
- Извлечение ADF — преобразует Atlassian Document Format в описаниях и комментариях в обычный текст
- Пагинация — смещение
startAt/maxResults
Формат документа
KEY-123: Краткое описание задачи
Текст описания...
Текст комментария 1...
Текст комментария 2...Теги метаданных
| Тег | Тип | Описание |
|---|---|---|
| Тип задачи | Text | Bug, Story, Task и т.д. |
| Статус | Text | Текущий статус рабочего процесса |
| Приоритет | Text | Уровень приоритета задачи |
| Метки | Text | Метки через запятую |
| Исполнитель | Text | Назначенный сотрудник |
| Последнее обновление | Date | Когда задача была последний раз обновлена |
Валидация JQL
Пользовательские JQL-фильтры проверяются при настройке. Некорректный JQL возвращает немедленную ошибку.