# Добавление и управление полями проблем

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

Поля issue отображаются в правой боковой панели выпусков, вместе с системными полями, такими как assignees, labels и type. Вы можете задавать значения при создании или редактировании выпуска. Когда вы выбираете тип проблемы при создании проблемы, любые поля, прикреплённые к этому типу, автоматически появляются в боковой панели.

> \[!NOTE]
> В настоящее время поля выпусков доступны только по выпускам. Pull-запросы не поддерживают поля проблем.

## Установка значения поля

1. Перейдите к выпуску, который хотите обновить.
2. В правой боковой панели, если нужное поле ещё не видно, нажмите «**Добавить».**
3. В выпадающем меню выберите поле, которое хотите добавить.
4. Установите значение:
   * Для **полей с одиночным выбором** выберите опцию из выпадающего списка.
   * Для **текстовых** полей введите своё значение. URL автоматически обнаруживаются и отображаются как ссылки.
   * Для **числовых** полей введите числовое значение.
   * Для полей **даты** используйте выбор даты или введите её напрямую.
5. Изменения сохраняются автоматически.

> \[!NOTE]
> Поля задачи в настоящее время нельзя заранее заполнить через параметры запроса URL или задать шаблоны задачи. Чтобы задать значения полей, используйте боковую панель проблем, проекты, API или GitHub Actions.

## Редактирование значения поля

1. Перейдите к проблеме.
2. В правой боковой панели нажмите на значение поля, которое хотите изменить.
3. Выберите новое значение или введите новую запись.
4. Изменения сохраняются автоматически.

## Очистка значения поля

1. Перейдите к проблеме.
2. В правой боковой панели нажмите на значение поля.
3. Очистите значение:
   * Для **одиночных полей** нажмите на выбранную опцию, чтобы снять его с выбора.
   * Для **текстовых** и **числовых** полей удалите весь текст в входе.
   * Для полей **с датами** нажмите кнопку очистки в разделе выбора даты.
4. После очистки поле удаляется из боковой панели. Её можно заново добавить с помощью кнопки **Add field** .

## Закреплённые поля

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

## Изменения поля просмотра в хронологии

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

* Какое поле было изменено
* Новое значение, которое было установлено
* Кто внес изменение
* время внесения изменения.

События таймлайна для полей, установленных в виде «Только для организации», скрыты от пользователей, не являющихся членами организации или не соавторами.

## Видимость на поле

Администраторы организаций могут установить видимость каждого поля на «Только для организации» или «Публично». Это влияет на то, что вы видите:

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

Для получения дополнительной информации о настройке видимости смотрите [Управление областями вопросов в вашей организации](/ru/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility).

## Использование тематических полей в проектах

Поля проблем можно добавлять в виде столбцов в представлениях проектов, где можно редактировать значения, группировать, фильтровать, сортировать и строить диаграммы. Дополнительные сведения см. в разделе [О тематических полях в проектах](/ru/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields).

## Поиск по значениям поля

Вы можете фильтровать и искать проблемы по значениям полей как на панели вопросов, так и на странице проблем вашего репозитория. В строке поиска введите `field.` , затем имя поля и значение. Рассмотрим пример.

* `field.priority:high` Чтобы найти проблемы с приоритетом, установленным на «Высокий»
* `field."target date":>=2026-03-01` чтобы найти проблемы с целевой датой на или позже 1 марта 2026 года
* `field.priority:high,medium` Чтобы найти задачи с приоритетом, установленным на «Высокий» или «Средний»

Дополнительные сведения см. в разделе [Фильтрация и поиск проблем и запросов на вытягивание](/ru/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests).

## Использование проблем с API

Задачи полей имеют полную поддержку REST и GraphQL API. Вы можете автоматизировать управление полями, устанавливать значения программно и интегрироваться с внешними инструментами.

* **Управление полями**: Создавайте, обновляйте и удаляйте поля на уровне организации. См. [поля вопросов организации REST](/ru/rest/orgs/issue-fields) API.
* **Использование полей**: Получайте, устанавливайте и очищайте значения по отдельным проблемам. См. [значения REST API в поле Issue](/ru/rest/issues/issue-field-values).
* **GraphQL**: типы полей и мутации также доступны через GraphQL. См. [объединение`IssueFields`](/ru/graphql/reference/issues#union-issuefields), [объекты поля](/ru/graphql/reference/issues#object-issuefieldtext) выпуска (такие как `IssueFieldText`, `IssueFieldSingleSelect`, `IssueFieldNumber`, и `IssueFieldDate`), и [мутации](/ru/graphql/reference/issues#mutation-createissuefield) (например`createIssueField`, , `updateIssueField`, и `setIssueFieldValue`).

## Автоматизация с помощью GitHub Actions

Изменения поля проблем запускают события webhook на `issues` событии. Вы можете использовать их как триггеры рабочего процесса:

* `field_added`: срабатывает при установке или обновлении значения поля.
* `field_removed`: срабатывает при очистке значения поля.

Например, чтобы запустить рабочий процесс при изменении значения поля:

```yaml
on:
  issues:
    types: [field_added, field_removed]
```

Полезная нагрузка события включает имя поля, тип, значение и предыдущее значение. Дополнительные сведения см. в разделе [События, инициирующие рабочие процессы](/ru/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues).