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" マイルストーンに割り当てられている項目が表示されます。

フィルターの組み合わせ

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

修飾子例
          <code>
          assignee:
          <em>
          USERNAME
          </em>
          field:
          <em>
          VALUE
          </em>
          </code>
         | 
          **assignee:octocat priority:1** では、優先度が @octocat の項目が **** に割り当てられていることが表示されます。

同じフィールドから複数の値をフィルタリングすることもできます。 値をコンマで区切ると、指定された値のいずれかに一致する項目がビューに表示されます。

修飾子例
assignee:USERNAME,USERNAME
          **assignee:octocat,stevecat** では、@octocat または @stevecat に割り当てられた項目が表示されます。

同じフィールドから複数の値をフィルタリングし、指定されたすべての値に一致する項目を表示するには、値ごとに修飾子を繰り返します。

修飾子例
          <code>
          assignee:
          <em>
          USERNAME
          </em>
          assignee:
          <em>
          USERNAME
          </em>
          </code>
         | 
          **assignee:octocat assignee:stevecat** では、@octocat と @stevecat の両方に割り当てられている項目が表示されます。

一部の項目に一致するフィルターと、すべての項目に一致するフィルターを組み合わせることもできます。

修飾子例
          <code>
          field:
          <em>
          VALUE
          </em>
          ,
          <em>
          VALUE
          </em>
          assignee:
          <em>
          USER
          </em>
          assignee:
          <em>
          USER
          </em>
         | 
          **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 の項目が表示されません。

値がある項目のフィルター処理

          `has:` を使って、値がある項目をフィルター処理できます
修飾子例
has:assignee
          **has:assignee** では、担当者のいる項目が表示されます。

|has:label | has:label では、ラベルのある項目が表示されます。 |has:FIELD | has:priority では、優先度フィールドに値が設定されている項目が表示されます。

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

          `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 と下書きのプルリクエストが表示されます。 | | is:issue is:open では、オープン中の issue が表示されます。

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

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

修飾子例
reason:CLOSE REASON
          **reason:completed** では、完了したことでクローズされた項目が表示されます。

| | reason:"not planned" では、"計画されていない" 理由を持つクローズ済み項目が表示されます。 | | reason:reopened では、以前にクローズされた後にもう一度オープンにされた項目が表示されます。

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

          `updated` フィルター フィールドでは、最終変更日に基づいて項目をフィルター処理する、より強力かつ柔軟な方法を利用できます。
修飾子例
updated:NUMBERdays
          **
          updated:@today
          ** を指定すると、今日更新された項目が表示されます。

| | ** updated:@today-1d ** を指定すると、1 日前に更新された項目が表示されます。 | | updated:>@today-1w を指定すると、最終更新日が 7 日以上前の項目が表示されます。 | | updated:>@today-30d を指定すると、最終更新日が 30 日以上前の項目が表示されます。 | | ** -updated:@today ** を指定すると、今日更新された項目は除外されます。

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

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

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

          `>`、`>=`、`<`、および `<=` を使用して、数値、日付、イテレーションの各フィールドを比較できます。 日付は `YYYY-MM-DD` 形式で指定する必要があります。
修飾子例
field:>VALUE
          **priority:&gt;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" を含む項目が表示されます。

すべてのテキスト フィールドとタイトル全体で一般的なテキスト検索を行う場合、一致は各単語の先頭のみに基づき、その一部に基づくものではありません。 たとえば、issue のタイトルが "Document full-text search":

  •         **一致**: 「文書」、「完全」、「検索」

  •         **一致しない**: "cument"、"ext"、"arch"

この方法は、一般的なテキスト検索をより正確かつ関連性の高いものに保つのに役立ちます。

          <code>&ast;</code> をワイルドカードとして使用することもできます。
修飾子例
field:*TEXT*
          **label:&ast;bug&ast;** では、"bug" という単語を含むラベルを持つ項目が表示されます。

| field:TEXT* | title:API* では、"API" で始まるタイトルを含む項目が表示されます。 | field:*TEXT | label:*support では、"support" で終わるラベルを含む項目が表示されます。

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

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

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

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

sub-issue は親の課題でフィルタリングできます。

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