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

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

  • Parent link

  • 子の作業項目

  • チーム フィールド

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

To search for child work items of a work item in your plan using the work item’s Parent Link:

構文

"Parent Link"

エイリアス

cf[CustomFieldID]

フィールド タイプ

親リンクの関係性

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

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

EMPTY

  • 親作業項目から子作業項目のリストを取得: 

    "Parent Link" = EX-001
  • 複数の親リンクから子作業項目を取得: 

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

    "Parent Link" IS EMPTY
  • Find all work items that have either EX-001 set as a parent or don't have a parent.

    "Parent Link" IN (EX-001, EMPTY)
  • 複数の親リンクから子作業項目を取得:

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

子の作業項目

作業項目の子作業項目を検索するには、次の手順を実行します。

構文

portfolioChildworkitemssOf("work item key")

フィールド タイプ

JQL function returning work item keys

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

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

EMPTY

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

    workitemkey in portfolioChildworkitemsOf("INIT-001")
  • if you want to return just the story-level work items: 

    workitemkey in portfolioChildworkitemsOf("INIT-001") AND workType = Story
  • 必要に応じ、不要な階層レベルの作業項目を返さないようにできます:

    workitemkey in portfolioChildworkitemsOf("INIT-001") AND workType != Epic.

チーム フィールド

To search for work items, including subtasks, using the Team custom field:

構文

"Team"

エイリアス

"Team[Team]" cf[CustomFieldID]

フィールド タイプ

チーム フィールド

オートコンプリート

はい

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

"Team" = MyTeam → "Team" = 3

サポートされる演算子

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

サポートされない演算子

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

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

EMPTY

  • Get the list of work items assigned to a team:

    "Team" = "shared team name"
    • 一連の任意のタイプのチームに割り当てられた作業項目のリストを取得: 

      "Team" IN ("Shared team 1", "Shared team 2", "Shared team 3")
    • チームに割り当てられていない、「iOS app development」スペースのすべての作業項目を検索:

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

      workitemKey = IOS-76 and "Team" IS EMPTY
    • チームが割り当てられていないすべての作業項目を検索:

      "Team" IS EMPTY

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

To search for work items based on their target start or end date:

構文

"Target start" /or/ "Target end"

エイリアス

cf[CustomFieldID]

フィールド タイプ

目標期日フィールド

オートコンプリート

はい

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

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

サポートされる演算子

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

サポートされない演算子

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

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

EMPTY

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

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

"Target start" < now()
  • Find all work items with target end earlier than 5 days ago:

"Target end" <= -5d
  • 目標終了日がないすべての作業項目を検索:

"Target end" is not EMPTY

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。