할당자 및 문제에 적용된 레이블 및 프로젝트의 필드와 같은 항목 메타데이터에 대한 필터를 사용하여 보기에 표시되는 항목을 사용자 지정할 수 있습니다. 필터를 결합하고 보기로 저장할 수 있습니다. 자세한 내용은 "보기 관리"을(를) 참조하세요.
보기를 필터링하려면 을 클릭하고 필터링할 필드와 값을 입력하기 시작합니다. 입력하면 가능한 값이 나타납니다. 명령+K(Mac) 또는 Ctrl+K(Windows/Linux)을 눌러 프로젝트 명령 팔레트를 열고 “필터링 기준”을 입력하여 사용 가능한 필터 중에서 선택할 수도 있습니다.
보드 레이아웃에서 항목 데이터를 클릭하여 해당 값이 있는 항목을 필터링할 수 있습니다. 예를 들어 담당자를 클릭하여 해당 담당자에 대한 항목만 표시합니다. 필터를 제거하려면 항목 데이터를 다시 클릭합니다.
여러 필터를 사용하면 논리적 AND 필터로 작동합니다. 예를 들어 label:bug status:"In progress"
는 상태가 “진행 중”이고 bug
레이블이 있는 항목을 반환합니다. 논리적 OR 필터 역할을 하는 동일한 필드에 여러 값을 제공할 수도 있습니다. 예를 들어 label:bug,support
는 bug
또는 support
레이블이 있는 항목을 반환합니다. Projects (beta)는 현재 여러 필드의 논리적 OR 필터를 지원하지 않습니다.
보기를 필터링한 다음 항목을 추가하면 필터링된 메타데이터가 새 항목에 적용됩니다. 예를 들어 status:"In progress"
로 필터링하여 항목을 추가하는 경우 새 항목의 상태가 "진행 중"으로 설정됩니다.
필터를 사용하여 매우 구체적인 용도로 보기를 생성할 수 있습니다. 예를 들어 사용자는 레이블이 없고 octocat/game
리포지토리에 위치한 담당자가 없는 항목을 표시하는 no:label no:assignee repo:octocat/game
과 같은 음성 필터를 사용하여 심사 보기를 만들 수 있습니다.
필드 필터링
한정자 | 예시 |
---|---|
assignee:USERNAME | assignee:octocat은 @octocat에 할당된 항목을 표시합니다. |
label:LABEL | label:bug는 "bug"라는 레이블이 적용된 항목을 표시합니다. |
field:VALUE | status:done은 "상태" 필드가 "완료"로 설정된 항목을 표시합니다. |
reviewers:USERNAME | reviewers:octocat은 @octocat이 검토한 항목을 표시합니다. |
milestone:"MILESTONE" | milestone:"베타 릴리스" 는 "베타 릴리스" 마일스톤에 할당된 항목을 표시합니다. |
필터 결합
여러 필드에 적용되는 필터를 만들 수 있습니다. 보기에 모든 필터와 일치하는 항목이 표시됩니다.
한정자 | 예시 |
---|---|
assignee:USERNAME field:VALUE | assignee:octocat priority:1은 우선 순위가 1이고 @octocat에게 할당된 항목을 표시합니다. |
동일한 필드에 대해 여러 값을 필터링할 수도 있습니다. 값을 쉼표로 구분하면 보기에 제공된 값 중 하나 이상과 일치하는 항목이 표시됩니다.
한정자 | 예시 |
---|---|
assignee:USERNAME,USERNAME | assignee:octocat,stevecat은 @octocat 또는 @stevecat에게 할당된 항목을 표시합니다. |
동일한 필드에서 여러 값을 필터링하되 제공된 모든 값과 일치하는 항목을 표시하려는 경우 각 값에 대해 한정자를 반복하여 적용할 수 있습니다.
한정자 | 예시 |
---|---|
assignee:USERNAME assignee:USERNAME | assignee:octocat assignee:stevecat은 @octocat 및 @stevecat 모두에 할당된 항목을 표시합니다. |
일부 항목을 매칭하는 필터와 모든 항목을 매칭하는 필터를 결합할 수도 있습니다.
한정자 | 예시 |
---|---|
field:VALUE,VALUE assignee:USER assignee:USER | label: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:assignee | no:assignee는 할당되지 않은 항목을 표시합니다. |
no:reviewers | no:reviewers는 검토자가 없는 끌어오기 요청을 표시합니다. |
no:FIELD | no:priority는 우선 순위 필드가 비어 있는 항목을 표시합니다. |
하이픈 접두사로 이 동작을 부정하고 값이 있는 항목만 반환할 수도 있습니다.
한정자 | 예시 |
---|---|
-no:assignee | -no:assignee는 할당된 항목만 표시합니다. |
-no:FIELD | -no:priority는 우선 순위 필드에 값이 있는 항목만 표시합니다. |
항목 위치로 필터링
repo
한정자를 사용하여 특정 리포지토리의 항목을 필터링합니다.
한정자 | 예시 |
---|---|
repo:OWNER/REPO | repo:octocat/game은 "octocat/game" 리포지토리의 항목을 표시합니다. |
항목 상태 또는 항목 종류 필터링
is
한정자를 사용하여 특정 종류의 항목 또는 특정 상태의 항목을 필터링할 수 있습니다.
한정자 | 예시 |
---|---|
is:STATE | is:open은 미결 이슈 및 끌어오기 요청을 표시합니다. |
is:closed는 종결 이슈 및 끌어오기 요청을 표시합니다. | |
is:merged는 병합된 끌어오기 요청을 표시합니다. | |
is:TYPE | is:issue는 이슈만 표시합니다. |
is:pr은 끌어오기 요청만 표시합니다. | |
is:draft는 초안 이슈 및 초안 끌어오기 요청을 표시합니다. | |
is:issue is:open은 미결 이슈를 표시합니다. |
종결 이유로 필터링
종결 항목을 종결 이유로 필터링할 수 있습니다.
한정자 | 예시 |
---|---|
reason:CLOSE REASON | reason:completed는 완료되어 종결된 항목을 표시합니다. |
reason:"not planned" 는 "not planned" 이유와 함께 종결된 항목을 표시합니다. | |
reason:reopened는 이전에 종결된 후 다시 미결 상태가 된 항목을 표시합니다. |
숫자, 날짜 및 반복 필드 필터링
>
, >=
, <
및 <=
를 사용하여 숫자, 날짜 및 반복 필드를 비교할 수 있습니다. 날짜는 YYYY-MM-DD
형식으로 제공되어야 합니다.
한정자 | 예시 |
---|---|
field:>VALUE | priority:>1은 우선 순위가 1 보다 큰 항목을 표시합니다. |
field:>=VALUE | date:>=2022-06-01은 날짜가 "2022-06-01" 또는 그 이후인 항목을 표시합니다. |
field:<VALUE | iteration:<"Iteration 5" 는 "반복 5" 이전의 반복이 있는 항목을 표시합니다. |
field:<=VALUE | points:<=10은 포인트가 10 이하인 항목을 표시합니다. |
..
를 사용하여 포함 범위를 필터링할 수도 있습니다. 범위를 사용하여 작업하는 경우 *
를 와일드카드 연산자로 제공할 수 있습니다.
한정자 | 예시 |
---|---|
field:VALUE..VALUE | priority: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:@me | assignee:@me는 로그인한 사용자에게 할당된 항목을 표시합니다. |
-reviewers:@me는 로그인한 사용자가 검토하지 않은 항목을 표시합니다. |
키워드를 사용하여 반복 및 날짜 필드 필터링
@previous
, @current
및 @next
키워드를 사용하여 현재 반복을 기준으로 반복을 필터링할 수 있습니다. @today
를 사용하여 현재 날짜를 기준으로 필터링할 수도 있습니다.
한정자 | 예시 |
---|---|
field:@keyword | iteration:@current는 현재 반복에 할당된 항목을 표시합니다. |
iteration:@next는 다음 반복에 할당된 항목을 표시합니다. | |
field:@today | date:@today는 날짜가 현재 날짜로 설정된 항목을 표시합니다. |
키워드에 >
, >=
, <
, <=
, +
, -
및 ..
범위를 사용할 수도 있습니다.
한정자 | 예시 |
---|---|
field:@keyword..@keyword+n | iteration:@current..@current+3은 현재 반복과 다음 세 번의 반복에 할당된 항목을 표시합니다. |
date:@today..@today+7은 날짜가 오늘 또는 다음 7일로 설정된 항목을 표시합니다. | |
field:<@keyword | iteration:<@current은 현재 반복 전의 모든 반복에 할당된 항목을 표시합니다. |
field:>=@keyword | date:>=@today는 날짜가 오늘 또는 그 이후로 설정된 항목을 표시합니다. |
텍스트 필드로 필터링
특정 텍스트 필드를 필터링하거나 모든 텍스트 필드와 제목에 걸쳐 일반 텍스트 필터를 사용할 수 있습니다. 공백 또는 특수 문자가 포함된 텍스트로 필터링하는 경우 텍스트를 "
또는 '
따옴표로 묶습니다.
한정자 | 예시 |
---|---|
field:"TEXT" | title:"API deprecation" 은 제목이 "API deprecation"과 정확히 일치하는 항목을 표시합니다. |
field:TEXT | note:complete는 메모 텍스트 필드가 "complete"와 정확히 일치하는 항목을 표시합니다. |
TEXT | API는 제목 또는 다른 텍스트 필드에 "API"가 있는 항목을 표시합니다. |
field:TEXT TEXT | label:bug rendering은 제목 또는 다른 텍스트 필드에 "bug" 레이블과 "rendering"이 있는 항목을 표시합니다. |