Настройка панели таймера Keepr в Jira
Что делает панель
Панель Keepr находится в карточке задачи Jira. Из неё можно запустить таймер Keepr по той задаче, которую вы и так читаете, видеть, как идёт время, и остановить его — не уходя из Jira.
Отслеженное так время — обычное время Keepr: оно попадает в пространство, к проекту, на задачу и отображается в трекере, отчётах и дайджестах ровно так же, как время, запущенное из веб-приложения.
Что нужно заранее
Нужны три вещи: Jira Cloud, организация Keepr на тарифе Ultimate и администратор сайта Jira, который один раз установит приложение для всего сайта.
Требование Ultimate идёт от персональных API-токенов: именно через них панель обращается к Keepr от вашего имени. Каждый подключает свой токен, поэтому время каждого записывается на него, а не складывается под одной учётной записью.
1. Установите приложение в Jira
Администратор сайта устанавливает приложение один раз, сразу для всех. Jira покажет два разрешения, которые оно запрашивает: хранилище приложения, где лежат ваш токен и привязка проекта, и доступ на чтение задач Jira — панель читает заголовок задачи, чтобы в примечании к записи было не только её ключ.
Дальше обновления приходят сами, с одним исключением: обновление, которое меняет э ти разрешения, — мажорная версия, и Jira придержит его, пока администратор не примет его в разделе «Приложения → Управление приложениями». Если ожидаемая возможность не появилась, начните проверку оттуда.
2. Подключите свою учётную запись Keepr
Откройте любую задачу и найдите панель Keepr. В первый раз она попросит персональный API-токен. Создайте его в Keepr в разделе API-токены, выдайте области доступа timers и projects и вставьте в панель. Полное значение токена показывается только один раз — при создании.
Токен хранится отдельно для каждого пользователя Jira как секрет Forge, привязанный к вашей учётной записи Atlassian: никто другой на сайте не может его увидеть или использовать, и он никогда не попадает на страницу в вашем браузере. Кнопка «Отключить» удаляет его в любой момент.
Токен без области projects всё равно запускает таймеры — он просто не может создать в Keepr задачу под задачу Jira, поэтому время записывается только на проект.
3. Свяжите проект Jira с пространством
Каждый проект Jira ведёт время в одно пространство Keepr и, по желанию, в один проект внутри него. В первый раз панель спросит об этом, дальше будет показывать выбор заполненным; кнопка «Изменить» открывает его снова.
Привязка принадлежит проекту Jira, а не вам. Она задаётся один раз и действует для всех на сайте, кто пользуется панелью в этом проекте, — благодаря этому время команды попадает в одно место.
4. Запуск и остановка таймеров
Нажмите «Запустить таймер». Keepr найдёт или создаст задачу по ключу задачи Jira, поэтому повторный запуск по той же задаче через неделю переиспользует ту же задачу, а не плодит дубликаты. В примечание к записи подставляются ключ и заголовок задачи.
Панель и веб-приложение Keepr управляют одним и тем же таймером. Запуск здесь останавливает таймер, идущий в вебе, и та вкладка обновляется сразу. Keepr никогда не останавливает таймер без подтверждения, поэтому при конфликте панель предлагает «Остановить и запустить здесь».
Обычные ограничения действуют без изменений: сколько таймеров можно вести одновременно и что делает эксклюзивное пространство, описано в статье «Как работают одновременные таймеры?».
Если что-то пошло не так
«Токен отклонён» означает, что токен отозван, истёк или введён с ошибкой, — создайте новый и подключитесь заново. «У токена не хватает области доступа» означает, что нет timers или projects: области задаются при создании и не меняются, поэтому нужен новый токен.
«Сначала выберите пространство Keepr для этого проекта Jira» означает, что привязка из шага 3 не задана. «Персональные API-токены входят в тариф Ultimate» означает, что организация, которой принадлежит токен, не на Ultimate.
«Уже идёт другой таймер» и «Достигнут предел одновременных таймеров» — это правила одновременности, а не ошибки: остановите таймер или примите предложение панели остановить другой и запустить здесь.