프로젝트 필터링

필터를 사용하여 프로젝트 보기에 표시되는 항목을 선택합니다.

이 문서의 내용

할당자 및 문제에 적용된 레이블 및 프로젝트의 필드와 같은 항목 메타데이터에 대한 필터를 사용하여 보기에 표시되는 항목을 사용자 지정할 수 있습니다. 필터를 결합하고 보기로 저장할 수 있습니다. 자세한 내용은 "보기 관리"을(를) 참조하세요.

보기를 필터링하려면 을 클릭하고 필터링할 필드와 값을 입력하기 시작합니다. 입력하면 가능한 값이 나타납니다. 명령+K(Mac) 또는 Ctrl+K(Windows/Linux)을 눌러 프로젝트 명령 팔레트를 열고 “필터링 기준”을 입력하여 사용 가능한 필터 중에서 선택할 수도 있습니다.

"Mona's project" 스크린샷. "키워드 또는 필드로 필터링"이라는 레이블이 있는 필드가 주황색 윤곽선으로 강조 표시되어 있습니다.

보드 레이아웃에서 항목 데이터를 클릭하여 해당 값이 있는 항목을 필터링할 수 있습니다. 예를 들어 담당자를 클릭하여 해당 담당자에 대한 항목만 표시합니다. 필터를 제거하려면 항목 데이터를 다시 클릭합니다.

여러 필터를 사용하면 논리적 AND 필터로 작동합니다. 예를 들어 label:bug status:"In progress"는 상태가 “진행 중”이고 bug 레이블이 있는 항목을 반환합니다. 논리적 OR 필터 역할을 하는 동일한 필드에 여러 값을 제공할 수도 있습니다. 예를 들어 label:bug,support는 bug 또는 support 레이블이 있는 항목을 반환합니다. Projects는 현재 여러 필드의 논리적 OR 필터를 지원하지 않습니다.

Projects에 대한 인사이트를 사용하여 만든 차트에 동일한 필터를 사용할 수 있으므로 차트를 만드는 데 사용되는 데이터를 필터링할 수 있습니다. 자세한 내용은 "Projects에 대한 인사이트 정보"을(를) 참조하세요.

보기를 필터링한 다음 항목을 추가하면 필터링된 메타데이터가 새 항목에 적용됩니다. 예를 들어 status:"In progress"로 필터링하여 항목을 추가하는 경우 새 항목의 상태가 "진행 중"으로 설정됩니다.

필터를 사용하여 매우 구체적인 용도로 보기를 생성할 수 있습니다. 예를 들어 assignee:@me status:todo last-updated:5days를 사용하여 현재 사용자에게 할당되었고 지난 5일 동안 업데이트되지 않았으며 "todo" 상태인 모든 작업의 보기를 만들 수 있습니다. 레이블이 없고 octocat/game 리포지토리에 위치한 담당자가 없는 항목을 표시하는 no:label no:assignee repo:octocat/game과 같은 음성 필터를 사용하여 심사 보기를 만들 수 있습니다.

필드 필터링

한정자예시
assignee:USERNAMEassignee:octocat은 @octocat에 할당된 항목을 표시합니다.
label:LABELlabel:bug는 "bug"라는 레이블이 적용된 항목을 표시합니다.
field:VALUEstatus:done은 "상태" 필드가 "완료"로 설정된 항목을 표시합니다.
reviewers:USERNAMEreviewers:octocat은 @octocat이 검토한 항목을 표시합니다.
milestone:"MILESTONE"milestone:"베타 릴리스" 는 "베타 릴리스" 마일스톤에 할당된 항목을 표시합니다.

필터 결합

여러 필드에 적용되는 필터를 만들 수 있습니다. 보기에 모든 필터와 일치하는 항목이 표시됩니다.

한정자예시
assignee:USERNAME field:VALUEassignee:octocat priority:1은 우선 순위가 1이고 @octocat에게 할당된 항목을 표시합니다.

동일한 필드에 대해 여러 값을 필터링할 수도 있습니다. 값을 쉼표로 구분하면 보기에 제공된 값 중 하나 이상과 일치하는 항목이 표시됩니다.

한정자예시
assignee:USERNAME,USERNAMEassignee:octocat,stevecat은 @octocat 또는 @stevecat에게 할당된 항목을 표시합니다.

동일한 필드에서 여러 값을 필터링하되 제공된 모든 값과 일치하는 항목을 표시하려는 경우 각 값에 대해 한정자를 반복하여 적용할 수 있습니다.

한정자예시
assignee:USERNAME assignee:USERNAMEassignee:octocat assignee:stevecat은 @octocat 및 @stevecat 모두에 할당된 항목을 표시합니다.

일부 항목을 매칭하는 필터와 모든 항목을 매칭하는 필터를 결합할 수도 있습니다.

한정자예시
field:VALUE,VALUE assignee:USER assignee:USERlabel:bug,onboarding assignee:octocat assignee:stevecat은 버그 또는 온보딩이라는 레이블이 있고 @octocat 및 @stevecat 모두에 할당된 항목을 표시합니다.

필터 부정

하이픈 접두사를 사용하여 조합을 포함한 모든 필터를 반전할 수 있습니다.

한정자예시
-assignee:USERNAME-assignee:octocat은 @octocat에게 할당된 항목을 표시하지 않습니다.
-field:VALUE-status:done은 "완료" 상태인 항목을 표시하지 않습니다.
-field:VALUE,VALUE-priority:1,2는 우선 순위가 1 또는 2인 항목을 표시하지 않습니다.

값이 누락된 항목 필터링

no:를 사용하여 값이 누락된 항목을 필터링할 수 있습니다.

한정자예시
no:assigneeno:assignee는 할당되지 않은 항목을 표시합니다.
no:reviewersno:reviewers는 검토자가 없는 끌어오기 요청을 표시합니다.
no:FIELDno:priority는 우선 순위 필드가 비어 있는 항목을 표시합니다.

하이픈 접두사로 이 동작을 부정하고 값이 있는 항목만 반환할 수도 있습니다.

한정자예시
-no:assignee-no:assignee는 할당된 항목만 표시합니다.
-no:FIELD-no:priority는 우선 순위 필드에 값이 있는 항목만 표시합니다.

항목 위치로 필터링

repo 한정자를 사용하여 특정 리포지토리의 항목을 필터링합니다.

한정자예시
repo:OWNER/REPOrepo:octocat/game은 "octocat/game" 리포지토리의 항목을 표시합니다.

항목 상태 또는 항목 종류 필터링

is 한정자를 사용하여 특정 종류의 항목 또는 특정 상태의 항목을 필터링할 수 있습니다.

한정자예시
is:STATEis:open은 미결 이슈 및 끌어오기 요청을 표시합니다.
is:closed는 종결 이슈 및 끌어오기 요청을 표시합니다.
is:merged는 병합된 끌어오기 요청을 표시합니다.
is:TYPEis:issue는 이슈만 표시합니다.
is:pr은 끌어오기 요청만 표시합니다.
is:draft는 초안 이슈 및 초안 끌어오기 요청을 표시합니다.
is:issue is:open은 미결 이슈를 표시합니다.

종결 이유로 필터링

종결 항목을 종결 이유로 필터링할 수 있습니다.

한정자예시
reason:CLOSE REASONreason:completed는 완료되어 종결된 항목을 표시합니다.
reason:"not planned" 는 "not planned" 이유와 함께 종결된 항목을 표시합니다.
reason:reopened는 이전에 종결된 후 다시 미결 상태가 된 항목을 표시합니다.

추적 기준 필드로 필터링

작업 목록의 다른 이슈로 추적되는 이슈를 필터링할 수 있습니다. 자세한 내용은 "작업 목록 만들기"을(를) 참조하세요.

한정자예시
tracked-by:"OWNER/REPO#ISSUE NUMBER"tracked-by:"octocat/game#11" 은 octocat/game 리포지토리의 이슈 #11로 작업 목록에서 추적되는 모든 이슈를 표시합니다.

항목이 마지막으로 업데이트된 시점 필터링

{number}days 구문을 사용하여 항목이 마지막으로 업데이트된 시점을 필터링할 수 있습니다.

한정자예시
last-updated:NUMBERdayslast-updated:1day는 1일 전에 마지막으로 업데이트된 항목을 표시합니다.
last-updated:7days는 7일 전에 마지막으로 업데이트된 항목을 표시합니다.
-last-updated:10days는 지난 10일 동안 업데이트된 항목을 표시합니다.

GitHub은(는) 다음과 같은 경우 이슈 또는 끌어오기 요청을 업데이트된 것으로 표시합니다.

  • Created
  • 다시 열림
  • 편집됨
  • 주석
  • 레이블 지정됨
  • 담당자 업데이트됨
  • 마일스톤이 업데이트됨
  • 다른 리포지토리로 전송됨

숫자, 날짜 및 반복 필드 필터링

>, >=, < 및 <=를 사용하여 숫자, 날짜 및 반복 필드를 비교할 수 있습니다. 날짜는 YYYY-MM-DD 형식으로 제공되어야 합니다.

한정자예시
field:>VALUEpriority:>1은 우선 순위가 1 보다 큰 항목을 표시합니다.
field:>=VALUEdate:>=2022-06-01은 날짜가 "2022-06-01" 또는 그 이후인 항목을 표시합니다.
field:<VALUEiteration:<"Iteration 5" 는 "반복 5" 이전의 반복이 있는 항목을 표시합니다.
field:<=VALUEpoints:<=10은 포인트가 10 이하인 항목을 표시합니다.

..를 사용하여 포함 범위를 필터링할 수도 있습니다. 범위를 사용하여 작업하는 경우 *를 와일드카드 연산자로 제공할 수 있습니다.

한정자예시
field:VALUE..VALUEpriority:1..3은 우선 순위가 1, 2 또는 3인 항목을 표시합니다.
date:2022-01-01..2022-12-31은 2022년의 항목을 표시합니다.
points:*..10은 10까지(10 포함)의 포인트 값이 있는 항목을 표시합니다.
iteration:"Iteration 1..Iteration 4" 는 "반복 1", "반복 2", "반복 3" 및 "반복 4"의 항목을 표시합니다.

키워드를 사용하여 담당자 및 검토자 필터링

@me 키워드를 사용하여 필터에서 자신을 나타낼 수 있습니다.

한정자예시
field:@meassignee:@me는 로그인한 사용자에게 할당된 항목을 표시합니다.
-reviewers:@me는 로그인한 사용자가 검토하지 않은 항목을 표시합니다.

키워드를 사용하여 반복 및 날짜 필드 필터링

@previous, @current 및 @next 키워드를 사용하여 현재 반복을 기준으로 반복을 필터링할 수 있습니다. @today를 사용하여 현재 날짜를 기준으로 필터링할 수도 있습니다.

한정자예시
field:@keyworditeration:@current는 현재 반복에 할당된 항목을 표시합니다.
iteration:@next는 다음 반복에 할당된 항목을 표시합니다.
field:@todaydate:@today는 날짜가 현재 날짜로 설정된 항목을 표시합니다.

키워드에 >, >=, <, <=, +, - 및 .. 범위를 사용할 수도 있습니다.

한정자예시
field:@keyword..@keyword+niteration:@current..@current+3은 현재 반복과 다음 세 번의 반복에 할당된 항목을 표시합니다.
date:@today..@today+7은 날짜가 오늘 또는 다음 7일로 설정된 항목을 표시합니다.
field:<@keyworditeration:<@current은 현재 반복 전의 모든 반복에 할당된 항목을 표시합니다.
field:>=@keyworddate:>=@today는 날짜가 오늘 또는 그 이후로 설정된 항목을 표시합니다.

텍스트 필드로 필터링

특정 텍스트 필드를 필터링하거나 모든 텍스트 필드와 제목에 걸쳐 일반 텍스트 필터를 사용할 수 있습니다. 공백 또는 특수 문자가 포함된 텍스트로 필터링하는 경우 텍스트를 " 또는 ' 따옴표로 묶습니다.

한정자예시
field:"TEXT"title:"API deprecation" 은 제목이 "API deprecation"과 정확히 일치하는 항목을 표시합니다.
field:TEXTnote:complete는 메모 텍스트 필드가 "complete"와 정확히 일치하는 항목을 표시합니다.
TEXTAPI는 제목 또는 다른 텍스트 필드에 "API"가 있는 항목을 표시합니다.
field:TEXT TEXTlabel:bug rendering은 제목 또는 다른 텍스트 필드에 "bug" 레이블과 "rendering"이 있는 항목을 표시합니다.

*를 와일드카드 문자로 사용할 수도 있습니다.

한정자예시
field:*TEXT*label:*bug* 는 "bug"라는 단어가 포함된 레이블이 있는 항목을 표시합니다.
field:TEXT*title:API* 는 제목이 "API"로 시작하는 항목을 표시합니다.
field:*TEXTlabel:*support는 "support"로 끝나는 레이블이 있는 항목을 표시합니다.