Skip to main content

Enterprise Server 3.23 в настоящее время доступен в качестве кандидата на выпуск.

Skip to content

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

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

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

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

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

Примечание.

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

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

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

Примечание.

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

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

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

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

  1. Перейдите к проблеме.
  2. В правой боковой панели нажмите на значение поля.
  3. Очистите значение:
    • Для одиночных полей нажмите на выбранную опцию, чтобы снять его с выбора.
    • Для текстовых и числовых полей удалите весь текст в входе.
    • Для полей с датами нажмите кнопку очистки в разделе выбора даты.
  4. После очистки поле удаляется из боковой панели. Её можно заново добавить с помощью кнопки 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]

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