Локальные поля задач
Если требуется добавить в задачи новый параметр, которого нет среди существующих в Tracker полей, вы можете добавить локальные поля в вашу очередь.
Примечание
Список существующих глобальных полей можно посмотреть на странице Настройки Tracker.
Локальное поле можно использовать только в задачах той очереди, к которой оно привязано. Преимущество локальных полей в том, что владелец очереди может управлять такими полями без риска повлиять на процессы работы в других очередях. Пользователи, которые работают в других очередях, не будут видеть это поле в своих задачах.
Добавить локальное поле
Внимание
По умолчанию настраивать очередь может только ее владелец.
-
Откройте страницу очереди.
-
Слева от имени очереди выберите
→ Администрирование.
-
Перейдите на вкладку Поля очереди.
-
Нажмите кнопку Создать поле.
-
Выберите тип поля и нажмите кнопку Продолжить.
-
Задайте параметры нового поля:
-
Категория. Все поля в Tracker сгруппированы по категориям. Выберите категорию, которая лучше всего подходит для нового поля.
-
Название. Старайтесь давать полям короткие и емкие названия.
-
Название на английском языке. Это название видно в английском интерфейсе Tracker.
-
Тип чисел (только для полей типа
число
). -
Значения списка (только для полей типа
выпадающий список
) — укажите возможные значения и их порядок. -
Количество значений в списке (только для полей типа
выпадающий список
). -
Количество сотрудников (только для полей типа
выбор сотрудников
).
-
-
Нажмите кнопку Создать.
Редактировать локальное поле
Редактирование параметров локального поля через веб-интерфейс Tracker не поддерживается. Для этого можно использовать Yandex Tracker API.
Ограничения локальных полей
Особенности использования локальных полей
-
Для поиска задач по локальному полю с помощью языка запросов нужно указать очередь перед ключом или названием поля.
-
При переносе и клонировании задачи с локальными полями в другую очередь значения локальных полей будут удалены.
-
При использовании макросов, триггеров или автодействий, чтобы подставить значение локального поля в комментарий, формулу или HTTP-запрос с помощью переменной, используйте формат записи
{{issue.local.<ключ поля>}}
.
Где нельзя использовать локальные поля
Локальные поля временно не поддерживаются в некоторых сценариях работы с задачами. Поддержка этих сценариев будет добавлена позже.
-
При создании доски задач не получится настроить автоматическое добавление задач по значению локального поля. Это условие можно будет добавить позже, на странице редактирования доски с помощью языка запросов.
-
На доске задач локальные поля не отображаются на карточках.
-
Локальные поля нельзя использовать в правилах SLA.
-
Значения локальных полей нельзя изменять с помощью групповых операций.
Как обращаться к локальным полям через API
При работе с локальными полями через API Tracker доступно два типа действий:
-
Присвоить значение локальному полю.
Чтобы получить или изменить значение локального поля в задаче через API, в теле запроса укажите его идентификатор в формате
603fb94c38bbe658d04da2e6--<ключ поля>: "<новое значение локального поля>"
.Чтобы узнать идентификатор локального поля, выполните запрос, который позволяет получить список локальных полей в определенной очереди.
-
Изменить параметры локального поля, например название, описание, или множество доступных значений поля. Подробнее в справочнике API Tracker.