projectsのフィルター処理

担当者や issue に適用されたラベルといった項目のメタデータやプロジェクトのフィールドに対するフィルターを使って、ビューに表示する項目をカスタマイズできます。 フィルタを組み合わせて、ビューとして保存できます。 詳しくは、「ビューの管理」を参照してください。

ビューをフィルターするには、 をクリックし、フィルタリングするフィールドとその値を入力してください。 入力していくと、利用できる値が表示されます。 また、Command+K キー (Mac) または Ctrl+K キー (Windows、Linux) キーを押してプロジェクト コマンド パレットを開き、「Filter by」と入力して、使用可能なフィルターから選ぶこともできます。

ボードレイアウトでは、アイテムデータをクリックして、その値を持つアイテムにフィルタリングできます。 たとえば、アサインされた人をクリックして、そのアサインされた人のアイテムだけを表示させられます。 このフィルタを削除するには、そのアイテムデータをもう一度クリックします。

複数のフィルターを使用すると、論理 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 を使用すると、現在のユーザーに割り当てられている、"todo" 状態が過去 5 日間更新されていないすべての作業のビューを作成できます。 トリアージ ビューを作成するには、no:label no:assignee repo:octocat/game などの負のフィルターを使用します。これにより、ラベルがなく、octocat/game リポジトリにある担当者がいない項目が表示されます。

フィールドのフィルタリング

修飾子	例
assignee:USERNAME	assignee:octocat では、@octocat に割り当てられている項目が表示されます。
label:LABEL	label:bug では、"bug" ラベルが適用された項目が表示されます。
field:VALUE	status:done では、"status" フィールドが "done" に設定された項目が表示されます。
reviewers:USERNAME	reviewers:octocat では、@octocat によってレビューされた項目が表示されます。
milestone:"MILESTONE"	milestone:"QA release" では、"QA release" マイルストーンに割り当てられている項目が表示されます。

フィルターの組み合わせ

複数のフィールドのフィルターを作成できます。 ビューには、すべてのフィルターに一致する項目が表示されます。

修飾子	例
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 では、bug または onboarding のどちらかのラベルがあるが、@octocat と @stevecat の両方に割り当てられている項目が表示されます。

フィルターの否定

ハイフンを前に付けることで、組み合わせを含む任意のフィルターを反転できます。

修飾子	例
-assignee:USERNAME	-assignee:octocat では、@octocat に割り当てられている項目が表示されません。
-field:VALUE	-status:done では、状態が "done" の項目が表示されません。
-field:VALUE,VALUE	-priority:1,2 では、優先度が 1 または 2 の項目が表示されません。

値がない項目のフィルタリング

no: を使用して、値がない項目をフィルタリングできます

修飾子	例
no:assignee	no:assignee では、割り当てられていない項目が表示されます。
no:reviewers	no:reviewers では、レビュー担当者がいない pull request が表示されます。
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 では、オープン中の issue と pull request が表示されます。
	is:closed では、クローズされた issue と pull request が表示されます。
	is:merged では、マージされた pull request が表示されます。
is:TYPE	is:issue では、issue のみが表示されます。
	is:pr では、pull request のみが表示されます。
	is:draft では、下書きの issue と下書きの pull request が表示されます。
	is:issue is:open では、オープン中の issue が表示されます。

クローズ理由によるフィルタリング

クローズされた項目は、そのクローズ理由でフィルタリングできます。

修飾子	例
reason:CLOSE REASON	reason:completed では、完了したことでクローズされた項目が表示されます。
	reason:"not planned" では、"計画されていない" 理由を持つクローズ済み項目が表示されます。
	reason:reopened では、以前にクローズされた後にもう一度オープンにされた項目が表示されます。

項目が最後に更新された日時によるフィルタリング

{number}days 構文を使用して、項目が最後に更新された日時でフィルタリングできます。

修飾子	例
last-updated:NUMBERdays	last-updated:1day では、1 日以上前に更新された項目が表示されます。
	last-updated:7day では、7 日以上前に更新された項目が表示されます。
	-last-updated:10days では、過去 10 日間に更新された項目が表示されます。

GitHub は、次の場合に問題または pull request を更新済みとしてマークします。

• 作成
• 再オープン済
• 編集済み
• コメント済み
• ラベル付き
• 担当者が更新される
• マイルストーンが更新される
• 別のリポジトリに転送されました

数値、日付、イテレーションのフィールドのフィルタリング

>、>=、<、および <= を使用して、数値、日付、イテレーションの各フィールドを比較できます。 日付は YYYY-MM-DD 形式で指定する必要があります。

修飾子	例
field:>VALUE	priority:>1 では、優先度が 1 より大きい項目が表示されます。
field:>=VALUE	date:>=2022-06-01 では、日付が "2022-06-01" 以降の項目が表示されます。
field:<VALUE	iteration:<"Iteration 5" では、"Iteration 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 までの項目が表示されます。
	イテレーション:「イテレーション 1 - イテレーション 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 では、現在のイテレーションと次の 3 つのイテレーションに割り当てられた項目が表示されます。
	date:@today..@today+7 では、日付が今日または次の 7 日間に設定された項目が表示されます。
field:<@keyword	iteration:<@current では、現在のイテレーションの前のいずれかのイテレーションに割り当てられた項目が表示されます。
field:>=@keyword	date:>=@today では、日付が今日以降に設定された項目が表示されます。

テキスト フィールドによるフィルタリング

特定のテキスト フィールドでフィルタリングしたり、すべてのテキスト フィールドとタイトルに対して一般的なテキスト フィルターを使用したりできます。 スペースまたは特殊文字を含むテキストでフィルタリングする場合は、テキストを " または ' の引用符で囲みます。

修飾子	例
field:"TEXT"	title:"Bug fix" には、"バグ修正" と完全に一致するタイトルを含む項目が表示されます。
field:TEXT	note:complete では、"complete" と完全に一致するメモ テキスト フィールドを含む項目が表示されます。
TEXT	API では、タイトルまたはその他のテキスト フィールドに "API" を含む項目が表示されます。
field:TEXT TEXT	label:bug rendering では、タイトルまたは他のテキスト フィールドに "bug" ラベルと "rendering" を含む項目が表示されます。

* をワイルドカードとして使用することもできます。

修飾子	例
field:*TEXT*	label:*bug* では、"bug" という単語を含むラベルを持つ項目が表示されます。
field:TEXT*	title:API* では、"API" で始まるタイトルを含む項目が表示されます。
field:*TEXT	label:*support では、"support" で終わるラベルを含む項目が表示されます。

issue の種類によるフィルター処理

組織で issue の種類を使用している場合は、特定の種類をフィルター処理できます。

修飾子	例
type:"ISSUE TYPE"	type:"bug" には、"バグ" の種類に関する issue が表示されます。

親の issue によるフィルター処理

sub-issue は、親の issue でフィルター処理できます。

修飾子	例
parent-issue:OWNER/REPO#ISSUE NUMBER	parent-issue:octocat/game#4 では、octocat/game の issue #4 に関する issue が親の issue として表示されます。