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

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

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

Ключ поля вводится вручную (кроме Redmine и Bitrix24). Список полей трекера приложение собирает автоматически только для Redmine и Bitrix24 — там поле можно выбрать. Для остальных коннекторов выбора из списка нет: ID или ключ поля нужно найти в трекере (инструкции ниже) и ввести в карточке коннектора вручную.

Taiga: произвольные атрибуты (custom attributes) в самом Taiga есть, но приложение с ними не работает — ни пробег в задачу, ни центр геозоны по адресу через них не проходят. Пробег при этом считается и хранится в Taskloc, виден в отчётах.

GitHub и Linear: произвольных полей задачи, пригодных для пробега и адреса, у них нет (у GitHub поля живут на карточке доски Projects, а не на самой задаче). Пробег остаётся в отчётах Taskloc, центр геозоны ставится вручную на карте.

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

Bitrix24: создавать произвольные поля в задачах портал разрешает только с тарифа «Профессиональный» и выше. На Базовом и Стандартном полей нет — соответственно нет и записи пробега в задачу, и авто-центра геозоны по адресу. Это ограничение Битрикс24, а не Taskloc; что остаётся доступно — раздел «Если тариф ниже Профессионального».

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

Redmine

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

Yandex Tracker

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

Bitrix24

⚠️ Требуется тариф «Профессиональный» или выше. На младших тарифах пункт создания поля недоступен — Битрикс24 предложит перейти на тариф или включить демо на 15 дней.

1. Откройте любую задачу и в её карточке выберите Пользовательские поля → Добавить поле.
2. Для пробега добавьте поле типа «Дробное число». Для адреса — «Строка».
3. Сохраните. Системное имя поля в формате UF_AUTO_xxxxxxxxxx отображается в списке.

Про демо-период. Поле, созданное во время демо на 15 дней, после его окончания исчезает с портала, а введённый в приложении ключ поля остаётся — запись пробега будет отклоняться трекером. Если демо закончилось, очистите ключи полей в карточке интеграции либо перейдите на тариф «Профессиональный».

OpenProject

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

Jira Cloud

1. Откройте Settings (шестерёнка) → Issues → Custom fields.
2. Create custom field: для пробега — тип Number, для адреса — Text field (single line).
3. Привяжите поле к нужным экранам (screens) проекта, иначе оно не появится в задаче.
4. Идентификатор вида customfield_10042 виден в URL страницы настройки поля (.../ConfigureCustomField!default.jspa?customFieldId=**10042** → ключ customfield_10042).

Kaiten

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

Если тариф ниже Профессионального

Относится к Bitrix24: произвольных полей в задачах на Базовом и Стандартном тарифах нет. Что при этом работает и что делать:

Остальные возможности коннектора от тарифа не зависят — задачи, смена статуса, комментарии, учёт времени, вложения и отметка о прибытии на объект работают на любом тарифе.

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

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

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

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

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

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

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

Отображение

В карточке коннектора (Настройки → Интеграции → ваш трекер) есть раздел «Отображение» с настройками интерфейса. Они задаются отдельно для каждого коннектора.

Inline-правка полей задачи в карточке (заголовок, описание, статус и т.д.) по умолчанию выключена; переключателя «Редактирование задачи в приложении» в этом разделе больше нет. Завершение задачи (выбор статуса и комментарий при остановке GPS-сессии или таймера) работает всегда.

Отправка клиенту (RedmineUP Helpdesk)

Если на сервере Redmine установлен плагин Helpdesk, в форме комментария и в окне завершения задачи появляется переключатель «Отправить клиенту». При его включении под переключателем показывается получатель — контакт/ящик, на который уйдёт сообщение (определяется по контакту тикета на стороне сервера).