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

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

Кто может использовать эту функцию?

People with triage access or greater to a repository can set and edit issue field values.

В этой статье

Примечание.

Поля проблемы сейчас находятся в public preview и могут измениться. Чтобы поделиться отзывами, смотрите обсуждение сообщества.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для получения дополнительной информации о настройке видимости смотрите АВТОЗАГОЛОВОК.

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

Поля проблем можно добавлять в виде столбцов в представлениях проектов, где можно редактировать значения, группировать, фильтровать, сортировать и строить диаграммы. Дополнительные сведения см. в разделе О тематических полях в проектах.

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

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

  •         `field.priority:high` Чтобы найти проблемы с приоритетом, установленным на «Высокий»

  •         `field."target date":>=2026-03-01` чтобы найти проблемы с целевой датой на или позже 1 марта 2026 года

  •         `field.priority:high,medium` Чтобы найти задачи с приоритетом, установленным на «Высокий» или «Средний»

Дополнительные сведения см. в разделе Фильтрация и поиск проблем и запросов на вытягивание.

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

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

  •         **Управление полями**: Создавайте, обновляйте и удаляйте поля на уровне организации. См. [поля вопросов организации REST](/rest/orgs/issue-fields) API.

  •         **Использование полей**: Получайте, устанавливайте и очищайте значения по отдельным проблемам. См. [значения REST API в поле Issue](/rest/issues/issue-field-values).