참고
문제 필드는 현재 공개 미리 보기에 있으며 변경될 수 있습니다. 피드백을 공유하려면 커뮤니티 토론을 참조하세요.
문제 필드를 사용하면 조직 전체의 문제에 구조적 메타데이터를 추가할 수 있습니다. 레이블 또는 자유 텍스트 해결 방법을 사용하는 대신 우선 순위, 노력, 영향 또는 팀에 필요한 사용자 지정 범주와 같은 필드를 만들 수 있습니다. 필드는 조직 수준에서 정의되며 조직의 모든 리포지토리에 적용됩니다.
문제 필드 유형 정보
조직당 최대 25개 문제 필드를 만들 수 있습니다. 사용할 수 있는 필드 형식은 다음과 같습니다.
-
**단일 선택**: 미리 정의된 목록에서 하나의 옵션을 선택합니다. 옵션에는 이름, 설명 및 색이 있을 수 있습니다. -
**텍스트**: 자유 형식 텍스트를 캡처합니다. URL이 자동으로 검색되고 클릭 가능한 링크로 표시됩니다. -
**숫자**: 소수 자릿수를 포함하여 숫자 입력을 허용합니다. -
**날짜**: 날짜를 선택하기 위한 날짜 선택기를 제공합니다.
기본 필드
조직에 대해 문제 필드를 사용하도록 설정하면 네 개의 기본 필드가 자동으로 만들어집니다.
-
**우선 순위** (단일 선택): 긴급, 높음, 중간, 낮음 -
**노력** (단일 선택): 높음, 중간, 낮음 -
**시작 날짜** (날짜) -
**대상 날짜** (날짜)
이러한 기본 필드는 완전히 사용자 지정할 수 있습니다. 이름, 설명 및 옵션을 편집하거나 워크플로에 맞지 않는 경우 삭제할 수 있습니다.
문제 필드 만들기
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.
-
**새 필드**를 클릭합니다. - "필드 이름"에 새 필드의 이름을 입력합니다.
- 필요에 따라 "설명" 아래에 다른 사용자가 필드의 용도를 이해할 수 있도록 설명을 입력합니다.
- "필드 형식"에서 만들 필드 유형을 선택합니다.
-
* 추가 옵션을 클릭하고 옵션 이름을 입력합니다.**단일 선택을** 선택한 경우 필드에 대한 옵션을 추가합니다.- 필요에 따라 옵션의 색을 설정하려면 옵션 옆에 있는 옥티콘 "kebab-horizontal" aria-label="옵션 메뉴 열기" %}를 클릭하고 편집 옵션을 클릭하고 색을 선택한 다음 저장을 클릭합니다.
- 옵션을 더 추가하려면 반복합니다.
- "필드 표시 유형"에서 다음 중 하나를 선택합니다. * 사용 권한: 필드와 해당 값을 볼 수 있는 사용자를 선택합니다. 옵션은 조직 전용 (기본값) 또는 공용입니다. 이 설정은 공용 리포지토리의 문제에만 적용됩니다. * 유형에 고정: 옥티콘 "연필" aria-label="고정 편집" %}을 클릭하여 이 필드를 표시할 문제 유형을 문제 뷰어 및 작성자에서 선택합니다. 하나 이상의 문제 유형 또는 "형식이 없는 문제"를 선택합니다. 고정되지 않고 값이 없는 필드는 문제 뷰어 및 작성자에 숨겨집니다.
-
**만들기**를 클릭합니다.
문제 필드 편집
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.
- 편집할 필드의 오른쪽에서 을 클릭합니다.
-
**편집**을 클릭하고 변경합니다. -
**저장 필드를** 클릭합니다.
문제 필드 삭제
문제 필드를 삭제하면 해당 필드에 대해 설정된 모든 값이 영구적으로 제거됩니다.
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.
- 삭제하려는 필드의 오른쪽에 있는 옥티콘 "kebab-horizontal" aria-label="open field options" %}을 클릭합니다.
-
**삭제**를 클릭하고 삭제를 확인합니다.
문제 필드 순서 다시 지정
고정된 필드의 순서는 문제 유형별로 관리됩니다. 필드 순서는 문제 사이드바에 필드가 표시되는 방식과 문제 생성 모달을 결정합니다.
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 유형을 클릭합니다.
- 필드의 순서를 다시 지정할 문제 유형을 클릭합니다.
- "고정된 문제 필드"에서 필드를 끌어 순서를 다시 지정합니다.
-
**저장**을 클릭합니다.
이슈 유형에 필드 고정
특정 문제 유형과 문제 필드를 연결하여 해당 형식의 문제를 만들거나 볼 때 가장 관련성이 큰 필드만 표시되도록 할 수 있습니다. 예를 들어 버그에 "심각도"를 고정하고 기능에 "영향"을 고정할 수 있습니다.
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.
- 고정할 필드를 클릭합니다.
- "형식에 고정"에서 옥티콘 "연필" aria-label="편집 고정" %}을 클릭하고 이 필드가 표시되어야 하는 문제 유형을 선택합니다.
-
**저장 필드를** 클릭합니다.
고정된 필드는 선택한 문제 유형에 따라 문제 사이드바에 자동으로 표시됩니다. 형식이 없는 문제에 필드를 고정하려면 "형식이 없는 문제" 옵션을 선택합니다.
참고
이슈 사이드바에 표시하려면 필드를 하나 이상의 문제 유형 또는 "형식이 없는 문제"에 고정해야 합니다. 형식에 고정되지 않은 필드는 필드 추가 단추 또는 프로젝트에서만 액세스할 수 있습니다.
필드 가시성 설정
공용 리포지토리가 있는 조직의 경우 각 문제 필드가 모든 사용자에게 표시되는지 아니면 조직 구성원 및 공동 작업자에게만 표시되는지 제어할 수 있습니다.
- GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.
- 조직 옆에 있는 설정을 클릭합니다.
- 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.
- 필드의 오른쪽에 있는 옥티콘 "kebab-horizontal" aria-label="open field options" %}을 클릭합니다.
-
**편집**을 클릭합니다. - "필드 표시 유형"에서 다음 중 하나를 선택합니다. * 조직만: 이 필드는 최소한 읽기 권한이 있는 조직 구성원 및 리포지토리 공동 작업자에게만 표시됩니다. * 공용: 이 필드는 문제를 보는 모든 사용자에게 표시됩니다.
-
**저장**을 클릭합니다.
기본적으로 모든 새 필드와 기존 필드는 "조직만"으로 설정됩니다. 표시 유형 설정은 웹 UI, API, 문제 타임라인 이벤트 및 검색 제안에 적용됩니다.
문제 필드 및 프로젝트
문제 필드는 조직 전체의 모든 프로젝트에서 사용할 수 있습니다. 프로젝트에서 문제 필드를 추가, 제거 및 편집하는 방법에 대한 자세한 내용은 문제 필드 추가 및 관리을 참조하세요.
프로젝트의 필드 제한
프로젝트는 총 50개의 필드를 지원하며 문제 필드 및 시스템 필드는 이 제한에 포함됩니다. 프로젝트가 이미 필드 제한에 있는 경우 문제 필드를 추가하려면 기존 필드를 제거해야 합니다.
제한
| Resource | Limit |
|---|---|
| 조직별 문제 필드 | 이십오 (25) |
| 단일 선택 필드당 옵션 | 50 |
| 문제 유형당 고정된 필드 | 10 |
| 프로젝트의 총 필드(문제 필드 및 시스템 필드 포함) | 50 |