# 문제 필드 추가 및 관리

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

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

> \[!NOTE]
> 문제 필드는 현재 문제에서만 사용할 수 있습니다. 끌어오기 요청은 문제 필드를 지원하지 않습니다.

## 필드 값 설정

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

> \[!NOTE]
> 현재 문제 필드는 URL 쿼리 매개 변수를 통해 미리 채워지거나 문제 템플릿을 통해 설정할 수 없습니다. 필드 값을 설정하려면 이슈 사이드바, 프로젝트, API 또는 GitHub Actions를 사용하세요.

## 필드 값 편집

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

## 필드 값 지우기

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

## 고정된 필드

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

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

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

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

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

## 필드 가시성

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

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

표시 유형 구성에 대한 자세한 내용은 [조직에서 문제 필드 관리](/ko/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility)을 참조하세요.

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

문제 필드는 프로젝트 보기에서 열로 추가할 수 있습니다. 여기서 값, 그룹화, 필터, 정렬 및 빌드 차트를 편집할 수 있습니다. 자세한 내용은 [프로젝트의 문제 필드 정보](/ko/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields)을(를) 참조하세요.

## 필드 값으로 검색

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

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

자세한 내용은 [문제 및 끌어오기 요청 필터링 및 검색](/ko/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)을(를) 참조하세요.

## API에서 문제 필드 사용

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

* **필드 관리**: 조직 수준 필드 만들기, 업데이트 및 삭제
  [조직 문제 필드 REST API](/ko/rest/orgs/issue-fields)를 참조하세요.
* **필드 사용**: 개별 문제에 대한 필드 값 가져오기, 설정 및 지우기
  [이슈 필드 값 REST API](/ko/rest/issues/issue-field-values)를 참조하십시오.
* **GraphQL**: 문제 필드 유형 및 변형은 GraphQL을 통해서도 사용할 수 있습니다.
  [
  `IssueFields` 공용 구조체](/ko/graphql/reference/issues#union-issuefields), [이슈 필드 객체](/ko/graphql/reference/issues#object-issuefieldtext)(`IssueFieldText`, `IssueFieldSingleSelect`, `IssueFieldNumber`, `IssueFieldDate` 등) 및 [변경 사항](/ko/graphql/reference/issues#mutation-createissuefield)(`createIssueField`, `updateIssueField`, `setIssueFieldValue` 등)을 참조하세요.

## GitHub Actions로 자동화하기

이슈 필드가 변경되면 `issues` 이벤트에서 웹후크 이벤트를 트리거합니다. 워크플로 트리거로 사용할 수 있습니다.

* `field_added`: 필드 값이 설정되거나 업데이트될 때 트리거됩니다.
* `field_removed`: 필드 값이 지워지면 발생합니다.

예를 들어 필드 값이 변경 될 때마다 워크플로를 실행하려면 다음을 수행합니다.

```yaml
on:
  issues:
    types: [field_added, field_removed]
```

이벤트 페이로드에는 필드 이름, 형식, 값 및 이전 값이 포함됩니다. 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)을(를) 참조하세요.