YouTrack サーバー 2025.3 ヘルプ

検索クエリリファレンス

このページでは、YouTrack クエリ言語で使用されている属性とキーワードのリストを提供しています。検索クエリで認識される演算子、シンボル、相対日付パラメーターの完全なリストもあります。

このページのいくつかの参照はシンプル検索では利用できません。アクセスするには拡張検索に切り替えてください。

課題の属性

すべての号には YouTrack によって自動的に設定される基本属性があります。これらには、issue ID、最後の更新を issue に作成または適用したユーザなどが含まれます。

これらの検索属性は、検索クエリの文法内の <Attribute> を表します。それらの値は、<Value> または <ValueRange> パラメーターに対応しています。

属性ベースの検索は構文 attribute: value を使用します。

  • target 属性には、コンマで区切って複数の値を指定できます。

  • 構文 attribute: -value を使用して検索結果から特定の値を除外します。

多くの場合、# または - シンボルを使用して属性値および参照値を直接省略できます。追加のガイドラインについては、拡張検索を参照してください。

添付ファイルのテキスト

attachment text: <text>

指定されたテキストを含むイメージ添付ファイルを含む課題を返します。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

エイリアス

イメージテキスト

サンプル

テキスト design mockup を含むイメージを含むデザインプロジェクト内の課題を検索するには、project: Design attachment text: design mockup と入力します。

添付

attachments: <text>

指定されたファイル名の添付ファイルを含む issue を返します。

値

テキストを受け入れます。ファイル名にスペースが含まれる場合は、複数の単語を引用符または中括弧で囲みます。

サンプル

自分に割り当てられているスケッチで始まるファイル名の添付ファイルがある未解決の課題を見つけるには、#unresolved for: me attachments: sketch* と入力します。

ボード

Board <board name>: <sprint name>

指定されたアジャイルボード上の指定されたスプリントに割り当てられている課題を返します。スプリントが無効になっているアジャイルボードに割り当てられている課題を見つけるには、has: <board name> を使用します。

値

スプリントの名前を受け入れます。スプリント名を複数の単語で中括弧で囲みます。

スプリント名を {current sprint} に置き換えて、現在のスプリントに割り当てられている課題を見つけます。YouTrack が現在のスプリントを識別する方法については、現在のスプリントを参照してください。

この属性は、構文 #<sprint name> または -<sprint name> の単一の値としても参照できます。

サンプル

YouTrack スクラムボード上のスプリント 21 に割り当てられているすべての課題を見つけるには、Board YouTrack Scrum: {sprint 21} と入力します。

CC 受信者

cc recipients: <user>

指定されたユーザーが CC として追加されたチケットを返します。

値

ユーザーを受け入れます。

サンプル

ユーザー名 minnie.terry のエージェントが CC 受信者として追加されているすべてのチケットを検索するには、「 cc recipients: minnie.terry 」と入力します。

コード

code: <text>

課題の説明またはコメントでコードとしてフォーマットされている、指定された 1 つまたは複数の単語に一致する単語形式を含む課題を返します。これには、インラインコードスパン、インデントおよびフェンスで囲まれたコードブロック、スタックトレースとしてフォーマットされた一致が含まれます。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

サンプル

説明またはコメント内でコードとしてフォーマットされている、hello および world という単語を含む TS プロジェクト内の未解決の課題を見つけるには、in: TS #unresolved code: {hello world} と入力します。

コメント化

commented: <date> | <period>

指定日または指定期間内にコメントが追加された issue を返します。

値

日付、カスタム期間、相対日付パラメーターを受け入れます。

この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーおよびグループの提案を表示するには、commenter 属性を使用します。

サンプル

現在のユーザーに割り当てられていて先週コメントした YouTrack プロジェクト内のすべての課題を見つけるには、#YouTrack for: me commented: {Last Week} と入力します。

コメンター

commenter: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーによってコメントされた issue を返します。

値

ユーザーまたはグループを受け入れます。

エイリアス

コメントしました

サンプル

今日作成され、現在のユーザーに割り当てられ、ユーザー名がジョンのユーザーによってコメントされたすべての課題を検索するには、「 created: today for: me commenter: John 」と入力します。

コメント

comments: <text>

指定された単語またはコメント内の単語に一致する単語形式を含む issue を返します。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

サンプル

アジャイル管理サブシステム内のタイプ機能で、1 つ以上のコメントにバーンダウンという単語を含む JT プロジェクトの課題を見つけるには、in: JT #Feature Subsystem: {Agile management} comments: burndown と入力します。

作成しました

created: <date> | <period>

特定の日付または特定の期間内に作成された課題を返します。

値

日付、カスタム期間、相対日付パラメーターを受け入れます。この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーおよびグループの提案を表示するには、reporter 属性を使用します。

サンプル

今日作成され、現在のユーザーに割り当てられているすべての課題を見つけるには、#my #issues created: today または #my created: today と入力してください。

description

description: <text>

指摘の説明で指定された単語と一致する単語形式を含む課題を返します。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

サンプル

説明に文字列 groovy.lang.resolve.CollectClassMembersUtil を含む GR プロジェクトの未解決の課題を見つけるには、in: GR #unresolved description: "groovy.lang.resolve.CollectClassMembersUtil" と入力します。

ドキュメントタイプ

document type: Issue | Ticket

発行またはチケットタイプのドキュメントを返します。

値

キーワード Issue または Ticket を受け入れます。

サンプル

自分に課題が割り当てられていないすべてのチケットを検索するには、「 #{Assigned to me} document type: Ticket 」と入力します。

ガント

Gantt: <chart name>

指定されたガントチャートに割り当てられている課題を返します。

値

ガントチャートの名前を受け入れます。チャート名は複数の単語で囲みます。

サンプル

YouTrack への移行という名前のガントチャートに割り当てられているすべての課題を検索するには、Gantt: {Migrate to YouTrack} と入力します。

持っている

has: <attribute>

has キーワードは、ブール検索語として機能します。検索クエリで使用すると、指定した属性の値を含むすべての課題が返されます。指定された属性の前にマイナス演算子（-）を使用して、空の値を持つ issue を見つけます。

例: TST プロジェクトで、現在のユーザーに割り当てられ、重複リンクがあり、アタッチファイルがあるがコメントがないすべての課題を検索するには、in: TST for: me has: duplicates , attachments , -comments と入力します。

has キーワードを以下の属性と組み合わせて使用することができます。

属性

説明

添付

添付ファイルがある課題を返します。

ボード

少なくとも 1 つのアジャイルボードに割り当てられている課題を返します。除外演算子 (-) と一緒に使用すると、どのボードにも割り当てられていない課題が返されます。

ボード <ボード名>

指定されたアジャイルボードに割り当てられている課題を返します。

コメント

1 つ以上のコメントがある課題を返します。

description

空の説明がない課題を返します。

<フィールド名>

指定されたカスタムフィールドに任意の値を含む issue を返します。スペースを含むフィールド名は中括弧で囲みます。

ガント

ガントチャートに割り当てられている課題を返します。

<link type name>

指定された外側の名前または内側の名前と一致するリンクを持つ issue を返します。スペースを含むリンク名は中括弧で囲みます。

例: 親課題にサブタスクとしてリンクされている課題を検索するには、次を使用します。

has: {Subtask of}

親課題にリンクされていない課題を見つけるには、次を使用します。

has: -{Subtask of}

リンク

任意の issue リンクタイプを持つ issue を返します。

星

現在のユーザーのスタータグを持つ issue を返します。

過小評価

合計使用時間が元の見積もり値よりも大きい課題を返します。

VCS の変更

vcs の変更を含む課題を返します。

投票

1 つ以上の投票がある課題を返します。

work

1 つ以上の作業項目がある課題を返します。

課題 ID

issue ID: <issue ID>, #<issue ID>

指定された issue ID と一致する issue を返します。この属性は、構文 #<issue ID> または -<issue ID> を使用して単一の値として参照することもできます。検索で単一の号が返されると、その結果は単一号ビューに表示されます。

  • 属性ベースの検索（issue ID: <value> または #<value>）の構文を使用しない場合、入力もテキスト検索として解析されます。指定された課題 ID に一致する課題に加えて、検索結果には、テキスト属性に指定された ID を含む課題が含まれます。

  • issue ID を引用符で囲むと、入力はテキスト検索としてのみ解析されます。検索結果には、テキスト属性に指定された ID を含む issue のみが含まれます。

課題 ID がテキスト検索として解析された場合でも、結果には課題のリンクは含まれないことに注意してください。課題のリンクに基づいて課題を検索するには、links 属性を使用するか、特定のリンクタイプを参照します。

値

課題 ID のみを受け入れます。

サンプル

ID JT-4232 の課題を見つけるには、issue ID: JT-4232 または #JT-4232 と入力してください。

  • 検索を JT-4232 と入力した場合、結果には issue JT-4232 と、サマリー、説明、コメントのテキストにこの部分文字列を含むすべての issue が含まれます。

  • 検索を "JT-4232" と入力した場合、結果にはサマリー、説明、コメントのテキストにこの部分文字列を含む課題のみが含まれます。

links: <issue ID>

指定された課題へのリンクを含むすべての課題を返します。

値

課題 ID のみを受け入れます。

サンプル

issue ABC-4532 にリンクされている TEST プロジェクト内のすべての issue を見つけるには、in: TEST links: ABC-4532 と入力します。

類維

looks like: <issue ID>

指摘の概要または説明に、指定の指摘の指摘の要約または説明にある単語が含まれている指摘を返します。検索結果が関連性でソートされている場合、issue summary に一致する単語が含まれている issue にはより高い重みが付けられます。

値

課題 ID のみを受け入れます。

サンプル

ABC-4532 の課題の概要と説明で使用されている一致する単語を含む TEST プロジェクト内のすべての課題を検索するには、in: TEST looks like: ABC-4532 と入力します。

メンションされている

mentioned in: <issue id>

対象の課題の説明またはコメントで参照されている課題 ID を持つ課題を返します。補足テキストフィールドの課題 ID は検索結果に含まれません。

値

課題 ID のみを受け入れます。

サンプル

課題 JT-4232 の説明またはコメント内に記載されているすべての課題を検索するには、mentioned in: JT-4232 と入力します。

メンション

mentions: <issue id>, <user>

指定されたユーザーの @mention または説明やコメントで参照されている課題 ID のいずれかを含む課題を返します。補足テキストフィールド内のユーザーのメンションと課題 ID は検索結果に含まれません。

値

課題 ID またはユーザーを受け入れます。

サンプル

ユーザー名 valerie を持つユーザーにメンションしているが、アカウントを参照するメンションが含まれていないすべての課題を検索するには、mentions: valerie, -me と入力します。

説明またはコメントに課題 ID JT-4232 の課題が記載されているすべての課題を検索するには、「 mentions: JT-4232 」と入力します。

組織

organization: <organization name>

指定された組織に属する課題を返します。この属性は、単一の値として参照することもできます。

値

組織名を受け入れます。

サンプル

現在のユーザーに割り当てられているテストクラスター組織に属するすべての課題を検索するには、#my organization:{Test cluster} または #my #{Test cluster} と入力します。

プロジェクト

project: <project name> | <project ID>

指定したプロジェクトに属する課題を返します。この属性は単一の値として参照することもできます。

値

プロジェクト名またはプロジェクト ID を受け入れます。

エイリアス

内

サンプル

現在のユーザーに割り当てられている ReSharper プロジェクトに属するすべての課題を検索するには、#my #ReSharper #issues または #my #ReSharper と入力します。

報告者

reporter: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーによって作成された課題とチケット (指定されたユーザーの代わりに作成されたチケットを含む) を返します。現在のユーザーが作成した課題を返すには、me を使用します。

値

ユーザーまたはグループを受け入れます。

エイリアス

by, created by, reported by

サンプル

マイナーまたは通常の優先度を持つものを除いて、ユーザー名 yarko でユーザーによって報告されたすべてのバグを見つけるには、#bug reporter: yarko -minor -normal または #bug by: yarko -minor -normal と入力します。

解決日時

resolved date: <date> | <period>

特定の日付または特定の期間内に解決された課題を返します。

値

日付、カスタム期間、相対日付パラメーターを受け入れます。

サンプル

今月の MPS プロジェクトで解決された課題をすべて見つけるには、#MPS resolved date: {this month} と入力してください。

saved search: <saved search name>

保存した検索の検索条件と一致する課題を返します。この属性は、構文 #<saved search name> または -<saved search name> を使用して単一の値として参照することもできます。

値

保存された検索の名前を受け入れます。

サンプル

今週リシャーパーとして保存された検索クエリと一致する課題を見つけるには、saved search: {resharper this week} と入力します。

提出者

submitter: <user> | <group>

指定されたユーザー、または別のユーザーに代わって指定されたグループのメンバーによって送信された課題を返します。現在のユーザーによって送信された課題を返すには、me を使用します。

値

ユーザーまたはグループを受け入れます。

エイリアス

から提出された

サンプル

他のユーザーに代わってユーザー名 minnie.terry のエージェントによって送信されたすべてのチケットを検索するには、submitter: minnie.terry または submitted by: minnie.terry と入力します。

概要

summary: <text>

指摘サマリー内の指定された単語に一致する単語形式を含む課題を返します。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

サンプル

要約でスクラムまたはボードの課題を見つけるには、summary: {scrum board} と入力します。

要約にアジャイル管理という単語が含まれるユーザー john.johnson に割り当てられている TS プロジェクトの課題を見つけるには（この順序で表示されます）、in: TS assigned to: john.johnson summary: "Agile management" と入力します。

タグ

tag: <tag name>

指定したタグに一致する課題を返します。この属性は、構文 #<tag name> または -<tag name> を使用して単一の値として参照することもできます。

値

タグの名前を受け入れます。

エイリアス

としてタグ付け

サンプル

優先順位がマイナーで、myparser タグを持つすべての課題を見つけるには、#minor tag: myparser または #minor #issues tagged as: myparser と入力してください。

更新日

updated: <date> | <period>

最新の変更が特定の日付または指定された時間枠内に発生した課題を返します。

値

日付、カスタム期間、相対日付パラメーターを受け入れます。

この属性はユーザーまたはグループも受け入れますが、フィルターされていない自動補完オプションのリストには日付関連の値が最初に表示されます。ユーザーとグループの提案を表示するには、updater 属性を使用します。

サンプル

今月最新の変更が適用された MPS プロジェクトで解決されたすべての課題を見つけるには、#MPS updated: {this month} #resolved と入力します。

アップデータ

updater: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーによって最後に更新された課題を返します。最後の更新を適用した課題を返すには、me を使用してください。

値

ユーザーまたはグループを受け入れます。

エイリアス

更新ユーザー：

サンプル

昨日最後に更新した最後の人物であるすべての主要な課題を見つけるには、updater: me updated: yesterday priority: major または updater: me #yesterday #major と入力してください。

VCS の変更

vcs changes: <commit hash>

指定された SHA-1 コミットハッシュによって識別されるコミットオブジェクトに適用された vcs の変更を含む issue を返します。

値

完全な SHA-1 コミットハッシュを受け入れます。コミットハッシュの短縮形は認識されません。

サンプル

特定のコミットに対する vcs の変更を含む課題を見つけるには、vcs changes: f9b78079c40660c81f5df421b8ce7fc27497c4c2 と入力してください。

表示対象

visible to: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーに見える課題を返します。

値

ユーザーまたはグループを受け入れます。

キーワード {issue readers} を使用することもできます。

サンプル

可視性が YouTrack チームのメンバーに制限されているすべての主要な課題を見つけるには、priority: major visible to: {YouTrack Team} と入力してください。

表示がユーザーとグループのセットに制限されている課題を見つけるには、visible to: -{issue readers} と入力します。

投票者

voter: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーからの投票がある issue を返します。

値

ユーザーまたはグループを受け入れます。

エイリアス

投票した

サンプル

YouTrack チームのメンバーから投票したすべての主要課題を見つけるには priority: major voter: {YouTrack Team} と入力してください。

カスタムフィールド

カスタムフィールドで特定の値が割り当てられている課題を見つけることができます。他の課題属性と同様に、構文 attribute: value または attribute: -value を使用します。この場合、属性はカスタムフィールドの名前です。ほとんどの場合、# または - シンボルを使用して値を直接参照できます。

空の値が割り当てられているカスタムフィールドの場合、このプロパティを値として参照できます。例: 特定のユーザーに割り当てられていない課題を検索するには、Assignee: Unassigned または #Unassigned と入力します。フィールドに空の値が割り当てられていない場合は、構文 <field name>: {No <field name>} または has: -<field name> を使用してフィールドに値を格納しない課題を見つけます。

このセクションでは、デフォルトのカスタムフィールドの検索属性を一覧表示します。デフォルトのフィールドとその値はカスタマイズ可能です。実際のフィールド名、値、エイリアスは異なる場合があります。

影響を受けるバージョン

Affected versions: <value>

製品の特定のバージョンで検出された課題を返します。

値

影響を受けるバージョンフィールドに格納されている値、およびキーワード Released と Archived のいずれかを受け入れます。

エイリアス

影響する、影響する、影響する

サンプル

製品のバージョン EAP3 で検出された、ユーザージョンに割り当てられているすべての課題を見つけるには、Affected versions: EAP3 assigned to: John、#issues affecting: EAP3 assigned to: John、#issues that affect: EAP3 assigned to: John と入力してください。

担当者

Assignee: <user> | <group>

指定されたユーザーまたは指定されたグループのメンバーに割り当てられているすべての課題を返します。

値

ユーザーまたはグループを受け入れます。

エイリアス

assigned to, for

サンプル

ユーザー名ジョンのユーザーに割り当てられている優先度ショーストッパーのすべての課題を検索するには、Priority: Show-stopper Assignee: John または #Show-stopper for: John と入力します。

修正バージョン

Fix versions: <value>

製品の特定のバージョンで修正された課題を返します。

値

修正バージョンフィールドに格納されている値、およびキーワード Released と Archived のいずれかを受け入れます。

エイリアス

修正、修正、バージョン

サンプル

製品のバージョン EAP3 で修正された、ユーザージョンに割り当てられているすべての課題を見つけるには、for: John fixed in: EAP3 と入力してください。

ビルドで修正

Fixed in build: <value>

指定されたビルドで修正された課題を返します。

値

ビルドで修正フィールドとキーワード Archived に格納されている値を受け入れます。

エイリアス

ビルド、修正ビルド、修正、修正

サンプル

ビルド番号 36724 で修正された、ユーザージョンに割り当てられているすべての課題を見つけるには、for: John Fixed in build: 36724 または for: John fixed in: 36724 と入力してください。

優先度

Priority: <value>

指定した優先度と一致する課題を返します。

値

優先度フィールドとキーワード Archived に格納されている値を受け入れます。

サンプル

現在のユーザーに割り当てられている優先順位ショーストッパーの未解決の課題をすべて見つけるには、#my #unresolved #show-stoppers または #my state: unresolved priority: show-stopper と入力します。

状態

State: <value> | Resolved | Unresolved

指定された状態に一致する課題を返します。

解決済みおよび未解決の状態は、状態フィールドに格納されている特定の値のプロパティであるため、課題に直接割り当てることはできません。

デフォルトでは、Fixed、修正しない、複製、未完了、廃止、再現できないの状態は Resolved に設定されています。

送信済み、オープン、進行中、再開済み、話し合いますの状態は、未解決として設定されます。

値

状態フィールドに格納されているすべての値とキーワード Resolved、Unresolved、Archived を受け入れます。

サンプル

状態修正しないで閉じられた、ユーザー名 john のユーザーに割り当てられているすべての重大なバグを見つけるには、#{won't fix} #critical #bug for: john または state: {won't fix} priority: critical #bug for: john と入力します。

サブシステム

Subsystem: <value>

プロジェクト内の特定のサブシステムに割り当てられている課題を返します。

値

サブシステムフィールドとキーワード Archived に格納されている値を受け入れます。

エイリアス

内

サンプル

スマート UI サブシステムに属するすべての課題を見つけるには、subsystem: {smart ui} と入力してください。

タイプ

Type: <value>

指定された課題タイプに一致する課題を返します。

値

タイプフィールドとキーワード Archived に格納されている値を受け入れます。

サンプル

例外タイプが割り当てられ、現在のユーザーに割り当てられているすべての課題を検索するには、#exception assigned to: me と入力します。

他の課題に接続しているリンクに基づいて課題を検索できます。特定の課題リンクタイプを参照する検索クエリは、2 つの異なる方法で解釈できます。

  • <link type>: <issue ID> として指定された場合、クエリは、このリンクタイプを使用して指定された課題にリンクされた課題を返します。

  • <link type>: (<sub-query>) を使用すると、クエリは、このリンクタイプを使用して、指定されたサブクエリに一致する課題にリンクされた課題を返します。

リンクされた課題を検索する場合、任意の課題リンクタイプの外向きの名前または内向きの名前を入力してから、検索条件を指定できます。

このリストには、YouTrack でデフォルトで提供される課題リンク・型の検索パラメーターが含まれています。デフォルトの課題リンク型はカスタマイズできます。つまり、実際の名前は異なる場合があります。この構文を使用して、カスタムリンク型を参照する検索クエリを作成することもできます。

links: <issue ID>

ターゲットの課題にリンクされている課題を返します。

値

課題 ID のみを受け入れます。

サンプル

ID JT-5072 の課題にリンクされているすべてのタスクを検索するには、links: JT-5072 と入力します。

集計

aggregate <aggregation link type>: <issue ID>

ターゲットの課題に間接的にリンクされている課題を返します。この検索用語を使用して、たとえば、親の課題の親の課題である課題、ターゲットの課題のサブタスクでもある課題のサブタスクを検索します。結果には、直接または間接を問わず、指定されたリンクタイプを使用してターゲットの課題にリンクされている課題が含まれます。

この検索引数は、集約リンク型とのみ互換性があります。

値

課題 ID のみを受け入れます。

サンプル

ID JT-5072 の課題のサブタスクでもある課題にサブタスクとしてリンクされているすべてのタスクを検索するには、aggregate Subtask of: JT-5072 と入力します。

依存先

Depends on: <issue ID> | (<sub-query>)

ターゲットの課題へのリンクに依存する課題、または指定されたサブクエリに一致する課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

課題 JT-5072 に依存する、自分に割り当てられているすべてのタスクを検索するには、for: me #task Depends on: JT-5072 と入力します。

未解決の課題に依存する自分に割り当てられたタスクを見つけるには、for: me #task Depends on: (#Unresolved) と入力します。

重複

Duplicates: <issue ID> | (<sub-query>)

ターゲットの課題または指定されたサブクエリに一致する課題へのリンクが重複している課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

issue JT-5072 と重複する issue を見つけるには、Duplicates: JT-5072 と入力してください。

未解決の課題と重複する課題を見つけるには、Duplicates: (#Unresolved) と入力します。

Is duplicated by

Is duplicated by: <issue ID> | (<sub-query>)

ターゲットの課題または指定されたサブクエリに一致する課題へのリンクによって重複している課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

issue JT-5072 と重複している issue を見つけるには、Is duplicated by: JT-5072 と入力してください。

現在進行中の課題によって重複している課題を見つけるには、Is duplicated by: (State: {In Progress}) と入力します。

Is required for

Is required for: <issue ID> | (<sub-query>)

ターゲットの課題または指定されたサブクエリに一致する課題へのリンクに必要な課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

自分に割り当てられ、課題 JT-5072 に必要な課題を見つけるには、for: me Is required for: JT-5072 と入力します。

自分に割り当てられている、その他の未解決の課題に必要なすべての課題を見つけるには、for: me Is required for: (#Unresolved) と入力します。

親

Parent for: <issue ID> | (<sub-query>)

ターゲットの課題または指定されたサブクエリに一致する課題へのリンクの親を持つ課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

JT-5072 の親タスクを見つけるには、Parent for: JT-5072 と入力してください。

未解決のサブタスクがある解決済みの課題を見つけるには、#Resolved Parent for: (#Unresolved) と入力します。

Relates to

Relates to: <issue ID> | (<sub-query>)

ターゲットの課題へのリンクに関連する課題、または指定されたサブクエリに一致する課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

自分に割り当てられ、ID JT-5072 の課題に関連する課題を見つけるには、for: me Relates to: JT-5072 と入力します。

その他の未解決の課題に関連する課題を見つけるには、for: me Relates to: (#Unresolved) と入力します。

以下のサブタスク：

Subtask of: <issue ID> | (<sub-query>)

ターゲットの課題へのリンクのサブタスクを持つ課題、または指定されたサブクエリに一致する課題を返します。

値

課題 ID またはサブクエリを受け入れます。

サンプル

自分に割り当てられ、サブタスクとして JT-5072 にリンクされている課題を見つけるには、for: me Subtask of: JT-5072 と入力します。

親の課題の製品フィールドの値が YouTrack である未解決の課題を見つけるには、#Unresolved Subtask of: (Product: YouTrack) と入力します。

タイムトラッキングデータを含む課題を見つけるために使用できる検索属性の専用セットがあります。これらの属性は、課題に作業項目として追加された特定の値を探します。

work

work: <text>

作業項目で指定された単語または句に一致する単語形式を含む課題を返します。

値

テキストを受け入れます。値はテキスト検索の説明に従って解析されます。

サンプル

任意の形式の単語「test」を含む作業項目に関する課題を検索するには、「 work: test 」と入力します。

作業の作者

work author: <user>

指定されたユーザーによって追加された作業項目を持つ課題を返します。

値

ユーザーのみを受け入れます。

サンプル

現在のユーザーによって追加された作業項目を含む 'TST' プロジェクト内のすべての課題を見つけるには、次のように入力します。in: TST work author: me

作業タイプ

work type: <value>

指定された作業タイプが割り当てられている作業項目がある課題を返します。クエリ work type: {No type} は、作業項目タイプが割り当てられていない作業項目を持つ課題を返します。

値

定義済みの作業項目の種類を受け入れます。

サンプル

Development 作業項目タイプが割り当てられている作業項目がある 'TST' プロジェクト内のすべての課題を見つけるには、次のように入力します。in: TST work type: Development

就業日

work date: <date> | <period>

指定された日付または指定された時間枠内に記録された作業項目を含む issue を返します。

値

日付、カスタム期間、相対日付パラメーターを受け入れます。

サンプル

先週追加された作業項目を含む 'TST' プロジェクト内のすべての課題を見つけるには、次のように入力します。in: TST work date: {Last week}

カスタム作業項目の属性

work <attribute name>: <attribute value>

特定の作業項目属性に指定された値が割り当てられている作業項目がある課題を返します。

値

属性名と値のペアを受け入れます。

サンプル

経費属性に請求不可の値が割り当てられている「TST」プロジェクト内のすべての課題を検索するには、次のように入力します。in: TST work Expenses: Non-billable

属性のソート

検索クエリによって返される課題の一覧の並べ替え順序を指定できます。

次の一覧にある属性のいずれかで課題を並べ替えることができます。検索クエリの文法では、これらの属性は <SortAttribute> 値を表します。

並べ替え

sort by: <value> <sort order>

クエリによって返された課題を指定された順序で並べ替えます。

値

次の属性の値で課題を並べ替えることができます: スター、更新済み、アップデーター、作成済み、{ 解決日 }、プロジェクト、報告者、{ 課題 ID}、投票、概要、コメント、<カスタム field>、および { アタッチファイルサイズ }。

ソート順

asc、desc

エイリアス

並び順

サンプル

現在のユーザに割り当てられている、または報告されている修正済み状態の課題をすべて検索し、最新の課題を最初に表示して、最後の更新の日付で降順にソートするには、#my #fixed sort by: updated 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

シンボル

次のシンボルは、検索クエリを拡張または絞り込むために使用できます。

シンボル

説明

サンプル

-

一連の検索クエリ結果からサブセットを除外します。このシンボルを単一の値で使用するときは、番号シンボルを使用しないでください。

優先度の低い課題を除く未解決の課題をすべて検索し、結果のリストを優先度の高い順に並べ替えるには、#unresolved -minor sort by: priority asc と入力します。

#

入力が単一の値を表すことを示します。

現在のユーザーによって報告、割り当て、またはコメントされた MRK プロジェクト内の未解決の課題をすべて見つけるには、#my #unresolved in: MRK と入力します。

,

単一の属性の値のリストを区切ります。範囲と組み合わせて使用することができます。

現在または昨日作成された、現在のユーザーに割り当てられている、報告されている、コメントされているすべての課題を検索するには、#my created: Today, Yesterday と入力します。

..

値の範囲を定義します。上限と下限の範囲を定義する値の間にこのシンボルを挿入します。検索結果には上限と下限が含まれます。

バージョン 1.2.1 および 1.3 から 1.5 までのすべてのバージョンで修正されたすべての課題を見つけるには、fixed in: 1.2.1, 1.3 .. 1.5 と入力します。

2018 年 3 月 10 日から 3 月 13 日の間に作成されたすべての課題を検索するには、created: 2018-03-10 .. 2018-03-13 と入力します。

*

ワイルドカード文字その動作はコンテキスト依存です。

  • .. シンボルと一緒に使用すると、範囲検索の上限または下限を決定する値に置き換えられます。検索結果は指定された範囲を含みます。

  • 属性ベースの検索で使用された場合、属性値の最後にある 0 個以上の文字に一致します。詳しくは、属性ベースの検索のワイルドカードを参照してください。

  • テキスト検索で使用すると、文字列内のゼロ個以上の文字と一致します。詳しくは、テキスト検索のワイルドカードを参照してください。

2018 年 3 月 10 日以前に作成されたすべての課題を検索するには、created: * .. 2018-03-10 と入力します

refactoring で始まるタグを持つ課題を検索するには、tag: refactoring* と入力します。

PNG 形式のイメージ添付ファイルを含む未解決の課題を見つけるには、#Unresolved attachments: *.png と入力します。

?

文字列内の任意の 1 文字と一致します。このワイルドカードを使用できるのは、テキストを保管する属性を検索するためだけです。詳しくは、テキスト検索のワイルドカードを参照してください。

課題の説明に「priorityitize」または「priorityitize」という単語が含まれている課題を検索するには、description: prioriti?e と入力します。

{ }

スペースを含む属性値を囲みます。

テストされるタグを 持つ Fixed 状態の課題をすべて見つけるには、#Fixed tag: {to be tested} と入力します。

日付と期間の値

いくつかの検索属性は、日付として保管されている値を参照します。日付を単一の値として検索することも、値の範囲を使用して期間を定義することもできます。

日付を 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 の間に作成されたすべての課題を返します。

事前定義された相対日付パラメーター

また、事前定義された相対パラメーターを使用して日付値を検索することもできます。これらのパラメーターの値は、現在のユーザーのタイムゾーンに従って現在の日付を基準にして計算されます。各パラメーターの実際の値は、照会援助パネルに表示されています。

Relative date values

以下の相対日付パラメーターがサポートされています。

パラメーター

説明

現在

現在の瞬間。

今日

現在の暦日

明日

次の暦日

昨日

前の暦日

日曜

今週のカレンダーの日曜日。

月曜

今週の月曜日のカレンダー。

火曜

今週の火曜日のカレンダー。

水曜

今週の水曜日のカレンダー。

木曜

今週の木曜日のカレンダー。

金曜

今週の金曜日のカレンダー。

土曜

今週の土曜日のカレンダー。

{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} #Unresolved

  • 5 日以内に期限が切れる課題を見つけます。

    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 の説明を提供します。

<SearchRequest> ::= <OrExpression> <OrExpession> ::= <AndExpression> ('or' <AndExpression>)* <AndExpression> ::= <AndOperand> ('and' <AndOperand>)* <AndOperand> ::= '('<OrExpression>? ')' | Term <Term> ::= <TermItem>* <TermItem> ::= <QuotedText> | <NegativeText> | <PositiveSingleValue> | <NegativeSingleValue> | <Sort> | <Has> | <CategorizedFilter> | <Text> <CategorizedFilter> ::= <Attribute> ':' <AttributeFilter> (',' <AttributeFilter>)* <Attribute> ::= <name of issue field> <AttributeFilter> ::= ('-'? <Value> ) | ('-'? <ValueRange>) | <LinkedIssuesQuery> <LinkedIssuesQuery> ::= ( <OrExpression> ) <ValueRange> ::= <Value> '..' <Value> <PositiveSingleValue> ::= '#'<SingleValue> <NegativeSingleValue> ::= '-'<SingleValue> <SingleValue> ::= <Value> <Sort> ::= 'sort by:' <SortField> (',' <SortField>)* <SortField> ::= <SortAttribute> ('asc' | 'desc')? <Has> ::= 'has:' <Attribute> (',' <Attribute>)* <QuotedText> ::= '"' <text without quotes> '"' <NegativeText> ::= '-' <QuotedText> <Text> ::= <text without parentheses> <Value> ::= <ComplexValue> | <SimpleValue> <SimpleValue> ::= <value without spaces> <ComplexValue> ::= '{' <value (can have spaces)> '}'

文法は大文字と小文字を区別しません。

  • 検索属性の完全なリストについては、課題の属性を参照してください。

  • 一般的なユースケースのサンプルクエリを確認するには、サンプル検索クエリを参照してください。

2025 年 11 月 11 日
テキスト検索 サンプル検索クエリ

関連ページ：

シンプル検索

YouTrack では、課題の検索にシンプルと詳細検索の 2 つのオプションがサポートされています。シンプル検索では、自然言語を使用して関連する属性と値を提案するため、複雑な検索クエリを覚える必要がなく、検索結果をすばやく絞り込むことができます。シンプル検索は、直感的でガイド付きの方法で検索結果を絞り込みたいユーザー向けの代替手段です。簡易検索を有効にするには: メインナビゲーションメニューから、課題を選択します。検索ボックスの右側にある設定ボタンをクリックします。検索設定では、シンプルを選択しま...

拡張検索

YouTrack は、課題を検索するための 2 つのオプション（シンプルと詳細）をサポートしています。詳細検索では、属性と値のペアを使用して課題を検索する検索クエリを作成できます。すべての検索クエリが属性ベースである必要はありません。テキスト検索も実行できます。実際、両方の検索構文を含む検索条件を指定することも可能です。これらの検索構文をいつ、どのように使用するかを学ぶことで、探している課題を常に正確に見つけることができます。詳細検索を有効にするには: メインナビゲーションメニューから、課題を選択...

テキスト検索

YouTrack を使用すると、特定の単語やフレーズを含む課題を検索できます。すべての課題属性でテキストを検索するか、課題の概要、説明、コメント、作業項目でテキストを検索するように検索クエリを制限できます。また、コード行内の単語を検索するように検索を制限することもできます。詳細については、課題の属性を参照してください。YouTrack は、探しているものを見つけるのに役立ついくつかの戦略をサポートしています。標準テキスト検索：属性ベースの検索として解析されず、一重引用符で囲まれていない入力は、...

スプリントを使用する

スクラム開発では、スプリントとは、あらかじめ決められた一連のタスクを完了してレビューの準備をしなければならない一定の期間です。YouTrack のアジャイルボードでは、スプリントはカードとして表されるアクティブなタスクのセットにすぎません。各カードは、スプリントの終了前に解決すべき課題を表しています。スプリントを作成してスケジュールしてスクラム開発方法論に従うことも、スケジュールされていないスプリントを使用して独自のアジャイル実践に従うこともできます。YouTrack のアジャイルボードは、スク...

サンプル検索クエリ

このページでは、さまざまな一般的なユースケースをカバーする検索クエリの例と説明を提供します。これらのサンプルをモデルとして使用し、状況に関連する課題を見つけるために適合させます。YouTrack には、シンプル検索と拡張検索の 2 つの検索モードがあります。シンプル検索では、ドロップダウンメニューから自然言語を使用して、関連する属性と値を提案します。詳細検索では、クエリ構文を使用して、正確かつ複雑なフィルタリングを行います。どちらの検索方法も、探している課題を見つけるのに役立ちますが、このページ...