{"meta":{"title":"문제 필드 추가 및 관리","intro":"개별 문제에 대한 문제 필드 값을 설정, 편집 및 지우고 팀의 구조적 메타데이터를 캡처할 수 있습니다.","product":"GitHub Issues","breadcrumbs":[{"href":"/ko/issues","title":"GitHub Issues"},{"href":"/ko/issues/tracking-your-work-with-issues","title":"문제"},{"href":"/ko/issues/tracking-your-work-with-issues/using-issues","title":"이슈 사용"},{"href":"/ko/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields","title":"문제 필드 사용"}],"documentType":"article"},"body":"# 문제 필드 추가 및 관리\n\n개별 문제에 대한 문제 필드 값을 설정, 편집 및 지우고 팀의 구조적 메타데이터를 캡처할 수 있습니다.\n\n문제 필드는 문제의 오른쪽 사이드바에 할당자, 레이블 및 형식과 같은 시스템 필드와 함께 표시됩니다. 문제를 만들거나 편집할 때 값을 설정할 수 있습니다. 문제를 만드는 동안 문제 유형을 선택하면 해당 형식에 고정된 모든 필드가 사이드바에 자동으로 표시됩니다.\n\n> \\[!NOTE]\n> 문제 필드는 현재 문제에서만 사용할 수 있습니다. 끌어오기 요청은 문제 필드를 지원하지 않습니다.\n\n## 필드 값 설정\n\n1. 업데이트하려는 문제로 이동합니다.\n2. 오른쪽 사이드바에서 원하는 필드가 아직 표시되지 않으면 **\\[필드 추가**]를 클릭합니다.\n3. 드롭다운에서 추가할 필드를 선택합니다.\n4. 값을 설정합니다.\n   * **단일 선택** 필드의 경우 드롭다운에서 옵션을 선택합니다.\n   * **텍스트** 필드의 경우 값을 입력합니다. URL이 자동으로 검색되고 링크로 표시됩니다.\n   * **숫자** 필드의 경우 숫자 값을 입력합니다.\n   * **날짜** 필드의 경우 날짜 선택기를 사용하여 날짜를 선택하거나 날짜를 직접 입력합니다.\n5. 변경 내용은 자동으로 저장됩니다.\n\n> \\[!NOTE]\n> 현재 문제 필드는 URL 쿼리 매개 변수를 통해 미리 채워지거나 문제 템플릿을 통해 설정할 수 없습니다. 필드 값을 설정하려면 이슈 사이드바, 프로젝트, API 또는 GitHub Actions를 사용하세요.\n\n## 필드 값 편집\n\n1. 문제로 이동합니다.\n2. 오른쪽 사이드바에서 변경할 필드 값을 클릭합니다.\n3. 새 값을 선택하거나 새 항목을 입력합니다.\n4. 변경 내용은 자동으로 저장됩니다.\n\n## 필드 값 지우기\n\n1. 문제로 이동합니다.\n2. 오른쪽 사이드바에서 필드 값을 클릭합니다.\n3. 값을 지우십시오:\n   * **단일 선택** 필드의 경우 현재 선택한 옵션을 클릭하여 선택 취소합니다.\n   * **텍스트** 및 **숫자** 필드의 경우 입력의 모든 텍스트를 삭제합니다.\n   * 날짜 필드의 경우 **날짜** 선택기에서 지우기 단추를 클릭합니다.\n4. 지우면 필드가 사이드바에서 제거됩니다.\n   **필드 추가** 단추를 사용하여 다시 추가할 수 있습니다.\n\n## 고정된 필드\n\n조직 관리자가 특정 문제 유형에 필드를 고정한 경우 해당 필드를 만들거나 해당 형식의 문제를 볼 때 해당 필드가 사이드바 및 문제 생성 모달에 자동으로 표시됩니다. 고정된 필드를 수동으로 추가할 필요가 없습니다.\n\n## 타임라인에서 필드 변경 내용 보기\n\n필드 값이 변경되면 업데이트가 문제 타임라인에 기록됩니다. 타임라인 항목은 다음을 보여줍니다.\n\n* 어떤 필드가 변경되었습니까?\n* 설정된 새 값\n* 변경한 사람\n* 변경이 이루어진 시기\n\n\"조직만\" 표시 유형으로 설정된 필드의 타임라인 이벤트는 조직 구성원이나 협력자가 아닌 사용자에게 숨겨집니다.\n\n## 필드 가시성\n\n조직 관리자는 각 필드의 가시성을 \"조직만\" 또는 \"공용\"으로 설정할 수 있습니다. 이는 표시되는 내용에 영향을 줍니다.\n\n* 필드가 **조직으로만** 설정된 경우 최소한 읽기 권한이 있는 조직 구성원 및 리포지토리 협력자만 볼 수 있습니다. 멤버 또는 공동 작업자가 아닌 경우 이슈 사이드바, 타임라인 또는 검색 제안에 필드가 표시되지 않습니다.\n* 필드를 **Public**으로 설정하면 문제를 보는 모든 사용자가 볼 수 있습니다.\n\n표시 유형 구성에 대한 자세한 내용은 [조직에서 문제 필드 관리](/ko/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility)을 참조하세요.\n\n## 프로젝트에서 문제 필드 사용\n\n문제 필드는 프로젝트 보기에서 열로 추가할 수 있습니다. 여기서 값, 그룹화, 필터, 정렬 및 빌드 차트를 편집할 수 있습니다. 자세한 내용은 [프로젝트의 문제 필드 정보](/ko/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields)을(를) 참조하세요.\n\n## 필드 값으로 검색\n\n문제 대시보드와 리포지토리의 문제 페이지에서 필드 값을 기반으로 문제를 필터링하고 검색할 수 있습니다. 검색 창에 `field.`를 입력한 다음 필드 이름과 값을 입력합니다. 다음은 그 예입니다.\n\n* `field.priority:high` 우선 순위가 \"높음\"으로 설정된 문제를 찾으려면\n* `field.\"target date\":>=2026-03-01` 2026년 3월 1일 이후 대상 날짜와 관련된 문제를 찾으려면\n* `field.priority:high,medium` 우선 순위가 \"높음\" 또는 \"보통\"으로 설정된 문제를 찾으려면\n\n자세한 내용은 [문제 및 끌어오기 요청 필터링 및 검색](/ko/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)을(를) 참조하세요.\n\n## API에서 문제 필드 사용\n\n문제 필드에는 전체 REST 및 GraphQL API 지원이 있습니다. 필드 관리를 자동화하고, 프로그래밍 방식으로 값을 설정하고, 외부 도구와 통합할 수 있습니다.\n\n* **필드 관리**: 조직 수준 필드 만들기, 업데이트 및 삭제\n  [조직 문제 필드 REST API](/ko/rest/orgs/issue-fields)를 참조하세요.\n* **필드 사용**: 개별 문제에 대한 필드 값 가져오기, 설정 및 지우기\n  [이슈 필드 값 REST API](/ko/rest/issues/issue-field-values)를 참조하십시오.\n* **GraphQL**: 문제 필드 유형 및 변형은 GraphQL을 통해서도 사용할 수 있습니다.\n  [\n  `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` 등)을 참조하세요.\n\n## GitHub Actions로 자동화하기\n\n이슈 필드가 변경되면 `issues` 이벤트에서 웹후크 이벤트를 트리거합니다. 워크플로 트리거로 사용할 수 있습니다.\n\n* `field_added`: 필드 값이 설정되거나 업데이트될 때 트리거됩니다.\n* `field_removed`: 필드 값이 지워지면 발생합니다.\n\n예를 들어 필드 값이 변경 될 때마다 워크플로를 실행하려면 다음을 수행합니다.\n\n```yaml\non:\n  issues:\n    types: [field_added, field_removed]\n```\n\n이벤트 페이로드에는 필드 이름, 형식, 값 및 이전 값이 포함됩니다. 자세한 내용은 [워크플로를 트리거하는 이벤트](/ko/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)을(를) 참조하세요."}