Управление областями вопросов в вашей организации

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

О типах полей вопросов

В каждой организации можно создать до 25 полей для проблем. Доступные типы перечислены в следующей таблице.

• Одиночный выбор: выберите один вариант из заранее определённого списка. Опции могут содержать имена, описания и цвета.
• Текст: захват свободного текста. URL-адреса автоматически определяются и отображаются как кликабельные ссылки.
• Число: принимать числовые данные, включая десятичные.
• Дата: предоставите выбор даты для выбора даты.

Поля по умолчанию

Когда для вашей организации активированы поля проблем, автоматически создаются четыре поля по умолчанию:

• Приоритет (одиночный выбор): Срочно, Высокий, Средний, Низкий
• Усилие (одиночный выбор): Высокий, Средний, Низкий
• Дата начала работы (дата)
• Целевая дата (дата)

Эти поля по умолчанию закреплены по типам выпусков следующим образом:

Поле	Нет типа	Bug	задачи	Функция
Priority
Effort
Дата начала
Целевая дата

Эти стандартные поля полностью настраиваемы. Вы можете редактировать их имена, описания и опции или удалить их, если они не подходят вашему рабочему процессу.

Создание поля задачи

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите поле «Проблема».

5. Щелкните Создать поле.

6. В разделе «Название поля» введите название нового поля.

7. По желанию, в разделе «Описание» введите описание, чтобы помочь другим понять назначение этой области.

8. В разделе «Тип поля» выберите тип поля, который хотите создать.

9. Если вы выбрали Single-select, добавьте опции для поля:

   • Нажмите опцию «Добавить » и введите название опции.
   • По необходимости, чтобы установить цвет для опции, нажмите рядом с этой опцией, выберите опцию Редактировать, выберите цвет и нажмите Сохранить.
   • Повторяйте, чтобы добавить больше вариантов.

10. В разделе «Поле видимости» выберите один из следующих вариантов:

    • Разрешения: выбирайте, кто может видеть поле и его значение. Опции: Только организация (по умолчанию) или Публичная. Эта настройка применяется только к проблемам в публичных репозиториях.
    • Закрепить типы: нажмите , чтобы выбрать, какие типы выпусков показывают это поле в просмотрщике и создателе выпусков. Выберите один или несколько типов проблем, или «Проблемы без типа». Поля, которые не закреплены и не имеют значения, останутся скрытыми в просмотрщике и создателе задачи.

11. Нажмите кнопку Создать.

Редактирование поля проблемы

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите поле «Проблема».

5. Справа от нужного поля нажмите .

6. Нажмите «Редактировать » и внесите изменения.

7. Нажмите поле «Сохранить».

Удаление поля проблемы

Когда вы удаляете поле проблемы, все значения, установленные для этого поля, навсегда удаляются.

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите поле «Проблема».

5. Справа от нужного поля нажмите .

6. Нажмите «Удалить» и подтвердите удаление.

Изменение порядка полей выпуска

Порядок закреплённых полей управляется по типу выпуска. Порядок полей определяет, как поля отображаются в боковой панели проблемы и модале создания проблем.

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите «Типы проблем».

5. Нажмите на тип выпуска, по которому хотите изменить порядок полей.

6. В разделе «Закреплённые поля выпуска» перетаскивайте поля, чтобы изменить их порядок.

7. Нажмите кнопку Сохранить.

Закрепление полей для типов выпусков

Вы можете связывать поля проблем с определёнными типами задач, чтобы при создании или просмотре выпусков этого типа появлялись только наиболее релевантные. Например, можно прикрепить «Серьёзность» к багам и «Влияние» к признакам.

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите поле «Проблема».

5. Нажмите на нужное поле для закрепления.

6. В разделе «Закрепить типы» нажмите и выберите типы проблем, на которых должно появиться это поле.

7. Нажмите поле «Сохранить».

Закреплённые поля автоматически появляются в боковой панели выпуска в зависимости от выбранного типа. Чтобы прикрепить поля к проблемам без типа, выберите опцию «Проблемы без типа».

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

Настройка видимости поля

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

1. В правом верхнем углу GitHub, щелкните рисунок профиля, а затем выберите октикона "организация" aria-hidden="true" aria-label="organization" %} Ваши организации.

2. Выберите организацию, кликнув по ней.

3. Под именем организации щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

4. В разделе «Планирование» боковой панели нажмите поле «Проблема».

5. Справа от поля нажмите .

6. Выберите Изменить.

7. В разделе «Поле видимости» выберите один из следующих вариантов:

   • Только для организации: поле видно только членам организации и сотрудникам репозитория с хотя бы доступом к чтению.
   • Общественность: поле видно каждому, кто смотрит этот вопрос.

8. Нажмите кнопку Сохранить.

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

Области вопросов и проекты

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

Видимость в публичных и внутренних проектах

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

Если видимость поля меняется с «Публичное» на «Только для организации» во время использования в публичном проекте, это поле автоматически удаляется из проекта. Чтобы восстановить его, измените видимость поля обратно на «Публично».

Переход из проектных полей в задачи

Если вы уже используете пользовательские поля на уровне проекта для метаданных, таких как приоритет или усилия, вы можете использовать поля задачи для централизации этих значений на уровне задачи.

• Поля проблем — источник истины. Ценность живёт в этом вопросе и последовательно во всех проектах, к которым он принадлежит.
• Project Fields охватывают один проект. Одна и та же проблема может иметь разные ценности полей проектов в разных проектах.
• Оба способны сосуществовать. Не обязательно сразу удалять поля проекта, но наличие обоих может вызвать путаницу, если они отслеживают одну и ту же концепцию (например, два поля «Приоритет»).
• Для миграции создайте аналогичное поле задачи, а затем уберите поле на уровне проекта из представлений проекта, когда команда будет готова.

Пределы полей в проектах

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

Ограничения

Ресурс	Ограничение
Области выпуска по организациям	двадцать пять
Опции для каждого поля с одиночным выбором	100
Закреплённые поля по типу выпуска	10
Общее количество полей в проекте (включая задачи и системные поля)	50