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

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

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

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

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

2. В правом верхнем углу страницы нажмите Настройки очереди.

3. Перейдите на вкладку Локальные поля.

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

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

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

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

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

   • Ключ генерируется автоматически по названию на английском.

   • Категория. Все поля в Tracker группируются по категориям. Начните набирать первые буквы предполагаемой категории и выберите из списка ту, что лучше всего подходит. Например: Системные, Учёт Времени, Agile, Email, SLA.

     Подробнее о полях и категориях читайте в разделе Стандартные поля задач.

   • Множественный выбор (только для полей типа «Список пользователей», «Выпадающий список», «Поле ввода»).

   • Тип поля (только для полей типа «Число», «Дата», «Поле ввода»).

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

7. Нажмите кнопку Создать поле. Появится всплывающее уведомление «Новое локальное поле успешно сохранено», а новое поле добавится в список.

Локальные поля можно переносить в другие категории. Для этого нажмите справа от описания поля в списке и введите название категории назначения.

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

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

Удалить локальное полеУдалить локальное поле

Локальное поле удалить невозможно.

Скрыть локальное поле в интерфейсе вы можете с помощью Yandex Tracker API. Для этого установите следующие значения параметров: "visible": false, "hidden": true.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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