Skip to main content

문제 필드 추가 및 관리

개별 문제에 대한 문제 필드 값을 설정, 편집 및 지우고 팀의 구조적 메타데이터를 캡처할 수 있습니다.

누가 이 기능을 사용할 수 있나요?

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

참고

문제 필드는 현재 공개 미리 보기에 있으며 변경될 수 있습니다. 피드백을 공유하려면 커뮤니티 토론을 참조하세요.

문제 필드는 문제의 오른쪽 사이드바에 할당자, 레이블 및 형식과 같은 시스템 필드와 함께 표시됩니다. 문제를 만들거나 편집할 때 값을 설정할 수 있습니다. 문제를 만드는 동안 문제 유형을 선택하면 해당 형식에 고정된 모든 필드가 사이드바에 자동으로 표시됩니다.

필드 값 설정

  1. 업데이트하려는 문제로 이동합니다.
  2. 오른쪽 사이드바에서 원하는 필드가 아직 표시되지 않으면 [필드 추가]를 클릭합니다.
  3. 드롭다운에서 추가할 필드를 선택합니다.
  4. 값을 설정합니다. * 단일 선택 필드의 경우 드롭다운에서 옵션을 선택합니다. * 텍스트 필드의 경우 값을 입력합니다. URL이 자동으로 검색되고 링크로 표시됩니다. * 숫자 필드의 경우 숫자 값을 입력합니다. * 날짜 필드의 경우 날짜 선택기를 사용하여 날짜를 선택하거나 날짜를 직접 입력합니다.
  5. 변경 내용은 자동으로 저장됩니다.

필드 값 편집

  1. 문제로 이동합니다.
  2. 오른쪽 사이드바에서 변경할 필드 값을 클릭합니다.
  3. 새 값을 선택하거나 새 항목을 입력합니다.
  4. 변경 내용은 자동으로 저장됩니다.

필드 값 지우기

  1. 문제로 이동합니다.
  2. 오른쪽 사이드바에서 필드 값을 클릭합니다.
  3. 값을 지우십시오: * 단일 선택 필드의 경우 현재 선택한 옵션을 클릭하여 선택 취소합니다. * 텍스트숫자 필드의 경우 입력의 모든 텍스트를 삭제합니다.
    • 날짜 필드의 경우 날짜 선택기에서 지우기 단추를 클릭합니다.
  4. 지우면 필드가 사이드바에서 제거됩니다. 필드 추가 단추를 사용하여 다시 추가할 수 있습니다.

고정된 필드

조직 관리자가 특정 문제 유형에 필드를 고정한 경우 해당 필드를 만들거나 해당 형식의 문제를 볼 때 해당 필드가 사이드바 및 문제 생성 모달에 자동으로 표시됩니다. 고정된 필드를 수동으로 추가할 필요가 없습니다.

타임라인에서 필드 변경 내용 보기

필드 값이 변경되면 업데이트가 문제 타임라인에 기록됩니다. 타임라인 항목은 다음을 보여줍니다.

  • 어떤 필드가 변경되었습니까?
  • 설정된 새 값
  • 변경한 사람
  • 변경이 이루어진 시기

"조직만" 표시 유형으로 설정된 필드의 타임라인 이벤트는 조직 구성원이나 협력자가 아닌 사용자에게 숨겨집니다.

필드 가시성

조직 관리자는 각 필드의 가시성을 "조직만" 또는 "공용"으로 설정할 수 있습니다. 이는 표시되는 내용에 영향을 줍니다.

  • 필드가 조직으로만 설정된 경우 최소한 읽기 권한이 있는 조직 구성원 및 리포지토리 협력자만 볼 수 있습니다. 멤버 또는 공동 작업자가 아닌 경우 이슈 사이드바, 타임라인 또는 검색 제안에 필드가 표시되지 않습니다.
  • 필드를 Public으로 설정하면 문제를 보는 모든 사용자가 볼 수 있습니다.

표시 유형 구성에 대한 자세한 내용은 조직에서 문제 필드 관리을 참조하세요.

프로젝트에서 문제 필드 사용

문제 필드는 프로젝트 보기에서 열로 추가할 수 있습니다. 여기서 값, 그룹화, 필터, 정렬 및 빌드 차트를 편집할 수 있습니다. 자세한 내용은 프로젝트의 문제 필드 정보을(를) 참조하세요.

필드 값으로 검색

문제 대시보드와 리포지토리의 문제 페이지에서 필드 값을 기반으로 문제를 필터링하고 검색할 수 있습니다. 검색 창에 field.를 입력한 다음 필드 이름과 값을 입력합니다. 다음은 그 예입니다.

  •         `field.priority:high` 우선 순위가 "높음"으로 설정된 문제를 찾으려면
    
  •         `field."target date":>=2026-03-01` 2026년 3월 1일 이후 대상 날짜와 관련된 문제를 찾으려면
    
  •         `field.priority:high,medium` 우선 순위가 "높음" 또는 "보통"으로 설정된 문제를 찾으려면
    

자세한 내용은 문제 및 끌어오기 요청 필터링 및 검색을(를) 참조하세요.

API에서 문제 필드 사용

문제 필드에는 전체 REST 및 GraphQL API 지원이 있습니다. 필드 관리를 자동화하고, 프로그래밍 방식으로 값을 설정하고, 외부 도구와 통합할 수 있습니다.

  •         **필드 관리**: 조직 수준 필드 만들기, 업데이트 및 삭제 
            [조직 문제 필드 REST API](/rest/orgs/issue-fields)를 참조하세요.
    
  •         **필드 사용**: 개별 문제에 대한 필드 값 가져오기, 설정 및 지우기 
            [이슈 필드 값 REST API](/rest/issues/issue-field-values)를 참조하십시오.