Поля проблем позволяют добавлять структурированные метаданные в проблемы в репозиториях. Вместо того чтобы полагаться на метки или обходные пути свободного текста, вы можете создавать поля вроде приоритета, усилия, воздействия или любую пользовательскую категорию, нужную вашей команде. Поля определяются на уровне организации или пользователя и применяются ко всем репозиториям.
О типах полей вопросов
Можно создать до 25 полей проблем. Доступные типы перечислены в следующей таблице.
- Одиночный выбор: выберите один вариант из заранее определённого списка. Опции могут содержать имена, описания и цвета.
- Текст: захват свободного текста. URL-адреса автоматически определяются и отображаются как кликабельные ссылки.
- Число: принимать числовые данные, включая десятичные.
- Дата: предоставите выбор даты для выбора даты.
Поля по умолчанию
При включении полей проблем четыре поля по умолчанию создаются автоматически:
- Приоритет (одиночный выбор): Срочно, Высокий, Средний, Низкий
- Усилие (одиночный выбор): Высокий, Средний, Низкий
- Дата начала работы (дата)
- Целевая дата (дата)
Эти поля по умолчанию закреплены по типам выпусков следующим образом:
| Field | Тип отсутствует | Bug | Задача | Feature |
|---|---|---|---|---|
| Priority | ||||
| Effort | ||||
| Начальная дата | ||||
| Целевая дата |
Эти стандартные поля полностью настраиваемы. Вы можете редактировать их имена, описания и опции или удалить их, если они не подходят вашему рабочему процессу.
Совет
Вы можете переименовывать опции, менять их цвета, порядоваться или добавлять новые значения, чтобы соответствовать рабочему процессу вашей команды. Например, вы можете изменить параметры Effort на размеры футболок (XS, S, M, L, XL).
Создание поля задачи
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите поле «Проблема».
- Щелкните Создать поле.
- В разделе «Название поля» введите название нового поля.
- По желанию, в разделе «Описание» введите описание, чтобы помочь другим понять назначение этой области.
- В разделе «Тип поля» выберите тип поля, который хотите создать.
- Если вы выбрали Single-select, добавьте опции для поля:
- Нажмите опцию «Добавить » и введите название опции.
- По необходимости, чтобы установить цвет для опции, нажмите рядом с этой опцией, выберите опцию Редактировать, выберите цвет и нажмите Сохранить.
- Повторяйте, чтобы добавить больше вариантов.
- В разделе «Поле видимости» выберите один из следующих вариантов:
- Разрешения: выбирайте, кто может видеть поле и его значение. Параметры ограничены ( по умолчанию) или общедоступными. Эта настройка применяется только к проблемам в публичных репозиториях.
- Закрепить типы: нажмите , чтобы выбрать, какие типы выпусков показывают это поле в просмотрщике и создателе выпусков. Выберите один или несколько типов проблем, или «Проблемы без типа». Поля, которые не закреплены и не имеют значения, останутся скрытыми в просмотрщике и создателе задачи.
- Нажмите кнопку Создать.
Редактирование поля проблемы
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите поле «Проблема».
- Справа от нужного поля нажмите .
- Нажмите «Редактировать » и внесите изменения.
- Нажмите поле «Сохранить».
Удаление поля проблемы
Когда вы удаляете поле проблемы, все значения, установленные для этого поля, навсегда удаляются.
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите поле «Проблема».
- Справа от нужного поля нажмите .
- Нажмите «Удалить» и подтвердите удаление.
Совет
Если вы не хотите использовать поля проблем, вы можете удалить все поля по умолчанию из параметров. Это удаляет их из всех проблем. Вы можете воссоздать поля в любое время.
Изменение порядка полей выпуска
Порядок закреплённых полей управляется по типу выпуска. Порядок полей определяет, как поля отображаются в боковой панели проблемы и модале создания проблем.
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите «Типы проблем».
- Нажмите на тип выпуска, по которому хотите изменить порядок полей.
- В разделе «Закреплённые поля выпуска» перетаскивайте поля, чтобы изменить их порядок.
- Нажмите кнопку Сохранить.
Закрепление полей для типов выпусков
Вы можете связывать поля проблем с определёнными типами задач, чтобы при создании или просмотре выпусков этого типа появлялись только наиболее релевантные. Например, можно прикрепить «Серьёзность» к багам и «Влияние» к признакам.
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите поле «Проблема».
- Нажмите на нужное поле для закрепления.
- В разделе «Закрепить типы» нажмите и выберите типы проблем, на которых должно появиться это поле.
- Нажмите поле «Сохранить».
Закреплённые поля автоматически появляются в боковой панели выпуска в зависимости от выбранного типа. Чтобы прикрепить поля к проблемам без типа, выберите опцию «Проблемы без типа».
Примечание.
Поля должны быть закреплены хотя бы на один тип выпуска или на «Проблемы без типа», чтобы отображаться в боковой панели проблем. Поля, не привязанные ни к одному типу, доступны только через кнопку «Добавить» поле или в проектах.
Если поле не отображается в ваших выпусках, проверьте, закреплено ли оно на соответствующий тип задачи или на «Проблемы без типа». Поля, которые не закреплены и не имеют установленного значения, скрыты в боковой панели проблем.
Настройка видимости поля
Для организаций или профилей пользователей с общедоступными репозиториями можно контролировать, отображается ли каждое поле проблемы всем или только членам, владельцам репозиториев и участникам совместной работы.
- В разделе имени организации или профиля пользователя нажмите кнопку "Параметры".
- В разделе «Планирование» боковой панели нажмите поле «Проблема».
- Справа от поля нажмите .
- Нажмите Изменить.
- В разделе «Поле видимости» выберите один из следующих вариантов:
- Ограниченное: поле отображается только участникам организации и участникам репозитория с по крайней мере доступом на чтение в репозиториях организации, или владельцу репозитория и участникам совместной работы с по крайней мере доступом на чтение в личных репозиториях.
- Общественность: поле видно каждому, кто смотрит этот вопрос.
- Нажмите кнопку Сохранить.
По умолчанию все новые и существующие поля имеют значение "Ограниченный". Настройки видимости применяются в веб-интерфейсе, API, событиях таймлайна выданий и поисковых предложениях.
Области вопросов и проекты
Поля проблем доступны в любом проекте в организации или профиле пользователя, включая общедоступные и внутренние проекты. Подробности о добавлении, удалении и редактировании полей проблем в проектах см. О тематических полях в проектах.
Видимость в публичных и внутренних проектах
В публичных и внутренних проектах доступны только области с публичной видимостью. Поля, для которых задано значение "Ограниченный", не отображаются. При добавлении полей в публичный проект в диалоге добавления появляются только поля публичной видимости.
Если видимость поля изменяется с "Public" на "Ограниченный" во время использования в общедоступном проекте, поле автоматически удаляется из проекта. Чтобы восстановить его, измените видимость поля обратно на «Публично».
Переход из проектных полей в задачи
Если вы уже используете пользовательские поля на уровне проекта для метаданных, таких как приоритет или усилия, вы можете использовать поля задачи для централизации этих значений на уровне задачи.
- Поля проблем — источник истины. Ценность живёт в этом вопросе и последовательно во всех проектах, к которым он принадлежит.
- Project Fields охватывают один проект. Одна и та же проблема может иметь разные ценности полей проектов в разных проектах.
- Оба способны сосуществовать. Не обязательно сразу удалять поля проекта, но наличие обоих может вызвать путаницу, если они отслеживают одну и ту же концепцию (например, два поля «Приоритет»).
- Для миграции создайте аналогичное поле задачи, а затем уберите поле на уровне проекта из представлений проекта, когда команда будет готова.
Пределы полей в проектах
Проекты поддерживают до 50 полей, и поля задач и системы засчитываются в этот лимит. Если проект уже достиг лимита полей, нужно удалить существующие поля, прежде чем можно будет добавить поля выпуска.
Limits
| Resource | Limit |
|---|---|
| Области выпусков | 25 |
| Опции для каждого поля с одиночным выбором | 100 |
| Закреплённые поля по типу выпуска | 10 |
| Общее количество полей в проекте (включая задачи и системные поля) | 50 |