---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
  - property: og:type
    content: article
  - property: article:section
    content: Настроить очередь
  - property: og:title
    content: Локальные поля задач
  - property: article:tag
    content: Сборник инструкций
alternate:
  - https://yandex.ru/support/tracker/en/local-fields.md
  - https://yandex.ru/support/tracker/ru/local-fields.md
  - href: ru/local-fields.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


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

Если нужно добавить в задачи новый параметр, которого нет среди системных полей в Трекере, вы можете добавить локальные поля в вашу очередь. Список системных глобальных полей можно посмотреть на странице [Настройки Трекера](https://tracker.yandex.ru/admin/fields).

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

## Создать локальное поле {#add-local-field}

{% note warning "" %}

По умолчанию настраивать очередь может [только ее владелец](https://yandex.ru/support/tracker/ru/manager/queue-access.md).

{% endnote %}

1. <!-- source: ru/_includes/transition-page.md -->
   На панели слева нажмите ![](_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/transition-page.md -->
   На странице очереди в правом верхнем углу нажмите ![](_assets/svg/settings.svg)</svg> **Настройки очереди**. {#settings}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/fields.md -->
   Перейдите на вкладку **Локальные поля**.
   <!-- endsource: ru/_includes/fields.md -->

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

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

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

    <!-- source: ru/_includes/fields.md -->
    Общие параметры:

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

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

    * **Категория**. Все поля в Трекере группируются по категориям. Начните вводить название категории, которая лучше всего подходит. Например: `Системные`, `Учёт Времени`, `Agile`, `Email`, `SLA`.
        Подробнее о полях и категориях читайте в разделе [Стандартные поля задач](https://yandex.ru/support/tracker/ru/user/create-param.md#default-fields).

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

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

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

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

    * **Значения в списке**. Укажите возможные значения поля и их порядок.
        Доступен только для поля типа «Выпадающий список». В поле «Выпадающий список» можно добавить до 3000 значений. При нажатии на поле отображается не более 10 элементов.
    <!-- endsource: ru/_includes/fields.md -->

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

<!-- source: ru/_includes/fields.md -->
Вы можете добавить ограниченное количество полей. Если вам нужно увеличить лимит, обратитесь в [службу технической поддержки](https://yandex.ru/support/tracker/ru/feedback.md).
<!-- endsource: ru/_includes/fields.md -->

## Скопировать локальное поле {#copy}

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

1. <!-- source: ru/_includes/transition-page.md -->
   На панели слева нажмите ![](_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/transition-page.md -->
   На странице очереди в правом верхнем углу нажмите ![](_assets/svg/settings.svg)</svg> **Настройки очереди**. {#settings}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/fields.md -->
   Перейдите на вкладку **Локальные поля**.
   <!-- endsource: ru/_includes/fields.md -->

1. Выберите поле и справа от него нажмите ![](_assets/svg/actions.svg)</svg> → ![](_assets/svg/copy-template.svg)</svg> **Скопировать**.

    <!-- source: ru/_includes/fields.md -->
    Откроется окно создания нового поля с уже заполненными параметрами исходного поля. Некоторые параметры нужно изменить, чтобы не было повторений: они будут подсвечены красным.
    <!-- endsource: ru/_includes/fields.md -->

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

## Редактировать локальное поле {#edit-local-field}

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

#### В настройках очереди {#edit-with-interface}

1. <!-- source: ru/_includes/transition-page.md -->
   На панели слева нажмите ![](_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/transition-page.md -->
   На странице очереди в правом верхнем углу нажмите ![](_assets/svg/settings.svg)</svg> **Настройки очереди**. {#settings}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/fields.md -->
   Перейдите на вкладку **Локальные поля**.
   <!-- endsource: ru/_includes/fields.md -->

1. Выберите поле и справа от него нажмите ![](_assets/svg/actions.svg)</svg> → ![](_assets/svg/icon-edit2.svg)</svg> **Редактировать**.

    <!-- source: ru/_includes/fields.md -->
    Откроется окно с параметрами поля: поменяйте текущее значение на новое и нажмите **Сохранить**.
    <!-- endsource: ru/_includes/fields.md -->

1. Чтобы изменить категорию локального поля, нажмите ![](_assets/svg/actions.svg)</svg> → ![](_assets/svg/move-local-field.svg) **Сменить категорию**.

    <!-- source: ru/_includes/fields.md -->
    Начните вводить название новой категории и выберите нужный вариант из списка.
    <!-- endsource: ru/_includes/fields.md -->


#### С помощью HTTP-запроса {#edit-with-api}

Также можно отредактировать свойства, категорию или видимость поля с помощью [запроса к API Яндекс Трекера на изменение локального поля](https://yandex.ru/support/tracker/api-ref/queues/edit-local-field.html).


## Удалить локальное поле {#delete-local-field}

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

1. <!-- source: ru/_includes/transition-page.md -->
   На панели слева нажмите ![](_assets/svg/queues-ni.svg) **Очереди** и выберите очередь. {#queue}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/transition-page.md -->
   На странице очереди в правом верхнем углу нажмите ![](_assets/svg/settings.svg)</svg> **Настройки очереди**. {#settings}
   <!-- endsource: ru/_includes/transition-page.md -->

1. <!-- source: ru/_includes/fields.md -->
   Перейдите на вкладку **Локальные поля**.
   <!-- endsource: ru/_includes/fields.md -->

1. Выберите поле и справа от него нажмите ![](_assets/svg/actions.svg)</svg> → ![](_assets/svg/delete.svg)</svg> **Удалить**.

Также можно настроить видимость глобального поля с помощью [запроса к API Яндекс Трекера на изменение локального поля](https://yandex.ru/support/tracker/api-ref/queues/edit-local-field.html):

<!-- source: ru/_includes/fields.md -->
- Чтобы скрыть поле, для параметра `hidden` установите значение `true`.
- Чтобы восстановить поле, для параметра `hidden` установите значение `false`.
<!-- endsource: ru/_includes/fields.md -->

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

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

* При выборе [параметра для фильтрации задач](https://yandex.ru/support/tracker/ru/user/create-filter.md#set-conditions) можно выполнить поиск локального поля только в одной очереди. Для этого перед названием поля введите [ключ очереди](*queuekey) и точку (например, `DEVS.Тестировщик`). Это поможет избежать путаницы, если в разных очередях вы используете локальные поля с одинаковыми названиями.

* Чтобы искать задачи по локальному полю с помощью [языка запросов](https://yandex.ru/support/tracker/ru/user/query-filter.md), введите ключ очереди, точку и название поля на русском или английском языке. Затем добавьте двоеточие и значение локального поля. Например: `DEVS.Тестировщик: "Иван Иванов"`. Если название поля состоит из нескольких слов, укажите название в кавычках.

* При [переносе](https://yandex.ru/support/tracker/ru/user/move-ticket.md) и [копировании](https://yandex.ru/support/tracker/ru/user/clone.md) задачи с локальными полями в другую очередь значения локальных полей будут удалены.

* При использовании [макросов](https://yandex.ru/support/tracker/ru/manager/create-macroses.md), [триггеров](https://yandex.ru/support/tracker/ru/user/create-trigger.md) или [автодействий](https://yandex.ru/support/tracker/ru/user/create-autoaction.md), чтобы подставить значение локального поля в [комментарий](https://yandex.ru/support/tracker/ru/user/set-action.md#create-comment), [формулу](https://yandex.ru/support/tracker/ru/user/set-action.md#section_calc_field) или [HTTP-запрос](https://yandex.ru/support/tracker/ru/user/set-action.md#create-http) с помощью [переменной](https://yandex.ru/support/tracker/ru/user/vars.md#local-fields), используйте формат записи `{{issue.local.<ключ_поля>}}`.

[*queuekey]: Ключ очереди — это уникальный код очереди из латинских букв, например `TEST`. Ключ содержится в ссылке на очередь и ее задачи, его нужно указывать в API-запросах и в настройках автодействий. Изменить ключ после создания очереди нельзя.