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

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

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

Создать локальное поле

1. На панели слева нажмите  Очереди и выберите очередь.

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

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

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

   

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

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

   Общие параметры:

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

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

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

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

   Специальные параметры:

   • Множественный выбор. Включите эту опцию, и пользователь сможет ввести несколько значений поля.
     Доступен только для полей типов «Список пользователей» и «Выпадающий список».

   • Тип поля. Задайте формат значения поля.
     Доступен только для полей типов «Число», «Дата» и «Поле ввода».

   • Значения в списке. Укажите возможные значения поля и их порядок.
     Доступен только для поля типа «Выпадающий список». В поле «Выпадающий список» можно добавить до 3000 значений. При нажатии на поле отображается не более 10 элементов.

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

Вы можете добавить ограниченное количество полей. Если вам нужно увеличить лимит, обратитесь в службу технической поддержки.

Типы локальных полей

Тип поля выбирается при создании. Он определяет, какие значения можно ввести в задаче и какие параметры доступны в настройках.

Общие параметры всех типов полей — название, категория и ключ — описаны в разделе Создать локальное поле. Чтобы запретить редактирование значения или всегда показывать поле в задаче, измените параметры readonly и visible с помощью запроса к API Яндекс Трекера. Названия типов для API перечислены в запросе на создание локального поля. Форматы значений полей в запросах к API описаны в разделе Локальные поля.

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

Чтобы создать копию уже существующего локального поля:

1. На панели слева нажмите  Очереди и выберите очередь.

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

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

4. Выберите поле и справа от него нажмите  →  Скопировать.

   Откроется окно создания нового поля с уже заполненными параметрами исходного поля. Некоторые параметры нужно изменить, чтобы не было повторений: они будут подсвечены красным.

5. Нажмите Создать.

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

Вы можете изменить свойства локального поля несколькими способами.

В настройках очереди

1. На панели слева нажмите  Очереди и выберите очередь.

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

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

4. Выберите поле и справа от него нажмите  →  Редактировать.

   Откроется окно с параметрами поля: поменяйте текущее значение на новое и нажмите Сохранить.

5. Чтобы изменить категорию локального поля, нажмите  →  Сменить категорию.

   Начните вводить название новой категории и выберите нужный вариант из списка.

С помощью HTTP-запроса

Также можно отредактировать свойства, категорию или видимость поля с помощью запроса к API Яндекс Трекера на изменение локального поля.

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

Удалить локальное поле невозможно, но можно скрыть его из интерфейса Трекера. Скрытое поле нельзя добавить в задачу.

1. На панели слева нажмите  Очереди и выберите очередь.

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

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

4. Выберите поле и справа от него нажмите  →  Удалить.

Также можно настроить видимость глобального поля с помощью запроса к API Яндекс Трекера на изменение локального поля:

• Чтобы скрыть поле, для параметра hidden установите значение true.
• Чтобы восстановить поле, для параметра hidden установите значение false.

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

Локальные поля используются так же, как и глобальные, но есть особенности, которые стоит учитывать:

• При выборе параметра для фильтрации задач можно выполнить поиск локального поля только в одной очереди. Для этого перед названием поля введите ключ очереди и точку (например, DEVS.Тестировщик). Это поможет избежать путаницы, если в разных очередях вы используете локальные поля с одинаковыми названиями.

• Чтобы искать задачи по локальному полю с помощью языка запросов, введите ключ очереди, точку и название поля на русском или английском языке. Затем добавьте двоеточие и значение локального поля. Например: DEVS.Тестировщик: "Иван Иванов". Если название поля состоит из нескольких слов, укажите название в кавычках.

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

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