Запуск таймера из задач и merge request в GitLab
Какие страницы распознаются
Откройте в GitLab задачу (issue) или рабочий элемент (work item), и расширение Keepr покажет над таймером карточку «На этой странице». Задача, открытая в боковой карточке доски или списка задач, тоже подходит, а на групповой доске Keepr берёт собственный проект задачи, а не группу.
Merge request распознаётся на любой его вкладке — обзор, коммиты, пайплайны и изменения, — а также когда он открыт в боковой карточке списка merge request. Сами списки, форма нового merge request и страницы проекта не распознаются.
Дополнительных разрешений для этого расширению не нужно. Оно читает адрес и заголовок вкладки, на которой его открыли, и, только если в заголовке нет названия, — заголовок этой одной задачи или merge request (см. «Что заполняет карточка»).
Merge request и задачи не смешиваются
GitLab нумерует задачи и merge request раздельно, поэтому в проекте могут быть и задача #12, и merge request !12. Keepr записывает их так же, как GitLab: задача Keepr, созданная из merge request, получает ключ !12, а созданная из задачи — номер 12, который список задач показывает как #12. Чтобы привязать задачу вручную, введите внешний ID 12 для задачи и !12 для merge request.
По номеру они друг с другом не совпадают. Таймер на merge request !12 создаёт или переиспользует собственную задачу этого merge request, даже если у задачи #12 того же проекта уже есть своя. Исключение — merge request, про который интеграция с GitLab узнала, что он закрывает ровно одну задачу: с его страницы таймер запускается на задаче Keepr этой задачи, и время уходит в неё (см. статью об интеграции с GitLab в разделе «Интеграции»).
Задача и её рабочий элемент в GitLab — одно и то же, поэтому задача Keepr, созданная с одного адреса, находится и с другого.
Что заполняет карточка
Нажмите в карточке «Взять». В описание таймера попадают ключ и заголовок, например «!12 Add webhooks». Приставка GitLab «Draft:» — часть заголовка merge request, и она сохраняется.
Заголовок обычно берётся из заголовка вкладки. Если его там нет, Keepr запускает во вкладке один короткий скрипт. В боковой карточке он спрашивает у GitLab эту одну задачу или merge request с вашей сессией GitLab, поэтому работают и приватные проекты, а если не вышло, берёт заголовок со страницы; на собственной странице задачи или merge request он сразу берёт заголовок со стр аницы.
Если задача Keepr для этой задачи или merge request уже есть, «Взять» заполнит также её проект и задачу. Иначе карточка назовёт проект, в который попадёт новая задача, а сама задача создаётся только по нажатию «Запустить таймер».
Собственный GitLab
GitLab вашей компании работает так же, как gitlab.com, на любом адресе с HTTPS, в том числе установленный под относительным корнем вроде «https://git.example.com/gitlab». Keepr узнаёт GitLab по «/-/» в адресах, так что настраивать ничего не нужно.
Чтобы пользоваться на нём закреплённой боковой панелью, не разрешая расширению читать адреса вкладок, разрешите этот сайт, когда панель предложит, или добавьте его в настройках расширения.
Что понадобится
Расширение подключается персональным API-токеном, а он входит в тариф Ultimate. Выдайте токену области timers и projects; чтобы создавать задачи со страницы, нужны ещё запись в projects и право управлять выбранным проектом. Без них таймер всё равно запустится — только с описанием.