Поля issue отображаются в правой боковой панели выпусков, вместе с системными полями, такими как assignees, labels и type. Вы можете задавать значения при создании или редактировании выпуска. Когда вы выбираете тип проблемы при создании проблемы, любые поля, прикреплённые к этому типу, автоматически появляются в боковой панели.
Примечание.
В настоящее время поля выпусков доступны только по выпускам. Pull-запросы не поддерживают поля проблем.
Установка значения поля
- Перейдите к выпуску, который хотите обновить.
- В правой боковой панели, если нужное поле ещё не видно, нажмите «Добавить».
- В выпадающем меню выберите поле, которое хотите добавить.
- Установите значение:
- Для полей с одиночным выбором выберите опцию из выпадающего списка.
- Для текстовых полей введите своё значение. URL автоматически обнаруживаются и отображаются как ссылки.
- Для числовых полей введите числовое значение.
- Для полей даты используйте выбор даты или введите её напрямую.
- Изменения сохраняются автоматически.
Примечание.
Поля задачи в настоящее время нельзя заранее заполнить через параметры запроса URL или задать шаблоны задачи. Чтобы задать значения полей, используйте боковую панель проблем, проекты, API или GitHub Actions.
Редактирование значения поля
- Перейдите к проблеме.
- В правой боковой панели нажмите на значение поля, которое хотите изменить.
- Выберите новое значение или введите новую запись.
- Изменения сохраняются автоматически.
Очистка значения поля
- Перейдите к проблеме.
- В правой боковой панели нажмите на значение поля.
- Очистите значение:
- Для одиночных полей нажмите на выбранную опцию, чтобы снять его с выбора.
- Для текстовых и числовых полей удалите весь текст в входе.
- Для полей с датами нажмите кнопку очистки в разделе выбора даты.
- После очистки поле удаляется из боковой панели. Её можно заново добавить с помощью кнопки Add field .
Закреплённые поля
Если поля были закреплены на определенном типе проблемы администратором организации или вашими репозиториями, принадлежащими пользователю, эти поля автоматически отображаются на боковой панели и модальном создании проблемы при создании или просмотре проблемы этого типа. Вам не нужно вручную добавлять закреплённые поля.
Изменения поля просмотра в хронологии
При изменении значения поля обновление фиксируется в таймлайн выпуска. Запись в хронологии показывает:
- Какое поле было изменено
- Новое значение, которое было установлено
- Кто внес изменение
- время внесения изменения.
События временной шкалы для полей с ограничением видимости отображаются только участникам организации и участникам репозитория в репозиториях, принадлежащих организации, или владельцу репозитория и участникам совместной работы в пользовательских репозиториях.
Видимость на поле
Администраторы организации и владельцы учетных записей пользователей могут задать для каждого поля видимость "Ограниченный" или "Общедоступный". Это влияет на то, что вы видите:
- Если для поля задано значение "Ограниченный", он отображается только участникам организации и участникам совместной работы с по крайней мере доступом на чтение в репозиториях, принадлежащих организации, или владельцу репозитория и участникам совместной работы с по крайней мере доступом на чтение в пользовательских репозиториях. Если у вас нет доступа к полю, он не отображается на боковой панели проблемы, временной шкале или предложениях поиска.
- Если поле установлено как Публичное, оно видно всем, кто смотрит проблему.
Для получения дополнительной информации о настройке видимости смотрите Управление полями выпуска.
Использование тематических полей в проектах
Поля проблем можно добавлять в виде столбцов в представлениях проектов, где можно редактировать значения, группировать, фильтровать, сортировать и строить диаграммы. Дополнительные сведения см. в разделе О тематических полях в проектах.
Поиск по значениям поля
Вы можете фильтровать и искать проблемы по значениям полей как на панели вопросов, так и на странице проблем вашего репозитория. В строке поиска введите field. , затем имя поля и значение. Рассмотрим пример.
field.priority:highЧтобы найти проблемы с приоритетом, установленным на «Высокий»field."target date":>=2026-03-01чтобы найти проблемы с целевой датой на или позже 1 марта 2026 годаfield.priority:high,mediumЧтобы найти задачи с приоритетом, установленным на «Высокий» или «Средний»
Дополнительные сведения см. в разделе Фильтрация и поиск проблем и запросов на вытягивание.
Использование проблем с API
Задачи полей имеют полную поддержку REST и GraphQL API. Вы можете автоматизировать управление полями, устанавливать значения программно и интегрироваться с внешними инструментами.
- Управление полями: создание, обновление и удаление полей. См. поля REST API проблем.
- Использование полей: Получайте, устанавливайте и очищайте значения по отдельным проблемам. См. значения REST API в поле Issue.
- GraphQL: типы полей и мутации также доступны через GraphQL. См. объединение
IssueFields, объекты поля выпуска (такие какIssueFieldText,IssueFieldSingleSelect,IssueFieldNumber, иIssueFieldDate), и мутации (напримерcreateIssueField, ,updateIssueField, иsetIssueFieldValue).
Автоматизация с помощью GitHub Actions
Изменения поля проблем запускают события webhook на issues событии. Вы можете использовать их как триггеры рабочего процесса:
field_added: срабатывает при установке или обновлении значения поля.field_removed: срабатывает при очистке значения поля.
Например, чтобы запустить рабочий процесс при изменении значения поля:
on:
issues:
types: [field_added, field_removed]
Полезная нагрузка события включает имя поля, тип, значение и предыдущее значение. Дополнительные сведения см. в разделе События, инициирующие рабочие процессы.