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

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

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

Ключ поля вводится вручную (кроме monday.com). У monday.com "Колонка пробега" и "Колонка адреса" выбираются из колонок "Доски по умолчанию" — см. monday.com → Колонки доски. Для остальных коннекторов, включая Redmine и Bitrix24, выбора из списка для пробега и адреса нет: ID или ключ поля нужно найти в трекере (инструкции ниже) и ввести в карточке коннектора вручную. Выбор из списка ("Выбрать поле") есть только в соседнем разделе "Поле трекера".

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

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

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

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

Asana: произвольные поля доступны только на платных тарифах Asana (Starter и выше). На бесплатном Personal нет ни пробега в задачу, ни авто-центра геозоны по адресу — пробег остаётся в отчётах Taskloc, центр геозоны ставится вручную. В настройках вводится gid поля, и поле должно быть добавлено в проект задачи.

Trello: адрес лежит прямо в карточке, поэтому ключа поля адреса в настройках нет; но центр геозоны по нему приложение пока не подставляет — он ставится вручную на карте. Пробег в карточку не пишется: для него нужно произвольное поле (у Trello — с тарифа Standard), а их запись приложение пока не поддерживает. Пробег остаётся в отчётах Taskloc.

monday.com и ClickUp: поля заводятся в трекере вручную, тарифом не ограничены. В monday.com адрес — колонка типа Location, пробег — числовая колонка; в ClickUp адрес — поле типа location, пробег — number. С полем другого типа запись не сработает. В monday.com адрес и пробег пишутся только в задачи выбранной доски — у каждой доски свои колонки.

Как создать поле и найти его 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. ID поля показан в колонке ID списка (#623463). В приложение вводится только число, без #: 623463.

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

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

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

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

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

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

При отсутствии сети или нераспознанном адресе приложение молча берёт центр пина из ваших отметок по этой задаче (если их три и больше), иначе — последнее известное местоположение; ошибка не показывается.

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

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

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

Отображение

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

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

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

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