Произвольные поля задачи

Taskloc умеет читать и писать произвольные (кастомные) поля задач в трекере. Поддерживаются два сценария:

Сценарий	Что делает
Поле пробега	При остановке GPS-сессии приложение прибавляет расстояние маршрута к числовому полю задачи в трекере. Накапливается суммарный пробег по задаче.
Поле адреса	При создании геозоны (привязке объекта к задаче) приложение читает текстовое поле и предлагает координату как центр пина. Исключает ручной поиск на карте.

Поддержка по коннекторам

Коннектор	Пробег	Адрес / геозона	Тип ключа
Redmine	✅	✅	Числовой ID (`34`)
Yandex Tracker	✅	✅	Строковый ключ (`localField1`)
Bitrix24	✅	✅	Имя UF-поля (`UF_AUTO_1234567890`)
Kaiten	⚠️ бета	⚠️ бета	Строковый ключ карточки
OpenProject	✅	✅	Числовой ID (`1`)

Kaiten: API произвольных свойств карточки находится в тестировании. Запись пробега в Kaiten работает в режиме best-effort (сохраняется в Taskloc, но в трекер не передаётся при ошибке API).

Как создать поле и найти его ID / ключ

Redmine

Откройте Администрирование → Настройка → Произвольные поля.
Нажмите Новое произвольное поле → Для задач.
Для поля пробега выберите тип «Число с плавающей точкой» (float).
Для поля адреса выберите тип «Строка» (string).
Сохраните. ID поля отображается в URL страницы редактирования: .../custom_fields/**34**/edit → ID = 34.

Yandex Tracker

Перейдите в Настройки очереди → Поля задачи → Создать поле.
Для пробега: тип «Число» (integer или float). Для адреса: тип «Текст».
Сохраните. Ключ поля (localField1, localField2, ...) отображается в списке полей очереди рядом с именем.

Bitrix24

Откройте Администрирование → Настройки CRM → Пользовательские поля задач. (Путь может отличаться в зависимости от версии: Администрирование → Настройки → Поля.)
Для пробега добавьте поле типа «Дробное число». Для адреса — «Строка».
Сохраните. Системное имя поля в формате UF_AUTO_xxxxxxxxxx отображается в списке.

OpenProject

Откройте Администрирование → Настройки → Произвольные поля.
Нажмите Создать новое произвольное поле.
Для пробега выберите тип «Float». Для адреса — «Text».
Привяжите поле к нужным типам задач (Work Package types).
ID поля отображается в URL: .../custom_fields/**1**/edit → ID = 1.

Kaiten

Откройте Настройки доски → Поля карточки.
Добавьте числовое свойство (пробег) или текстовое (адрес).
Ключ свойства отображается в URL настройки или в API-ответе.

Формат поля адреса

В поле адреса можно хранить:

Текстовый адрес — например «ул. Ленина, 1, Челябинск». Приложение выполнит прямое геокодирование через OpenStreetMap Nominatim.
Готовые координаты — «55.1545,61.3680» (широта первой, WGS-84, через запятую). Центр пина проставляется без запроса к геокодеру — быстрее и точнее.

При отсутствии сети или нераспознанном адресе приложение молча использует текущее местоположение как центр пина — ошибка не показывается.

Настройка в приложении

Перейдите в Настройки → Интеграции → ваш трекер.
В разделе «Произвольные поля» введите:
- ID поля пробега (Redmine / OpenProject) или Ключ поля пробега (остальные)
- ID поля адреса / Ключ поля адреса
Изменения сохраняются при потере фокуса поля ввода.

Если вы впервые настраиваете поле — создайте его в трекере, запустите хотя бы одну GPS-сессию (маршрут должен быть ненулевым), остановите. Откройте задачу в трекере и проверьте, что поле обновилось.

Произвольные поля (пробег и адрес)

Произвольные поля задачи