JQL の計画機能からカスタム フィールドを検索する

計画内でカスタム課題フィールドを含む課題を検索するには、Jira クエリ言語(JQL)を使用します。次を検索できます。

  • Parent link

  • 子課題

  • チーム フィールド

  • 目標開始日または目標終了日

計画内の課題の子課題を、課題の親リンクを使用して検索するには、次の手順に従います。

構文

1 "Parent Link"

エイリアス

1 cf[CustomFieldID]

フィールド タイプ

親リンクの関係性

オートコンプリート

いいえ

サポートされる演算子

IS,IS NOT,=,!=,IN,NOT IN

サポートされない演算子

~,!~,>,>=,<,<=
WAS,WAS IN,WAS NOT,WAS NOT IN,CHANGED

サポート対象のキーワード

1 EMPTY

  • 親課題から子課題の一覧を取得: 

    1 "Parent Link" = EX-001
  • 複数の親リンクから子課題を取得: 

    1 "Parent Link" IN (EX-000, EX-001, EX-002, EX-003)
  • 親リンクを持たないすべての課題を検索:

    1 "Parent Link" IS EMPTY
  • EX-001 が親として設定されている、または親を持たないすべての課題を検索します。

    1 "Parent Link" IN (EX-001, EMPTY)
  • 複数の親リンクから子課題を取得:

    1 "Parent Link" IN (EX-000, EX-001, EX-002, EX-003)

子課題

特定の課題の子課題を検索するには、次のようにします。

構文

1 portfolioChildIssuesOf("issue key")

フィールド タイプ

課題キーを返す JQL 関数

オートコンプリート

いいえ

サポートされる演算子

IS,IS NOT,=,!=,IN,NOT IN

サポートされない演算子

~,!~,>,>=,<,<=
WAS,WAS IN,WAS NOT,WAS NOT IN,CHANGED

サポート対象のキーワード

1 EMPTY

  • エピック階層レベルの子課題だけでなく、INIT-00 にあるすべての子課題を取得:

    1 issuekey in portfolioChildIssuesOf("INIT-001")
  • ストーリーレベルの課題のみを返したい場合: 

    1 issuekey in portfolioChildIssuesOf("INIT-001") AND issueType = Story
  • 必要に応じ、不要な階層レベルの課題を返さないようにできます:

    1 issuekey in portfolioChildIssuesOf("INIT-001") AND issueType != Epic.

チーム フィールド

チームのカスタム フィールドを使用する、サブタスクを含む課題を検索:

構文

1 "Team"

エイリアス

1 2 "Team[Team]" cf[CustomFieldID]

フィールド タイプ

チーム フィールド

オートコンプリート

はい

注: チーム名の入力候補から共有チームの名前を選択すると、クエリ内のチーム名が数値の ID で置き換えられます。次の例をご確認ください。

1 "Team" = MyTeam → "Team" = 3

サポートされる演算子

IS,IS NOT,=,!=,IN,NOT IN

サポートされない演算子

~,!~,>,>=,<,<=
WAS,WAS IN,WAS NOT,WAS NOT IN,CHANGED

サポート対象のキーワード

1 EMPTY

  • あるチームに割り当てられた課題の一覧を取得:

    1 "Team" = "shared team name"
    • 一連の任意のタイプのチームに割り当てられた課題の一覧を取得: 

      1 "Team" IN ("Shared team 1", "Shared team 2", "Shared team 3")
    • チームに割り当てられていない、"iOS app development" プロジェクトのすべての課題を検索:

      1 project = iOS app development and "Team" IS EMPTY
    • チームに割り当てられていない、"IOS-76" エピックに所属するすべてのストーリーを検索: 

      1 issueKey = IOS-76 and "Team" IS EMPTY
    • チームが割り当てられていないすべての課題を検索:

      1 "Team" IS EMPTY

目標開始日または目標終了日

目標開始日または目標終了日に基づいて課題を検索:

構文

1 "Target start" /or/ "Target end"

エイリアス

1 cf[CustomFieldID]

フィールド タイプ

目標期日フィールド

オートコンプリート

はい

注: 入力候補リストには、関数名がユーザー指定のテキストと一致する日付/時刻値を返す JQL 関数が含まれています。次の例をご確認ください。

1 "Target start" = end → endOfDay(), endOfMonth(), endOfWeek(), endOfYear()

サポートされる演算子

=, !=, NOT IN, IN, IS NOT, IS, >, >=, <, <=

サポートされない演算子

~,!~,>,>=,<,<=
WAS,WAS IN,WAS NOT,WAS NOT IN,CHANGED

サポート対象のキーワード

1 EMPTY

  • 2020 年 1 月 2 日以降が目標開始日となっているすべての課題を検索:

1 "Target start" >= "2020-01-02"
  • 現在のタイムスタンプより前に目標開始日が設定されているすべての課題を検索:

1 "Target start" < now()
  • 目標終了日が 5 日よりも前の全課題を検索:

1 "Target end" <= -5d
  • 目標終了日がない全課題を検索:

1 "Target end" is not EMPTY

その他のヘルプ