조직에서 문제 필드 관리

문제 필드를 사용하면 조직 전체의 문제에 구조적 메타데이터를 추가할 수 있습니다. 레이블 또는 자유 텍스트 해결 방법을 사용하는 대신 우선 순위, 노력, 영향 또는 팀에 필요한 사용자 지정 범주와 같은 필드를 만들 수 있습니다. 필드는 조직 수준에서 정의되며 조직의 모든 리포지토리에 적용됩니다.

문제 필드 유형 정보

조직당 최대 25개 문제 필드를 만들 수 있습니다. 사용할 수 있는 필드 형식은 다음과 같습니다.

• 단일 선택: 미리 정의된 목록에서 하나의 옵션을 선택합니다. 옵션에는 이름, 설명 및 색이 있을 수 있습니다.
• 텍스트: 자유 형식 텍스트를 캡처합니다. URL이 자동으로 검색되고 클릭 가능한 링크로 표시됩니다.
• 숫자: 소수 자릿수를 포함하여 숫자 입력을 허용합니다.
• 날짜: 날짜를 선택하기 위한 날짜 선택기를 제공합니다.

기본 필드

조직에 대해 문제 필드를 사용하도록 설정하면 네 개의 기본 필드가 자동으로 만들어집니다.

• 우선 순위 (단일 선택): 긴급, 높음, 중간, 낮음
• 노력 (단일 선택): 높음, 중간, 낮음
• 시작 날짜 (날짜)
• 대상 날짜 (날짜)

이러한 기본 필드는 다음과 같이 문제 유형에 고정됩니다.

Field	형식 없음	Bug	과업	특징
우선 순위
노력
시작 날짜
목표 날짜

이러한 기본 필드는 완전히 사용자 지정할 수 있습니다. 이름, 설명 및 옵션을 편집하거나 워크플로에 맞지 않는 경우 삭제할 수 있습니다.

문제 필드 만들기

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.

5. 새 필드를 클릭합니다.

6. "필드 이름"에 새 필드의 이름을 입력합니다.

7. 필요에 따라 "설명" 아래에 다른 사용자가 필드의 용도를 이해할 수 있도록 설명을 입력합니다.

8. "필드 형식"에서 만들 필드 유형을 선택합니다.

9. 단일 선택을 선택한 경우 필드에 대한 옵션을 추가합니다.

   • 추가 옵션을 클릭하고 옵션 이름을 입력합니다.
   • 필요에 따라 옵션의 색을 설정하려면 옵션 옆을 클릭하고 편집 옵션을 클릭하고 색을 선택한 다음 저장을 클릭합니다.
   • 옵션을 더 추가하려면 반복합니다.

10. "필드 표시 유형"에서 다음 중 하나를 선택합니다.

    • 사용 권한: 필드와 해당 값을 볼 수 있는 사용자를 선택합니다. 옵션은 조직 전용 (기본값) 또는 공용입니다. 이 설정은 공용 리포지토리의 문제에만 적용됩니다.
    • 유형에 고정하기: 을 클릭하여 이슈 보기 및 생성 화면에서 이 필드를 표시할 이슈 유형을 선택합니다. 하나 이상의 문제 유형 또는 "형식이 없는 문제"를 선택합니다. 고정되지 않고 값이 없는 필드는 문제 뷰어 및 작성자에 숨겨집니다.

11. 만들기를 클릭합니다.

문제 필드 편집

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.

5. 편집할 필드의 오른쪽에서 을 클릭합니다 .

6. 편집을 클릭하고 변경합니다.

7. 저장 필드를 클릭합니다.

문제 필드 삭제

문제 필드를 삭제하면 해당 필드에 대해 설정된 모든 값이 영구적으로 제거됩니다.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.

5. 삭제할 필드의 오른쪽에서 을 클릭합니다 .

6. 삭제를 클릭하고 삭제를 확인합니다.

문제 필드 순서 다시 지정

고정된 필드의 순서는 문제 유형별로 관리됩니다. 필드 순서는 문제 사이드바에 필드가 표시되는 방식과 문제 생성 모달을 결정합니다.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 유형을 클릭합니다.

5. 필드의 순서를 다시 지정할 문제 유형을 클릭합니다.

6. "고정된 문제 필드"에서 필드를 끌어 순서를 다시 지정합니다.

7. 저장을 클릭합니다.

이슈 유형에 필드 고정

특정 문제 유형과 문제 필드를 연결하여 해당 형식의 문제를 만들거나 볼 때 가장 관련성이 큰 필드만 표시되도록 할 수 있습니다. 예를 들어 버그에 "심각도"를 고정하고 기능에 "영향"을 고정할 수 있습니다.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.

5. 고정할 필드를 클릭합니다.

6. "유형에 고정"에서 을 클릭한 다음, 이 필드를 표시할 이슈 유형을 선택합니다.

7. 저장 필드를 클릭합니다.

고정된 필드는 선택한 문제 유형에 따라 문제 사이드바에 자동으로 표시됩니다. 형식이 없는 문제에 필드를 고정하려면 "형식이 없는 문제" 옵션을 선택합니다.

문제에 필드가 표시되지 않는 경우 해당 필드가 관련 문제 유형 또는 "형식이 없는 문제"에 고정되어 있는지 확인합니다. 고정되지 않고 값 집합이 없는 필드는 문제 사이드바에서 숨겨집니다.

필드 가시성 설정

공용 리포지토리가 있는 조직의 경우 각 문제 필드가 모든 사용자에게 표시되는지 아니면 조직 구성원 및 공동 작업자에게만 표시되는지 제어할 수 있습니다.

1. GitHub의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음, Your organizations를 클릭합니다.

2. 조직을 클릭하여 선택합니다.

3. 조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.

   

4. 사이드바의 "계획" 섹션에서 문제 필드를 클릭합니다.

5. 필드 오른쪽에 있는 를 클릭합니다.

6. 편집을 클릭합니다.

7. "필드 표시 유형"에서 다음 중 하나를 선택합니다.

   • 조직만: 이 필드는 최소한 읽기 권한이 있는 조직 구성원 및 리포지토리 공동 작업자에게만 표시됩니다.
   • 공용: 이 필드는 문제를 보는 모든 사용자에게 표시됩니다.

8. 저장을 클릭합니다.

기본적으로 모든 새 필드와 기존 필드는 "조직만"으로 설정됩니다. 표시 유형 설정은 웹 UI, API, 문제 타임라인 이벤트 및 검색 제안에 적용됩니다.

문제 필드 및 프로젝트

문제 필드는 공용 및 내부 프로젝트를 포함하여 조직 전체의 모든 프로젝트에서 사용할 수 있습니다. 프로젝트에서 문제 필드를 추가, 제거 및 편집하는 방법에 대한 자세한 내용은 프로젝트의 문제 필드 정보을 참조하세요.

공개 및 내부 프로젝트에서의 공개 범위

공용 표시 유형이 있는 필드만 공용 및 내부 프로젝트에서 사용할 수 있습니다. 조직 전용으로 설정된 필드는 표시되지 않습니다. 공용 프로젝트에 필드를 추가할 때는 추가 필드 대화 상자에 공용 표시 유형 필드만 표시됩니다.

공용 프로젝트에서 사용하는 동안 필드의 표시 유형이 "공용"에서 "조직만"으로 변경되면 해당 필드가 프로젝트에서 자동으로 제거됩니다. 복원하려면 필드의 표시 유형을 다시 "공용"으로 변경합니다.

프로젝트 필드에서 발급 필드로 마이그레이션

우선 순위 또는 노력과 같은 메타데이터에 프로젝트 수준 사용자 지정 필드를 이미 사용하는 경우 문제 필드를 채택하여 문제 수준에서 해당 값을 중앙 집중화할 수 있습니다.

• 문제 필드는 진실의 근원입니다. 이 값은 문제에 적용되며 문제가 속한 모든 프로젝트에서 일관됩니다.
• 프로젝트 필드는 단일 프로젝트에 한정됩니다. 동일한 문제는 다른 프로젝트에 다른 프로젝트 필드 값을 가질 수 있습니다.
• 둘 다 공존할 수 있습니다. 프로젝트 필드를 즉시 제거할 필요는 없지만 동일한 개념(예: 두 개의 "우선 순위" 필드)을 추적하는 경우 둘 다 혼동을 일으킬 수 있습니다.
• 마이그레이션하려면 해당 문제 필드를 만든 다음 팀이 준비되면 프로젝트 보기에서 프로젝트 수준 필드를 제거합니다.

프로젝트의 필드 제한

프로젝트는 총 50개의 필드를 지원하며 문제 필드 및 시스템 필드는 이 제한에 포함됩니다. 프로젝트가 이미 필드 제한에 있는 경우 문제 필드를 추가하려면 기존 필드를 제거해야 합니다.

제한

Resource	Limit
조직별 문제 필드	이십오 (25)
단일 선택 필드당 옵션	100
문제 유형당 고정된 필드	10
프로젝트의 총 필드(문제 필드 및 시스템 필드 포함)	50