検索クエリリファレンス
このページでは、YouTrack クエリ言語で使用されている属性とキーワードのリストを提供しています。検索クエリで認識される演算子、シンボル、相対日付パラメーターの完全なリストもあります。
このページのいくつかの参照はシンプル検索では利用できません。アクセスするには拡張検索に切り替えてください。
課題の属性
すべての課題には、YouTrack によって自動的に設定される基本属性があります。これには、課題 ID、課題を作成または最後に更新したユーザーなどが含まれます。
これらの検索属性は、検索クエリの文法内の <Attribute> を表します。それらの値は、<Value> または <ValueRange> パラメーターに対応しています。
属性ベースの検索は構文 attribute: value を使用します。
target 属性には、コンマで区切って複数の値を指定できます。
構文
attribute: -valueを使用して検索結果から特定の値を除外します。
多くの場合、# または - シンボルを使用して属性値および参照値を直接省略できます。追加のガイドラインについては、拡張検索を参照してください。
添付ファイルのテキスト
指定されたテキストを含むイメージ添付ファイルを含む課題を返します。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
エイリアス | イメージテキスト |
サンプル | テキスト |
添付
指定されたファイル名の添付ファイルを含む issue を返します。
値 | テキストを受け入れます。ファイル名にスペースが含まれる場合は、複数の単語を引用符または中括弧で囲みます。 |
サンプル | 自分に割り当てられているスケッチで始まるファイル名の添付ファイルがある未解決の課題を見つけるには、 |
ボード
指定されたアジャイルボード上の指定されたスプリントに割り当てられている課題を返します。スプリントが無効になっているアジャイルボードに割り当てられている課題を検索するには、has: <board name> を使用してください。
値 | スプリントの名前を受け入れます。スプリント名を複数の単語で中括弧で囲みます。 スプリント名を この属性は、構文 |
サンプル | YouTrack スクラムボード上のスプリント 21 に割り当てられているすべての課題を見つけるには、 |
CC 受信者
指定されたユーザーが CC として追加されたチケットを返します。
値 | ユーザーを受け入れます。 |
サンプル | ユーザー名 minnie.terry のエージェントが CC 受信者として追加されているすべてのチケットを検索するには、 |
顧客グループ
指定された顧客グループと共有されているヘルプデスクチケットを返します。
値 | 顧客グループを受け入れます。 |
サンプル | 顧客グループアクメサポートと共有されているすべてのチケットを検索するには、 |
コード
課題の説明またはコメントでコードとしてフォーマットされている、指定された 1 つまたは複数の単語に一致する単語形式を含む課題を返します。これには、インラインコードスパン、インデントおよびフェンスで囲まれたコードブロック、スタックトレースとしてフォーマットされた一致が含まれます。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
サンプル | 説明またはコメント内でコードとしてフォーマットされている、hello および world という単語を含む TS プロジェクト内の未解決の課題を見つけるには、 |
コメント化
指定日または指定期間内にコメントが追加された issue を返します。
値 | 日付、カスタム期間、相対日付パラメーターを受け入れます。 この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーおよびグループの提案を表示するには、commenter 属性を使用します。 |
サンプル | 現在のユーザーに割り当てられていて先週コメントした YouTrack プロジェクト内のすべての課題を見つけるには、 |
コメンター
指定されたユーザーまたは指定されたグループのメンバーによってコメントされた issue を返します。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | コメントしました |
サンプル | 今日作成され、現在のユーザーに割り当てられ、ユーザー名がジョンのユーザーによってコメントされたすべての課題を検索するには、「 |
コメント
指定された単語またはコメント内の単語に一致する単語形式を含む issue を返します。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
サンプル | アジャイル管理サブシステム内のタイプ機能で、1 つ以上のコメントにバーンダウンという単語を含む JT プロジェクトの課題を見つけるには、 |
作成しました
特定の日付または特定の期間内に作成された課題を返します。
値 | 日付、カスタム期間、相対日付パラメーターを受け入れます。この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーおよびグループの提案を表示するには、reporter 属性を使用します。 |
サンプル | 今日作成され、現在のユーザーに割り当てられているすべての課題を見つけるには、 |
description
指摘の説明で指定された単語と一致する単語形式を含む課題を返します。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
サンプル | 説明に文字列 groovy.lang.resolve.CollectClassMembersUtil を含む GR プロジェクトの未解決の課題を見つけるには、 |
ドキュメントタイプ
課題またはチケットタイプのドキュメントを返します。
値 | キーワード |
サンプル | 自分に課題が割り当てられていないすべてのチケットを検索するには、「 |
ガント
指定されたガントチャートに割り当てられている課題を返します。
値 | ガントチャートの名前を受け入れます。チャート名は複数の単語で囲みます。 |
サンプル | YouTrack への移行という名前のガントチャートに割り当てられているすべての課題を検索するには、 |
持っている
has キーワードは、ブール検索語として機能します。検索クエリで使用すると、指定した属性の値を含むすべての課題が返されます。指定された属性の前にマイナス演算子（-）を使用して、空の値を持つ issue を見つけます。
例: TST プロジェクトで、現在のユーザーに割り当てられ、重複リンクがあり、アタッチファイルがあるがコメントがないすべての課題を検索するには、in: TST for: me has: duplicates , attachments , -comments と入力します。
has キーワードを以下の属性と組み合わせて使用することができます。
属性 | 説明 |
|---|---|
添付ファイルがある課題を返します。 | |
ボード | 少なくとも 1 つのアジャイルボードに割り当てられている課題を返します。除外演算子 ( |
指定されたアジャイルボードに割り当てられている課題を返します。 | |
1 つ以上のコメントがある課題を返します。 | |
空の説明がない課題を返します。 | |
指定されたカスタムフィールドに何らかの値が含まれている課題を返します。スペースを含むフィールド名は中括弧で囲んでください。 | |
ガントチャートに割り当てられている課題を返します。 | |
指定された外側の名前または内側の名前と一致するリンクを持つ issue を返します。スペースを含むリンク名は中括弧で囲みます。 例: 親課題にサブタスクとしてリンクされている課題を検索するには、次を使用します。 has: {Subtask of} 親課題にリンクされていない課題を見つけるには、次を使用します。 has: -{Subtask of} | |
課題リンクの種類を問わず、課題が設定されているものを返します。 | |
現在のユーザーに対してスタータグが付いている課題を返します。 | |
過小評価 | 合計所要時間が当初の見積もり値よりも大きい課題を返します。 |
vcs の変更を含む課題を返します。 | |
1 つ以上の投票がある課題を返します。 | |
1 つ以上の作業項目がある課題を返します。 |
課題 ID
指定された issue ID と一致する issue を返します。この属性は、構文 #<issue ID> または -<issue ID> を使用して単一の値として参照することもできます。検索で単一の号が返されると、その結果は単一号ビューに表示されます。
属性ベースの検索（
issue ID: <value>または#<value>）の構文を使用しない場合、入力もテキスト検索として解析されます。指定された課題 ID に一致する課題に加えて、検索結果には、テキスト属性に指定された ID を含む課題が含まれます。issue ID を引用符で囲むと、入力はテキスト検索としてのみ解析されます。検索結果には、テキスト属性に指定された ID を含む issue のみが含まれます。
課題 ID がテキスト検索として解析された場合でも、結果には課題のリンクは含まれないことに注意してください。課題のリンクに基づいて課題を検索するには、links 属性を使用するか、特定のリンクタイプを参照します。
値 | 課題 ID のみを受け入れます。 |
サンプル | ID JT-4232 の課題を見つけるには、
|
リンク
指定された課題へのリンクを含むすべての課題を返します。
値 | 課題 ID のみを受け入れます。 |
サンプル | issue ABC-4532 にリンクされている TEST プロジェクト内のすべての issue を見つけるには、 |
類維
指摘の概要または説明に、指定の指摘の指摘の要約または説明にある単語が含まれている指摘を返します。検索結果が関連性でソートされている場合、issue summary に一致する単語が含まれている issue にはより高い重みが付けられます。
値 | 課題 ID のみを受け入れます。 |
サンプル | ABC-4532 の課題の概要と説明で使用されている一致する単語を含む TEST プロジェクト内のすべての課題を検索するには、 |
メンションされている
対象の課題の説明またはコメントで参照されている課題 ID を持つ課題を返します。補足テキストフィールドの課題 ID は検索結果に含まれません。
値 | 課題 ID のみを受け入れます。 |
サンプル | 課題 JT-4232 の説明またはコメント内に記載されているすべての課題を検索するには、 |
メンション
指定されたユーザーの @mention または説明やコメントで参照されている課題 ID のいずれかを含む課題を返します。補足テキストフィールド内のユーザーのメンションと課題 ID は検索結果に含まれません。
値 | 課題 ID またはユーザーを受け入れます。 |
サンプル | ユーザー名 valerie を持つユーザーにメンションしているが、アカウントを参照するメンションが含まれていないすべての課題を検索するには、 説明またはコメントに課題 ID JT-4232 の課題が記載されているすべての課題を検索するには、「 |
組織
指定された組織に属する課題を返します。この属性は単一の値として参照することもできます。
値 | 組織名を受け入れます。 |
サンプル | 現在のユーザーに割り当てられているテストクラスター組織に属するすべての課題を検索するには、 |
プロジェクト
指定されたプロジェクトに属する課題を返します。この属性は単一の値として参照することもできます。
値 | プロジェクト名またはプロジェクト ID を受け入れます。 |
エイリアス | 内 |
サンプル | 現在のユーザーに割り当てられている ReSharper プロジェクトに属するすべての課題を検索するには、 |
報告者
指定されたユーザーまたは指定されたグループのメンバーによって作成された課題とチケット (指定されたユーザーの代わりに作成されたチケットを含む) を返します。現在のユーザーが作成した課題を返すには、me を使用します。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | by, created by, reported by |
サンプル | マイナーまたは通常の優先度を持つものを除いて、ユーザー名 yarko でユーザーによって報告されたすべてのバグを見つけるには、 |
解決日時
特定の日付または特定の期間内に解決された課題を返します。
値 | 日付、カスタム期間、相対日付パラメーターを受け入れます。 |
サンプル | 今月の MPS プロジェクトで解決された課題をすべて見つけるには、 |
保存した検索条件
保存された検索条件に一致する課題を返します。この属性は、#<saved search name> または -<saved search name> という構文で単一の値として参照することもできます。
値 | 保存された検索の名前を受け入れます。 |
サンプル | 今週リシャーパーとして保存された検索クエリと一致する課題を見つけるには、 |
提出者
指定されたユーザー、または別のユーザーに代わって指定されたグループのメンバーによって送信された課題を返します。現在のユーザーによって送信された課題を返すには、me を使用します。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | から提出された |
サンプル | 他のユーザーに代わってユーザー名 minnie.terry のエージェントによって送信されたすべてのチケットを検索するには、 |
概要
指摘サマリー内の指定された単語に一致する単語形式を含む課題を返します。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
サンプル | 要約でスクラムまたはボードの課題を見つけるには、 要約にアジャイル管理という単語が含まれるユーザー john.johnson に割り当てられている TS プロジェクトの課題を見つけるには（この順序で表示されます）、 |
タグ
指定したタグに一致する課題を返します。この属性は、構文 #<tag name> または -<tag name> を使用して単一の値として参照することもできます。
値 | タグの名前を受け入れます。 |
エイリアス | としてタグ付け |
サンプル | 優先順位がマイナーで、myparser タグを持つすべての課題を見つけるには、 |
更新日
最新の変更が特定の日付または指定された時間枠内に発生した課題を返します。
値 | 日付、カスタム期間、相対日付パラメーターを受け入れます。 この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーとグループの提案を表示するには、updater 属性を使用します。 |
サンプル | 今月最新の変更が適用された MPS プロジェクトで解決されたすべての課題を見つけるには、 |
アップデータ
指定されたユーザーまたは指定されたグループのメンバーによって最後に更新された課題を返します。最後の更新を適用した課題を返すには、me を使用してください。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | 更新ユーザー： |
サンプル | 昨日最後に更新した最後の人物であるすべての主要な課題を見つけるには、 |
VCS の変更
指定された SHA-1 コミットハッシュによって識別されるコミットオブジェクトに適用された vcs の変更を含む issue を返します。
値 | 完全な SHA-1 コミットハッシュを受け入れます。コミットハッシュの短縮形は認識されません。 |
サンプル | 特定のコミットに対する vcs の変更を含む課題を見つけるには、 |
表示対象
指定されたユーザーまたは指定されたグループのメンバーに見える課題を返します。
値 | ユーザーまたはグループを受け入れます。 キーワード |
サンプル | YouTrack チームのメンバーのみに閲覧が制限されている主要な課題をすべて見つけるには、 表示がユーザーとグループのセットに制限されている課題を見つけるには、 |
投票者
指定されたユーザーまたは指定されたグループのメンバーからの投票がある issue を返します。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | 投票した |
サンプル | YouTrack チームのメンバーから投票したすべての主要課題を見つけるには |
カスタムフィールド
カスタムフィールドで特定の値が割り当てられている課題を見つけることができます。他の課題属性と同様に、構文 attribute: value または attribute: -value を使用します。この場合、属性はカスタムフィールドの名前です。ほとんどの場合、# または - シンボルを使用して値を直接参照できます。
空の値が割り当てられているカスタムフィールドの場合、このプロパティを値として参照できます。例: 特定のユーザーに割り当てられていない課題を検索するには、Assignee: Unassigned または #Unassigned と入力します。フィールドに空の値が割り当てられていない場合は、構文 <field name>: {No <field name>} または has: -<field name> を使用してフィールドに値を格納しない課題を見つけます。
このセクションでは、デフォルトのカスタムフィールドの検索属性を一覧表示します。デフォルトのフィールドとその値はカスタマイズ可能です。実際のフィールド名、値、エイリアスは異なる場合があります。
影響を受けるバージョン
製品の特定のバージョンで検出された課題を返します。
値 | 影響を受けるバージョンフィールドに格納されている値、およびキーワード |
エイリアス | 影響する、影響する、影響する |
サンプル | 製品のバージョン EAP3 で検出された、ユーザージョンに割り当てられているすべての課題を見つけるには、 |
担当者
指定されたユーザーまたは指定されたグループのメンバーに割り当てられているすべての課題を返します。
値 | ユーザーまたはグループを受け入れます。 |
エイリアス | assigned to, for |
サンプル | ユーザー名ジョンのユーザーに割り当てられている優先度ショーストッパーのすべての課題を検索するには、 |
修正バージョン
製品の特定のバージョンで修正された課題を返します。
値 | 修正バージョンフィールドに格納されている値、およびキーワード |
エイリアス | 修正、修正、バージョン |
サンプル | 製品のバージョン EAP3 で修正された、ユーザージョンに割り当てられているすべての課題を見つけるには、 |
ビルドで修正
指定されたビルドで修正された課題を返します。
値 | ビルドで修正フィールドとキーワード |
エイリアス | ビルド、修正ビルド、修正、修正 |
サンプル | ビルド番号 36724 で修正された、ユーザージョンに割り当てられているすべての課題を見つけるには、 |
優先度
指定した優先度と一致する課題を返します。
値 | 優先度フィールドとキーワード |
サンプル | 現在のユーザーに割り当てられている優先順位ショーストッパーの未解決の課題をすべて見つけるには、 |
状態
指定された状態に一致する課題を返します。
解決済みおよび未解決の状態は、状態フィールドに格納されている特定の値のプロパティであるため、課題に直接割り当てることはできません。
デフォルトでは、Fixed、修正しない、複製、未完了、廃止、再現できないの状態は Resolved に設定されています。
送信済み、オープン、進行中、再開済み、話し合いますの状態は、未解決として設定されます。
値 | 状態フィールドに格納されているすべての値とキーワード |
サンプル | 状態修正しないで閉じられた、ユーザー名 john のユーザーに割り当てられているすべての重大なバグを見つけるには、 |
サブシステム
プロジェクト内の特定のサブシステムに割り当てられている課題を返します。
値 | サブシステムフィールドとキーワード |
エイリアス | 内 |
サンプル | スマート UI サブシステムに属するすべての課題を見つけるには、 |
タイプ
指定された課題タイプに一致する課題を返します。
値 | タイプフィールドとキーワード |
サンプル | 例外タイプが割り当てられ、現在のユーザーに割り当てられているすべての課題を検索するには、 |
課題リンク
他の課題に接続しているリンクに基づいて課題を検索できます。特定の課題リンクタイプを参照する検索クエリは、2 つの異なる方法で解釈できます。
<link type>: <issue ID>として指定された場合、クエリは、このリンクタイプを使用して指定された課題にリンクされた課題を返します。<link type>: (<sub-query>)を使用すると、クエリは、このリンクタイプを使用して、指定されたサブクエリに一致する課題にリンクされた課題を返します。
リンクされた課題を検索する場合、任意の課題リンクタイプの外向きの名前または内向きの名前を入力してから、検索条件を指定できます。
このリストには、YouTrack でデフォルトで提供される課題リンク・型の検索パラメーターが含まれています。デフォルトの課題リンク型はカスタマイズできます。つまり、実際の名前は異なる場合があります。この構文を使用して、カスタムリンク型を参照する検索クエリを作成することもできます。
リンク
ターゲットの課題にリンクされている課題を返します。
値 | 課題 ID のみを受け入れます。 |
サンプル | ID JT-5072 の課題にリンクされているすべてのタスクを検索するには、 |
集計
ターゲットの課題に間接的にリンクされている課題を返します。この検索用語を使用して、たとえば、親の課題の親の課題である課題、ターゲットの課題のサブタスクでもある課題のサブタスクを検索します。結果には、直接または間接を問わず、指定されたリンクタイプを使用してターゲットの課題にリンクされている課題が含まれます。
この検索引数は、集約リンク型とのみ互換性があります。
値 | 課題 ID のみを受け入れます。 |
サンプル | ID JT-5072 の課題のサブタスクでもある課題にサブタスクとしてリンクされているすべてのタスクを検索するには、 |
依存先
ターゲットの課題へのリンクに依存する課題、または指定されたサブクエリに一致する課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | 課題 JT-5072 に依存する、自分に割り当てられているすべてのタスクを検索するには、 未解決の課題に依存する自分に割り当てられたタスクを見つけるには、 |
重複
ターゲットの課題または指定されたサブクエリに一致する課題へのリンクが重複している課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | issue JT-5072 と重複する issue を見つけるには、 未解決の課題と重複する課題を見つけるには、 |
Is duplicated by
ターゲットの課題または指定されたサブクエリに一致する課題へのリンクによって重複している課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | issue JT-5072 と重複している issue を見つけるには、 現在進行中の課題によって重複している課題を見つけるには、 |
Is required for
ターゲットの課題または指定されたサブクエリに一致する課題へのリンクに必要な課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | 自分に割り当てられ、課題 JT-5072 に必要な課題を見つけるには、 自分に割り当てられている、その他の未解決の課題に必要なすべての課題を見つけるには、 |
親
ターゲットの課題または指定されたサブクエリに一致する課題へのリンクの親を持つ課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | JT-5072 の親タスクを見つけるには、 未解決のサブタスクがある解決済みの課題を見つけるには、 |
Relates to
ターゲットの課題へのリンクに関連する課題、または指定されたサブクエリに一致する課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | 自分に割り当てられ、ID JT-5072 の課題に関連する課題を見つけるには、 その他の未解決の課題に関連する課題を見つけるには、 |
以下のサブタスク：
ターゲットの課題へのリンクのサブタスクを持つ課題、または指定されたサブクエリに一致する課題を返します。
値 | 課題 ID またはサブクエリを受け入れます。 |
サンプル | 自分に割り当てられ、サブタスクとして JT-5072 にリンクされている課題を見つけるには、 親の課題の製品フィールドの値が YouTrack である未解決の課題を見つけるには、 |
タイムトラッキング
タイムトラッキングデータを含む課題を見つけるために使用できる検索属性の専用セットがあります。これらの属性は、課題に作業項目として追加された特定の値を探します。
work
作業項目内の指定された単語またはフレーズに一致する単語形式を含む課題を返します。
値 | テキストを受け入れます。値はテキスト検索の説明に従って解析されます。 |
サンプル | 任意の形式の単語「test」を含む作業項目に関する課題を検索するには、「 |
作業の作者
指定されたユーザーによって追加された作業項目を持つ課題を返します。
値 | ユーザーのみを受け入れます。 |
サンプル | 現在のユーザーによって追加された作業項目を含む 'TST' プロジェクト内のすべての課題を見つけるには、次のように入力します。 |
作業タイプ
指定された作業タイプが割り当てられている作業項目を持つ課題を返します。クエリ work type: {No type} は、作業項目タイプが割り当てられていない作業項目を持つ課題を返します。
値 | 定義済みの作業項目の種類を受け入れます。 |
サンプル | |
就業日
指定された日付または指定された時間枠内に記録された作業項目を含む issue を返します。
値 | 日付、カスタム期間、相対日付パラメーターを受け入れます。 |
サンプル | 先週追加された作業項目を含む 'TST' プロジェクト内のすべての課題を見つけるには、次のように入力します。 |
カスタム作業項目の属性
特定の作業項目属性に指定された値が割り当てられている作業項目がある課題を返します。
値 | 属性名と値のペアを受け入れます。 |
サンプル | 経費属性に請求不可の値が割り当てられている「TST」プロジェクト内のすべての課題を検索するには、次のように入力します。 |
属性のソート
検索クエリによって返される課題の一覧の並べ替え順序を指定できます。
次の一覧にある属性のいずれかで課題を並べ替えることができます。検索クエリの文法では、これらの属性は <SortAttribute> 値を表します。
並べ替え
クエリによって返された課題を指定された順序で並べ替えます。
値 | 次の属性の値で課題を並べ替えることができます: スター、更新済み、アップデーター、作成済み、{ 解決日 }、プロジェクト、報告者、{ 課題 ID}、投票、概要、コメント、<カスタム field>、および { アタッチファイルサイズ }。 |
ソート順 | asc、desc |
エイリアス | 並び順 |
サンプル | 現在のユーザに割り当てられている、または報告されている修正済み状態の課題をすべて検索し、最新の課題を最初に表示して、最後の更新の日付で降順にソートするには、 |
テキスト検索を実行すると、結果は関連性によってソートできます。ソート属性として関連性を指定することはできません。詳しくは、関連性による並べ替えを参照してください。
キーワード
キーワードで置き換えることができる値がいくつかあります。検索クエリでキーワードを使用するときは、属性を指定しません。キーワードの前には、番号記号（#）またはマイナス演算子が付きます。YouTrack 検索クエリの文法では、これらのキーワードは <SingleValue> に対応しています。
自分
現在のユーザーを参照します。このキーワードは、ユーザーを受け入れる任意の属性の値として使用できます。
単一値（#me）として使用された場合、検索は、現在のユーザーに割り当てられている、報告されている、現在のユーザーによってコメントされている課題を返します。
例: 現在のユーザーに割り当てられている、報告されている、現在のユーザーからのコメントが含まれている未解決の課題を検索するには、#me -Resolved と入力します。
結果には、ユーザーとして値を格納する任意のカスタムフィールドに現在のユーザーへの参照を含む課題も含まれます。例: user 型を格納するカスタムフィールドレビューアーがあります。検索クエリ #me -Resolved には、このカスタム項目の現在のユーザを参照する issue も含まれています。
my
私にとっての別名。
解決
このキーワードは、解決済みの課題のプロパティを参照します。このプロパティは、state タイプを格納するカスタムフィールドの現在の値または値の組み合わせに基づいて設定されます。デフォルトの状態フィールドでは、Resolved プロパティは、Fixed、修正しない、複製、未完了、廃止、再現できないの値に対して有効になっています。
複数の状態タイプフィールドを使用するプロジェクトの場合、Resolved プロパティは、すべての状態タイプフィールドに解決済みと見なされる値が割り当てられている場合にのみ true になります。
例: 今日更新されたすべての解決済みの課題を見つけるには、#Resolved updated: Today と入力してください。
未解決
このキーワードは、未解決の課題プロパティを参照します。このプロパティは、state タイプを格納するカスタムフィールドの現在の値または値の組み合わせに基づいて設定されます。デフォルトの状態フィールドでは、Submitted、オープン、進行中、Reopened、話し合いますの値に対して Resolved プロパティが無効になっています。
複数の状態タイプフィールドを使用するプロジェクトの場合、いずれかの状態タイプフィールドに解決済みと見なされない値が割り当てられている場合、Unresolved プロパティは true になります。
例: テストプロジェクトでユーザー john.doe に割り当てられている未解決の課題をすべて見つけるには、#Unresolved project: Test for: john.doe と入力します。
リリース済み
このキーワードは、version タイプを格納するフィールドの値の Released プロパティを参照します。バージョンフィールドの属性名またはエイリアスと一緒にのみ使用できます。これは、単一の値として参照できないことを意味します。
複数の値を格納するフィールドの場合、検索クエリは、フィールドに格納されているバージョンの少なくとも 1 つがリリース済みとしてマークされている課題を返します。
例: まだリリースされていないバージョンで修正されているテストプロジェクト内のすべての課題を見つけるには、in: Test fixed in: -Released と入力します。
アーカイブ済み
このキーワードは、version タイプを格納するフィールドの値の Archived プロパティを参照します。バージョンフィールドの属性名またはエイリアスと一緒にのみ使用できます。これは、単一の値として参照できないことを意味します。
複数の値を保存するフィールドでは、検索クエリは、フィールドに保存されているすべてのバージョンがアーカイブ済みとしてマークされている課題のみを返します。
例: アーカイブされたバージョンで修正されているテストプロジェクト内のすべての課題を見つけるには、in: Test fixed in: Archived と入力します。
演算子
検索クエリの文法は、明示的な論理演算子を含まない検索クエリにデフォルトのセマンティクスを適用します。
複数の属性の値を指定する検索は、連言として扱われます。これは、値が
AND演算子によって結合されているかのように処理されることを意味します。例:State: {In Progress} Priority: Criticalは、指定された状態と優先順位が割り当てられている課題を返します。これは、同じ属性の特定の値への敬意と組み合わせて、特定の属性（
has）の値の有無を検索するクエリにまでおよびます。値の有無と値自体は、課題の個別の属性と見なされます。例:has: assignee Assignee: meは、担当者が設定され、その担当者があなたである場合にのみ課題を返します。テキスト検索では、複数の単語を含む検索は結合として扱われます。つまり、単語は
AND演算子で結合されているかのように扱われます。例:State: Open context usageは、contextとusageの両方に一致するフォームを含む課題を返します。単一の属性に複数の値が含まれている検索は、選言的として扱われます。これは、値が
OR演算子によって結合されているかのように処理されることを意味します。例:State: {In Progress}, {To be discussed}は、これら 2 つの状態のどちらかに割り当てられている課題を返します。
明示的な演算子をクエリに適用することで、デフォルトのセマンティクスを上書きできます。
および
AND 演算子は、複数の検索属性の一致を組み合わせて、検索結果を絞り込みます。検索引数を AND 演算子と結合する場合、結果の課題には、指定されたすべての属性の一致が含まれている必要があります。この演算子は、enum[*] 型とタグを格納する課題フィールドに使用します。
AND 演算子で結合された検索引数は、常にグループとして処理され、クエリで OR 演算子で結合された他の引数よりも優先度が高くなります。
AND 演算子を含む検索クエリの例を次に示します。
次のビルドの両方としてタグ付けされ、テストされる Ktor プロジェクトの課題を見つけるには、次のように入力します。
in: Ktor and tag: {Next build} and tag: {to be tested}2 つのタグ間の
AND演算子は、結果に両方のタグを持つ課題のみが含まれるようにします。Ktor プロジェクトでクリティカル優先順位として設定されている、またはメジャー優先順位として設定され、Kotlin プロジェクトで割り当てられているすべての課題を検索するには、次のように入力します。
in: Ktor #Critical or in: Kotlin #Major and for: meこのクエリで演算子を削除した場合、プロジェクトへの参照と優先度は分離（
OR）ステートメントとして解析されます。次に、担当者（me）への参照が接続詞（AND）ステートメントと結合されます。Ktor プロジェクトで重大な課題に加えて、Kotlin で割り当てられている主要な優先順位の課題のリストを取得する代わりに、Ktor または Kotlin で重大または重大な課題のみを割り当てます。
または
OR オペレーターは、複数の検索属性の一致を組み合わせて、検索結果を広げます。
これは、代わりに課題で使用される可能性のある同義語を持つ用語を検索する場合に非常に便利です。例: lesson OR tutorial を検索すると、「レッスン」または「チュートリアル」のいずれかに一致するフォームを含む課題が返されます。クエリから OR 演算子を削除すると、検索は結合的に実行されます。つまり、結果には両方の単語に一致する形式を含む課題のみが含まれます。
OR 演算子を含む検索クエリの別の例を次に示します。
自分に割り当てられている、または任意のプロジェクトでテストするようにタグ付けされている Ktor プロジェクトのすべての課題を見つけるには、次のように入力します。
in: Ktor for: me or tag: {to be tested}
丸括弧
括弧を使用する ( と ) は、さまざまな検索引数を組み合わせて、属性と演算子が処理される順序を変更します。括弧内の検索クエリの部分が優先され、常に単一のユニットとして処理されます。
括弧の最も一般的な使用箇所は、OR 演算子で区切られた 2 つの検索引数を囲み、追加の検索引数を AND 演算子で結合することにより、検索結果をさらに制限することです。
検索クエリで括弧を使用する場合は常に、括弧内のステートメントを隣接する検索引数に結合するすべての演算子を提供する必要があります。例: 検索クエリ in: Kotlin #Critical (in: Ktor and for:me) は処理できません。代わりに in: Kotlin #Critical or (in: Ktor and for:me) と記述する必要があります。
括弧を使用する検索クエリの例を次に示します。
自分に割り当てられており、Kotlin プロジェクトでクリティカル優先順位が割り当てられているか、Ktor プロジェクトでメジャー優先順位が割り当てられているすべての課題を検索するには、次のように入力します。
(in: Kotlin #Critical or in: Ktor #Major) and for: me
シンボル
次のシンボルは、検索クエリを拡張または絞り込むために使用できます。
シンボル | 説明 | サンプル |
|---|---|---|
- | 一連の検索クエリ結果からサブセットを除外します。このシンボルを単一の値で使用するときは、番号シンボルを使用しないでください。 | 優先度の低い課題を除く未解決の課題をすべて検索し、結果のリストを優先度の高い順に並べ替えるには、 |
# | 入力が単一の値を表すことを示します。 | 現在のユーザーによって報告、割り当て、またはコメントされた MRK プロジェクト内の未解決の課題をすべて見つけるには、 |
, | 単一の属性の値のリストを区切ります。範囲と組み合わせて使用することができます。 | 現在または昨日作成された、現在のユーザーに割り当てられている、報告されている、コメントされているすべての課題を検索するには、 |
.. | 値の範囲を定義します。上限と下限の範囲を定義する値の間にこのシンボルを挿入します。検索結果には上限と下限が含まれます。 | バージョン 1.2.1 および 1.3 から 1.5 までのすべてのバージョンで修正されたすべての課題を見つけるには、 2018 年 3 月 10 日から 3 月 13 日の間に作成されたすべての課題を検索するには、 |
* | ワイルドカード文字その動作はコンテキスト依存です。
| 2018 年 3 月 10 日以前に作成されたすべての課題を検索するには、 PNG 形式のイメージ添付ファイルを含む未解決の課題を見つけるには、 |
? | 文字列内の任意の 1 文字と一致します。このワイルドカードを使用できるのは、テキストを保管する属性を検索するためだけです。詳しくは、テキスト検索のワイルドカードを参照してください。 | 課題の説明に「priorityitize」または「priorityitize」という単語が含まれている課題を検索するには、 |
{ } | スペースを含む属性値を囲みます。 | テストされるタグを 持つ Fixed 状態の課題をすべて見つけるには、 |
日付と期間の値
いくつかの検索属性は、日付として保管されている値を参照します。日付を単一の値として検索することも、値の範囲を使用して期間を定義することもできます。
日付を YYYY-MM-DD または YYYY-MM または MM-DD の形式で指定します。HH:MM:SS または HH:MM の 24 時間形式で時刻を指定することもできます。日付と時刻の両方を指定するには、YYYY-MM-DD}}T{{HH:MM:SS の形式を使用します。例: 検索クエリ created: 2010-01-01T12:00 .. 2010-01-01T15:00 は、2010 年 1 月 1 日の 12:00 および 15:00 の間に作成されたすべての課題を返します。
事前定義された相対日付パラメーター
また、事前定義された相対パラメーターを使用して日付値を検索することもできます。これらのパラメーターの値は、現在のユーザーのタイムゾーンに従って現在の日付を基準にして計算されます。各パラメーターの実際の値は、照会援助パネルに表示されています。
以下の相対日付パラメーターがサポートされています。
パラメーター | 説明 |
|---|---|
現在 | 現在の瞬間。 |
今日 | 現在の暦日 |
明日 | 次の暦日 |
昨日 | 前の暦日 |
日曜 | 今週のカレンダーの日曜日。 |
月曜 | 今週の月曜日のカレンダー。 |
火曜 | 今週の火曜日のカレンダー。 |
水曜 | 今週の水曜日のカレンダー。 |
木曜 | 今週の木曜日のカレンダー。 |
金曜 | 今週の金曜日のカレンダー。 |
土曜 | 今週の土曜日のカレンダー。 |
{Last working day} | YouTrack のタイムトラッキングページの設定で構成されている作業日によって定義された最新の就業日。 |
{This week} | 今週の月曜日の 00:00 から日曜日の 23:59 までの期間。 |
{Last week} | 前週の 00:00 月曜日から 23:59 日曜日までの期間。 |
{Next week} | 来週の月曜日の 00:00 から日曜日の 23:59 までの期間。 |
{Two weeks ago} | 現在の日付の 2 週間前のカレンダー週の 00:00 月曜日から 23:59 日曜日までの期間。 |
{Three weeks ago} | 現在の日付の 3 週間前の暦週の 00:00 月曜日から 23:59 日曜日までの期間。 |
{This month} | 現在の暦月の最初の日から最後の日までの期間。 |
{Last month} | 前の暦月の最初の日から最後の日までの期間。 |
{Next month} | 翌月の最初の日から最後の日までの期間。 |
順序 | 1970 年 1 月 1 日から現在の日付の 2 か月前の月末日までの期間。 |
カスタム日付パラメーター
事前定義された日付パラメーターが最も重要な課題を見つけるのに役立たない場合は、検索クエリで独自の日付範囲を定義してください。カスタム日付パラメーターを使用して記述できるクエリの例を次に示します。
過去 7 日間に新しいコメントが追加された課題を検索します。
commented: {minus 7d} .. Today過去 2 時間に更新された課題を検索します。
updated: {minus 2h} .. *少なくとも 1 年半前の未解決の課題を見つけます。
created: * .. {minus 1y 6M} #Unresolved5 日以内に期限が切れる課題を見つけます。
Due Date: {plus 5d}
検索クエリでカスタム時間枠を定義するには、次の構文を使用します。
過去の日付または時刻を指定するには、
minusを使用します。将来の日付または時刻を指定するには、
plusを使用します。時間枠を一連の整数とそれに続く時間の単位を表す文字として指定します。時間の各単位はスペース文字で区切ります。例:
2y 3M 1w 2d 12h
時間を指定するクエリは、指定された時間に発生したイベントをフィルタリングします。例: 現在 15:35 の場合、created: {minus 48h} として記述されたクエリは、2 日前の午後 3 時から 4 時の間に作成された課題を返します。一方、created: {minus 2d} として記述されたクエリは、2 日前の深夜から 23:59 までの任意の時点で作成されたすべての課題を返します。
このレベルの精度は、時間にのみ適用されます。時間の単位を 14d として参照するクエリは、2w とまったく同じ結果を返します。
1 時間より短い時間の単位（分、秒）を指定する検索クエリはサポートされていません。
検索クエリの文法
このページは、YouTrack 検索クエリ文法の BNF の説明を提供します。
文法は大文字と小文字を区別しません。
関連ページ：
シンプル検索
YouTrack では、課題の検索にシンプルと詳細検索の 2 つのオプションがサポートされています。シンプル検索では、自然言語を使用して関連する属性と値を提案するため、複雑な検索クエリを覚える必要がなく、検索結果をすばやく絞り込むことができます。シンプル検索は、直感的でガイド付きの方法で検索結果を絞り込みたいユーザー向けの代替手段です。簡易検索を有効にするには: メインナビゲーションメニューから、課題を選択します。検索ボックスの右側にある設定ボタンをクリックします。検索設定では、シンプルを選択しま...
拡張検索
YouTrack は、課題を検索するための 2 つのオプション（シンプルと詳細）をサポートしています。詳細検索では、属性と値のペアを使用して課題を検索する検索クエリを作成できます。すべての検索クエリが属性ベースである必要はありません。テキスト検索も実行できます。実際、両方の検索構文を含む検索条件を指定することも可能です。これらの検索構文をいつ、どのように使用するかを学ぶことで、探している課題を常に正確に見つけることができます。詳細検索を有効にするには: メインナビゲーションメニューから、課題を選択...
テキスト検索
YouTrack を使用すると、特定の単語やフレーズを含む課題を検索できます。すべての課題属性でテキストを検索するか、課題の概要、説明、コメント、作業項目でテキストを検索するように検索クエリを制限できます。また、コード行内の単語を検索するように検索を制限することもできます。詳細については、課題の属性を参照してください。YouTrack は、探しているものを見つけるのに役立ついくつかの戦略をサポートしています。標準テキスト検索：属性ベースの検索として解析されず、一重引用符で囲まれていない入力は、...
スプリントを使用する
In Scrum development, asprintis a set period of time during which a predetermined set of tasks must be completed and made ready for review.On anagile boardin YouTrack, a sprint is simply a set of active tasks represented as cards. Eachcardrepresents
サンプル検索クエリ
このページでは、さまざまな一般的なユースケースをカバーする検索クエリの例と説明を提供します。これらのサンプルをモデルとして使用し、状況に関連する課題を見つけるために適合させます。YouTrack には、シンプル検索と拡張検索の 2 つの検索モードがあります。シンプル検索では、ドロップダウンメニューから自然言語を使用して、関連する属性と値を提案します。詳細検索では、クエリ構文を使用して、正確かつ複雑なフィルタリングを行います。どちらの検索方法も、探している課題を見つけるのに役立ちますが、このページ...