Jira

Интеграция с Jira Cloud и Jira Data Center

Ваш Jira Data Center должен быть доступен из интернета. Внутренний корпоративный Jira не подключится.

Доступные операции

Задачи:
  • Создает задачу Jira, при необходимости со связью с эпиком или родителем для подзадачи.

  • Создает несколько задач Jira одним пакетом.

  • Возвращает подробности задачи Jira.

  • Изменяет задачу и при необходимости переводит ее по статусу, добавляет комментарий и списывает время.

  • Удаляет задачу Jira.

  • Ищет задачи Jira с помощью JQL.

  • Переносит задачу Jira в другой проект (только Jira Cloud).

  • Переносит задачи в бэклог, убирая их из всех спринтов.

  • Назначает исполнителя задачи Jira через отдельный эндпоинт назначения.

  • Переводит задачу Jira в новый статус.

  • Возвращает доступные переходы статуса для задачи Jira.

  • Возвращает даты задачи Jira и историю переходов по статусам.

  • Возвращает историю изменений нескольких задач Jira (только Cloud).

Комментарии:
  • Добавляет комментарий к задаче Jira.

  • Изменяет существующий комментарий задачи Jira.

Вложения:
  • Прикрепляет файл из текущей сессии агента к задаче Jira.

  • Скачивает вложения задачи Jira.

  • Сохраняет вложение задачи Jira файлом в текущую сессию агента.

  • Возвращает все изображения, приложенные к задаче Jira, как встроенные изображения.

Связи и зависимости:
  • Создает связь между двумя задачами Jira.

  • Удаляет связь между двумя задачами Jira.

  • Возвращает все доступные типы связей между задачами.

  • Добавляет к задаче Jira внешнюю ссылку (веб-страницу или страницу Confluence).

  • Привязывает существующую задачу к эпику.

  • Находит все связи задач проекта с задачами других проектов.

  • Группирует эпики проекта по их родительским задачам из других проектов.

Журнал работ:
  • Добавляет запись в журнал работ задачи Jira.

  • Возвращает записи журнала работ задачи Jira.

Наблюдатели:
  • Добавляет пользователя в наблюдатели задачи Jira.

  • Возвращает список наблюдателей задачи Jira.

  • Убирает пользователя из наблюдателей задачи Jira.

Спринты и доски:
  • Создает спринт Jira для доски.

  • Изменяет спринт Jira.

  • Добавляет задачи в спринт Jira.

  • Возвращает задачи спринта Jira.

  • Возвращает спринты доски Jira по состоянию.

  • Возвращает agile-доски Jira по названию, ключу проекта или типу.

  • Возвращает все задачи указанной доски с фильтром по JQL.

Проекты:
  • Возвращает все проекты Jira, доступные текущему пользователю.

  • Ищет проекты Jira по названию или началу ключа.

  • Возвращает все компоненты указанного проекта Jira.

  • Возвращает доступные типы задач проекта Jira.

  • Возвращает все задачи указанного проекта Jira.

  • Возвращает поля, доступные в задачах проекта.

Версии:
  • Создает версию (fix version) в проекте Jira.

  • Создает несколько версий в проекте Jira одним пакетом.

  • Изменяет существующую версию (fix version) в проекте Jira.

  • Возвращает все версии (fix versions) указанного проекта Jira.

Поля:
  • Возвращает поля, доступные при создании задачи указанного типа.

  • Возвращает допустимые варианты значений кастомного поля.

  • Ищет поля Jira по ключевому слову с нечетким совпадением.

Пользователи:
  • Возвращает профиль указанного пользователя Jira.

  • Ищет пользователей Jira, которых можно назначить в указанном проекте или задаче.

Данные разработки:
  • Возвращает данные разработки (PR, коммиты, ветки), связанные с задачей Jira.

  • Возвращает данные разработки для нескольких задач Jira.

Формы ProForma:
  • Возвращает все формы ProForma, связанные с задачей Jira.

  • Возвращает подробную информацию о форме ProForma.

  • Изменяет ответы в полях формы через Jira Forms REST API.

SLA и аналитика:
  • Вычисляет SLA-метрики задачи Jira.

Service Desk (JSM):
  • Создает клиентский запрос в Jira Service Management.

  • Возвращает задачи из очереди Service Desk (Jira Service Management).

  • Возвращает описания полей типа запроса Jira Service Management.

  • Возвращает типы запросов Service Desk в Jira Service Management.

  • Возвращает Service Desk (Jira Service Management), связанный с ключом проекта.

  • Возвращает очереди Service Desk (Jira Service Management).

Требования к аккаунту

  • Аккаунт Jira с правом просмотра нужных проектов.

  • Для изменяющих действий — права на создание и изменение задач в целевых проектах. Удаление задач требует отдельного права.

  • Для работы со спринтами — доступ к соответствующей agile-доске.

  • Для аналитики разработки — подключение системы контроля версий (Bitbucket/GitHub/GitLab) в Jira, иначе данные панели разработки будут пустыми.

Подготовка и добавление из витрины

Подготовка выполняется администратором GigaCowork.

Интеграция поддерживает подключение к Jira Cloud и Jira Data Center.

Для добавления интеграции:
  1. В разделе button settings Администрирование → button blocks Интеграции нажмите Добавить интеграцию.

  2. В витрине интеграций откройте подключаемую интеграцию Jira.

  3. На шаге Настройки интеграции укажите Адрес Jira: https://<компания>.atlassian.net для Cloud, или адрес Data Center.

  4. На шаге Настройка авторизации выберите Тип аутентификации:

    • Логин и пароль — только для Jira Cloud.

    • Токен доступа — только для Jira Data Center.

  5. Нажмите Далее, а затем Добавить — интеграция добавится для авторизации пользователями.

Авторизация в интеграции

Для работы с интеграцией:
  1. Проверьте, что интеграция находится в разделе button grid 2x2 Каталоги → button blocks Интеграции. Если ее нет, попросите администратора GigaCowork ее включить.

  2. Откройте интеграцию и нажмите Войти в аккаунт. Интеграция уже может быть авторизована администратором, а кнопка входа и выхода из аккаунта недоступна. Это означает, что с ней уже можно работать.

  3. Перед авторизацией получите токен для вашей версии Jira:

    Как получить Jira API Token (Jira Cloud):
    1. Откройте https://id.atlassian.com и войдите.

    2. Аватар → Account Settings → вкладка Security.

    3. Раздел API tokens → Create and manage API tokens → Create API token.

    4. Введите имя → Create → скопируйте токен (показывается один раз).

    Как получить Jira PAT (Jira Data Center / Server):
    1. Войдите в свою Jira.

    2. Аватар → Profile → Personal Access Tokens.

    3. Create token → введите имя (и срок действия при необходимости) → Create.

    4. Скопируйте токен (после закрытия окна не показывается).

  4. Укажите учетные данные вашего аккаунта Jira:

    • для Jira Cloud — почту и API Token;

    • для Jira Data Center — токен доступа.