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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Локальные поля нельзя использовать в макросах, правилах SLA, функциях перехода между статусами.

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

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

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

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

curl -X GET 'https://api.tracker.yandex.net/v2/queues/<ключ очереди>/localFields' \
-H 'Authorization: OAuth <OAuth-токен>' \
-H 'X-Org-Id: <идентификатор организации>'