Toggl, Clockify, Harvest, Everhour и TimeCamp: часы, которые попадают в задачу

SLAtech Vantage забирает часы из Toggl Track, Clockify, Harvest, Everhour и TimeCamp раз в сутки. Запись попадает в задачу только тогда, когда в её описании указан номер задачи, например #412 или PROJ-45, и каждая строка хранит ставку, действовавшую в момент поступления. Запись без номера не теряется: она ждёт в списке непривязанных часов. История часов из Excel импортируется отдельно.

Как запись находит свою задачу

Трекер времени не знает задач SLAtech Vantage, поэтому тот, кто записывает время, указывает связь в описании записи:

• #412 указывает на задачу 412 в SLAtech Vantage;
• PROJ-45 или SR-3336 указывает на задачу с таким номером тикета.

Число без # или без префикса ссылкой не считается: "два часа на странице 412" это описание, а не задача. Ссылка должна существовать в самом проекте, а если в описании две ссылки, берётся первая существующая.

Запись без задачи и запись не для счёта

Запись, для которой задача не нашлась, попадает в список непривязанных часов проекта вместе с причиной: ссылку не указали или указали ссылку на несуществующую задачу. Оттуда её можно привязать вручную или дописать номер в самом трекере, и следующая синхронизация перенесёт её в задачу.

Запись, отмеченная в трекере как не для счёта, не загружается, а уже загруженная и отмеченная так позже снимается. В Everhour такой отметки нет, поэтому все часы из него считаются оплачиваемыми.

Ставка, зафиксированная в момент записи

Каждая строка часов хранит свою ставку. Она определяется в момент поступления записи: это ставка организации, которая записала время в проекте, а если её нет, ставка задачи. Смена ставки потом не меняет уже поступившие часы.

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

Удалённая запись и что видит клиент

В Toggl Track, Clockify, Everhour и TimeCamp запись, удалённая в трекере, удаляется и в SLAtech Vantage, кроме сданных или принятых месяцев. Защиты две: пустой ответ ничего не удаляет, а удаление больше половины записей за период отменяется целиком. В Harvest удаление не распознаётся, потому что он отдаёт записи по дате их изменения.

В портале клиент видит часы по задачам и их сумму в месячном отчёте. Это ровно те же выставленные часы, только без внутренней раскладки.

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

Для каждой системы нужно немного:

• Toggl Track: идентификатор рабочего пространства и API-токен;
• Clockify: идентификатор рабочего пространства и API-ключ;
• Harvest: идентификатор аккаунта и персональный токен доступа;
• Everhour: API-ключ;
• TimeCamp: API-токен.

Ключи хранятся в зашифрованном виде и больше не показываются. Интеграции работают только на чтение: SLAtech Vantage не пишет часы в трекер. Экран источников проекта сейчас открыт только оператору системы, поэтому подключение выполняется через нас.

История из Excel: историю работ можно импортировать из книги Excel с постоянной структурой, по листу на месяц, с датой, описанием, временем и суммой. Импорт выполняет команда SLAtech Vantage. Он проходит целиком или не проходит вовсе, а повторный запуск добавляет только недостающие строки. Суммы сохраняются такими, как в файле.

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