Jira и SLAtech Vantage: задачи, комментарии и часы

SLAtech Vantage читает из Jira задачи одного проекта, комментарии к ним и списания времени (worklog) и превращает их в задачи, переписку и часы со ставкой. Интеграция работает только на чтение: в Jira ничего не записывается. Часы, которые ведутся в Tempo, а не в самой Jira, не забираются. Поддерживаются и Jira Cloud, и Jira Data Center.

Что забирается из каждой задачи Jira

Из каждой задачи подключённого проекта загружаются:

• Ключ задачи, заголовок и описание, а также автор;
• Статус под вашим собственным названием вместе с его категорией;
• Оценка времени, если у задачи в SLAtech Vantage ещё нет своей;
• Комментарии, включая упоминания людей;
• Списания времени: кто списал, дата и описание.

В ответе на поиск Jira отдаёт только часть комментариев и списаний по длинной задаче. SLAtech Vantage дозапрашивает остальное отдельным запросом, чтобы задача с долгой историей не загрузилась неполной.

Как статус Jira становится рабочим статусом

Названия статусов у каждой команды свои, поэтому преобразование идёт по категории статуса, а она одинакова в любой Jira: к выполнению, в работе, готово. Исходное название сохраняется рядом, слово в слово.

• Задача, закрытая с резолюцией вроде Won't Do или Duplicate, записывается как отклонённая, а не как выполненная.
• Задача, которая в SLAtech Vantage ждёт ответа клиента, не возвращается в "в работе" только потому, что в Jira она в работе. Если её закрыть в Jira, она закроется и здесь.

Последующие изменения в Jira приезжают со следующей синхронизацией: заголовок, описание, статус, новые комментарии и часы.

Часы из Jira: дата, автор и ставка

Каждое списание становится строкой часов в задаче. Дата берётся по рабочему дню в часовом поясе того, кто списал время, а не по дню ввода: часы, списанные в пятницу за понедельник, ложатся на понедельник.

• Автор сопоставляется по его идентификатору в Jira, а если его нет, по почте. Часы человека, который ещё не сопоставлен, всё равно приезжают по ставке проекта, без владельца, и это видно на экране.
• Каждая строка хранит ставку на момент поступления. Позднее изменение ставки её не меняет, и уже загруженное списание не переписывается.
• Часы за месяц, который уже сдан или принят, не приезжают, а их количество попадает в отчёт прогона.

Что видит клиент и что остаётся внутри

В портале клиент видит задачи, пришедшие из Jira, их статус и записанные по ним часы. Комментарии показаны в карточке задачи.

Комментарий, который в Jira ограничен ролью или группой, в SLAtech Vantage помечается как приватный: он адресован части команды, а клиент относится к другой организации. В портале он не показывается и в клиентский поиск не попадает.

Новая задача сразу при создании получает организацию-исполнителя, чтобы команда её видела и могла записывать по ней часы.

Как подключить и что не забирается

Форма подключения запрашивает адрес сайта (например, company.atlassian.net), ключ проекта и API-токен. Для Jira Cloud нужна ещё почта владельца токена; для Data Center её оставляют пустой и вводят персональный токен. Проверка смотрит доступ именно к проекту, а не только действительность токена. Каждый проект Jira это отдельное подключение.

• Только чтение. Изменения статусов и комментарии в Jira не записываются.
• Tempo не забирается. Если часы ведутся в Tempo, часы из Jira будут неполными. Форма предупреждает об этом до ввода ключа.
• Вложения в SLAtech Vantage сейчас не переносятся.
• Синхронизация идёт раз в сутки, ночью.
• Экран источников проекта, где вводятся данные, сейчас открыт только оператору системы, поэтому подключение делается через нас.

Частые вопросы