詳細検索の構文について

Kanboardは詳細検索のために簡単なクエリ言語を使用します。タスク、コメント、サブタスク、リンク、また活動状況の流れも検索できます。

クエリの例

この例では、タスク名に"my title"を含んでいて、明日が期限で自分に割当てられたタスク全てを返します。

assigne:me due:tomorrow my title

プロジェクト検索

タスクIDかタスク名で検索

  • タスクIDで検索: #123
  • タスクIDかタスク名で検索: 123
  • タスク名で検索: 他の属性での検索でマッチしない物を何でも検索。

タスクの状態で検索

属性: status

  • 未完了タスクを検索: status:open
  • 完了タスクを検索: status:closed

担当者で検索

属性: assignee

  • フルネームで検索: assignee:"Frederic Guillot"
  • ユーザー名で検索: assignee:fguillot
  • 複数の担当者を調べる: assignee:user1 assignee:"John Doe"
  • 未割当タスクを検索: assignee:nobody
  • 自分に割当てられたタスクを検索: assignee:me

タスク作成者で検索

属性: creator

  • 自分自身で作成したタスク: creator:me
  • John Doeが作成したタスク: creator:"John Doe"
  • ユーザーID #1が作成したタスク: creator:1

サブタスクの担当者で検索

属性: subtask:assignee

  • 例: subtask:assignee:"John Doe"

色で検索

属性: color

  • 色IDで検索: color:blue
  • 色名で検索: color:"Deep Orange"

期限で検索

属性: due

  • 今日が期限のタスクを検索: due:today
  • 明日が期限のタスクを選択: due:tomorrow
  • 昨日が期限のタスクを選択: due:yesterday
  • 正確な日付の期限でタスクを検索: due:2015-06-29
  • 期限が無いタスクを検索: due:none

日付は ISO 8601形式である必要があります: YYYY-MM-DD.

全ての文字列フォーマットは strtotime() 関数をサポートしており、例えば``next Thursday``, -2 days, +2 months, tomorrow 等があります。

演算子は日付をサポートしています:

  • 指定日より後: due:>2015-06-29
  • 指定日より前: due:<2015-06-29
  • 指定日以降: due:>=2015-06-29
  • 指定日以前: due:<=2015-06-29

変更日で検索

属性: modified もしくは updated

日付の指定方法は期限の時と同じです。

また、最近変更されたタスクのフィルタは :modified:recently. です。

このクエリは設定内のタスクのハイライト期間と同じ値を使用します。

作成日で検索

属性: created

変更日の検索クエリと同じように動きます。

作成日を範囲検索

属性: createdRange

.. (2つのドット)でデータを区切ってください。

例: createdRange:2018/01/21..2018/01/31createdRange:"2018-01-21..2018-01-31"

完了日を範囲検索

属性: completedRange

.. (2つのドット)でデータを区切ってください。

例: completedRange:2018/01/21..2018/01/31completedRange:"2018-01-21..2018-01-31"

変更日を範囲検索

属性: updatedRange, modifiedRange

.. (2つのドット)でデータを区切ってください。

例: updatedRange:2018/01/21..2018/01/31updatedRange:"2018-01-21..2018-01-31"

タスクの移動日を範囲検索

属性: movedRange

.. (2つのドット)でデータを区切ってください。

例: movedRange:2018/01/21..2018/01/31movedRange:"2018-01-21..2018-01-31"

開始日で検索

属性: started

概要で検索

属性: description or desc

例: description:"text search"

完了日で検索

属性: completed

外部参照で検索

タスクの外部参照IDとは、例えば別のソフトウェアから付けられたチケット番号等です。

  • 外部参照IDで探す、: ref:1234reference:TICKET-1234
  • 外部参照IDが無い場合: reference:none
  • ワイルドカード検索: ref:TICKET-*

カテゴリで検索

属性: category

  • カテゴリで検索: category:"Feature Request"
  • これらのカテゴリに該当する全てのタスクを検索: category:"Bug" category:"Improvements"
  • カテゴリが割り当てられていないタスクを検索: category:none

プロジェクトで検索

属性: project

  • プロジェクト名で検索: project:"My project name"
  • プロジェクトIDで検索: project:23
  • プロジェクトIDで検索: project:23 - 複数のプロジェクトからタスクを検索: project:"My project A" project:"My project B"

カラムで検索

属性: column

  • カラム名で検索: column:"Work in progress"
  • 複数のカラムからタスクを検索: column:"Backlog" column:ready

スイムレーンで検索

属性: swimlane

  • スイムレーンで検索: swimlane:"Version 42"
  • 複数のスイムレーンからタスクを検索: swimlane:"Version 1.2" swimlane:"Version 1.3"

タスクのリンクで検索

属性: link

  • リンク名で検索: link:"is a milestone of"
  • 複数のタスクリンクで検索: link:"is a milestone of" link:"relates to"

コメントで検索

属性: comment

  • コメントに含まれる内容を検索します: comment:"My comment message"

タグで検索

属性: tag

  • 例: tag:"My tag"

スコア/複雑さで検索

属性: score or complexity

  • score:>=21
  • complexity:8

活動状況を検索

タスク名でイベントを検索

属性: title or none (default)

  • 例: title:"My task"
  • タスクIDで検索: #123

タスクの状況でイベントを検索

属性: status

イベント作者で検索

属性: creator

イベント作成日で検索

属性: created

プロジェクトでイベントを検索

属性: project