Локальные поля задач

Если требуется добавить в задачи новый параметр, которого нет среди существующих в Tracker полей, вы можете добавить локальные поля в вашу очередь.

Локальное поле можно использовать только в задачах той очереди, к которой оно привязано. Преимущество локальных полей в том, что владелец очереди может управлять такими полями без риска повлиять на процессы работы в других очередях. Пользователи, которые работают в других очередях, не будут видеть это поле в своих задачах.

Добавить локальное поле

1. Откройте страницу очереди.

2. Слева от имени очереди выберите → Администрирование.

3. Перейдите на вкладку Поля очереди.

4. Нажмите кнопку Создать поле.

5. Выберите тип поля и нажмите кнопку Продолжить.

6. Задайте параметры нового поля:

   • Категория. Все поля в Tracker сгруппированы по категориям. Выберите категорию, которая лучше всего подходит для нового поля.

   • Название. Старайтесь давать полям короткие и емкие названия.

   • Название на английском языке. Это название видно в английском интерфейсе Tracker.

   • Тип чисел (только для полей типа число).

   • Значения списка (только для полей типа выпадающий список) — укажите возможные значения и их порядок.

   • Количество значений в списке (только для полей типа выпадающий список).

   • Количество сотрудников (только для полей типа выбор сотрудников).

7. Нажмите кнопку Создать.

Редактировать локальное поле

Редактирование параметров локального поля через веб-интерфейс Tracker не поддерживается. Для этого можно использовать Yandex Tracker API.

Ограничения локальных полей

Особенности использования локальных полей

• Для поиска задач по локальному полю с помощью языка запросов нужно указать очередь перед ключом или названием поля.

• При переносе и клонировании задачи с локальными полями в другую очередь значения локальных полей будут удалены.

• При использовании макросов, триггеров или автодействий, чтобы подставить значение локального поля в комментарий, формулу или HTTP-запрос с помощью переменной, используйте формат записи {{issue.local.<ключ поля>}}.

Где нельзя использовать локальные поля

Локальные поля временно не поддерживаются в некоторых сценариях работы с задачами. Поддержка этих сценариев будет добавлена позже.

• При создании доски задач не получится настроить автоматическое добавление задач по значению локального поля. Это условие можно будет добавить позже, на странице редактирования доски с помощью языка запросов.

• На доске задач локальные поля не отображаются на карточках.

• Локальные поля нельзя использовать в правилах SLA.

• Значения локальных полей нельзя изменять с помощью групповых операций.

Как обращаться к локальным полям через API

При работе с локальными полями через API Tracker доступно два типа действий:

• Присвоить значение локальному полю.

  Чтобы получить или изменить значение локального поля в задаче через API, в теле запроса укажите его идентификатор в формате 603fb94c38bbe658d04da2e6--<ключ поля>: "<новое значение локального поля>".

  Чтобы узнать идентификатор локального поля, выполните запрос, который позволяет получить список локальных полей в определенной очереди.

• Изменить параметры локального поля, например название, описание, или множество доступных значений поля. Подробнее в справочнике API Tracker.