Azure Boards でフィールド、演算子、およびマクロのクエリを実行する

説明

True と False の値を受け取るフィールドを指定します。

@Today や @Today-1 などの変数、01/01/2025 などの値を指定できる日付フィールド。 個人プロファイルで設定した日付パターンで日付を入力します。 (詳細については、「個人用の設定」をご覧ください。)その他のクエリ例については、Query by date or @CurrentIteration に関する記事を参照してください。

WIQL クエリの場合は、協定世界時 (UTC) のパターンで日付を指定することもできます。 詳細については、「作業項目クエリ言語 (WIQL) の構文」を参照してください。

0.2、3.5 などの実数。 クエリの例については、数値フィールドによるクエリに関する記事をご覧ください。

一意の ID を表す文字列。

履歴情報を追跡するために使用されるカスタム書式のフィールド。 このデータ型は、[履歴] フィールドをサポートするためにのみ使われます。 フルテキスト検索が利用可能な場合は、このフィールドに対してフルテキスト検索用のインデックスが自動的に作成されます。 この記事で後に出てくる「フルテキスト検索と単語の一部の検索」をご覧ください。 クエリの例については、履歴と監査に関する記事をご覧ください。

[説明] または [再現ステップ] フィールドなどの書式設定された説明をサポートするテキスト文字列。 フルテキスト検索が利用可能な場合は、これらのフィールドに対してフルテキスト検索用のインデックスが自動的に作成されます。 この記事で後に出てくる「フルテキスト検索と単語の一部の検索」をご覧ください。 リッチ テキスト フィールドのクエリについては、タイトル、ID、リッチ テキスト フィールドによるクエリに関する記事をご覧ください。

ユーザー ID を示す短いテキスト文字列。

0、1、2、34 などの符号付き 32 ビット整数。

[アプリケーション開始情報] フィールドなどの長い説明をサポートするテキスト文字列。 フルテキスト検索が利用可能な場合は、これらのフィールドに対してフルテキスト検索用のインデックスが自動的に作成されます。 この記事で後に出てくる「フルテキスト検索と単語の一部の検索」をご覧ください。 プレーンテキスト フィールドのクエリについては、タイトル、ID、リッチ テキスト フィールドによるクエリに関する記事をご覧ください。

Decimal 値の候補リストを格納するように定義されたカスタム フィールド。

Integer 値の候補リストを格納するように定義されたカスタム フィールド。

短いテキスト文字列 (255 文字以下) の値の候補リストを格納するように定義されたカスタム フィールド。

最大 255 文字の Unicode 文字を含む短いテキスト文字列。 String テキスト フィールドは、候補リストまたはドロップダウン メニューをサポートするためによく使われます。

区分パスやイテレーション パスなどの分岐ツリー構造。 有効な値の一覧から項目を選びます。 ツリー構造と等しい、ツリー構造と等しくない、ツリー構造以下にある、またはツリー構造以下にない作業項目を検索します。 In 演算子または Not In 演算子を使用して複数の値を指定することもできます。 プロジェクトのツリー構造 (区分パスとイテレーション パス) を定義し、チームに関連付けるものを選択します。

クエリの作成について詳しくは、「区分またはイテレーション パスによるクエリの実行」または「日付または現在のイテレーションによるクエリの実行」をご覧ください。

作業項目の値が抽出条件と一致した場合に作業項目が返される

適用可能なデータの種類

句内の値と一致する。

Number (Double、GUID、Integer を含む)、String、DateTime、TreePath

句内の値と一致しない。

Number、String、DateTime、TreePath

句内の値より大きい。

Number、String、DateTime

句内の値より小さい。

Number、String、DateTime

句内の値より大きいか等しい。

Number、String、DateTime

句内の値より小さいか等しい。

Number、String、DateTime

指定したフィールドに含まれる値と一致する。

指定されたフィールドと同じデータ型のフィールドの名前
Boolean 型フィールドが別のフィールドと等しいかどうかを確認します

指定したフィールドに含まれる値と一致しない。

指定されたフィールドと同じデータ型のフィールドの名前
Boolean 型フィールドが別のフィールドと等くないかどうかを確認します

指定したフィールドに含まれる値より大きい。

指定されたフィールドと同じデータ型のフィールドの名前

指定したフィールドに含まれる値より小さい。

指定されたフィールドと同じデータ型のフィールドの名前

指定したフィールドに含まれる値より大きいか等しい。

指定されたフィールドと同じデータ型のフィールドの名前

指定したフィールドに含まれる値より小さいか等しい。

指定されたフィールドと同じデータ型のフィールドの名前

フィルター処理の対象として選択したフィールドが、テキスト文字列に完全または部分的に一致する。

String

フィルター処理の対象として選択したフィールドが、テキスト文字列に完全にも部分的にも一致しない。

String

フィルター処理の対象として選択したフィールドに、テキスト文字列または単語の完全一致が含まれる。 ワイルドカード文字 "*" を使用して、単語や語句の一部を入力することもできます。 テキスト文字列は、100 文字までに制限されています。 制限については、フルテキスト検索でのサーバーと照合順序の要件に関する説明を参照してください。

フルテキスト検索用のインデックスが作成されている長いテキスト フィールド。すべての PlainText と HTML フィールド、および History と Title フィールドに対応します。

フィルター処理の対象として選択したフィールドに、テキスト文字列または単語の完全一致が含まれない。 テキスト文字列は、100 文字までに制限されています。

この演算子を Contains Words 演算子を含む句と組み合わせて使用し、特定のキーワードを含めたり除外したりします。

フルテキスト検索用のインデックスが作成されるテキスト フィールド。

区切られた値と一致する。 たとえば、ID が 100、101 および 102 の作業項目は、[ID] フィールドにこれらの値を指定すると検索できます。 値は、クライアント コンピューターに定義されている地域設定に対応するリスト区切り記号で区切ります。 たとえば、コンマ , を使用できます。

Number、String、DateTime、TreePath

空の HTML フィールドを含む作業項目の一覧を取得する。 この演算子では値を指定しません。 この演算子は、Azure Boards および Azure DevOps Server でサポートされています。

HTML

HTML フィールドに何らかの内容が含まれる作業項目の一覧を取得する。 この演算子では値を指定しません。 この演算子は、Azure Boards および Azure DevOps Server でサポートされています。

HTML

区切られたセットのどの値とも一致しない。 状態が解決済み、完了、またはクローズでない作業項目をクエリ結果から除外するには、これらの値を状態フィールドに指定します。 値は、クライアント コンピューターに定義されている地域設定に対応するリスト区切り記号で区切ります。 たとえば、コンマ , を使用できます。

Not In 演算子は、Azure Boards および Azure DevOps Server でサポートされています。

Number、String、DateTime、TreePath

句内のグループのメンバーである値と一致する。 グループは、チーム、セキュリティ グループ、または作業追跡カテゴリの名前に対応します。 たとえば、貢献者グループのメンバーまたはチームに割り当てられているすべての作業項目を検索するクエリを作成できます。 チーム グループは、チームを作成したときに作成されます。 チーム グループの名前は、<チーム プロジェクト名>\<チーム名> というパターンです。

クエリの例については、割り当てまたはワークフローの変更によるクエリの実行に関する記事をご覧ください。

システムで定義されているチーム、セキュリティ グループ、またはカテゴリの名前と一致する String。

詳細については、カテゴリを使用して作業項目の種類をグループ化する方法に関する記事を参照してください。

句内のグループのメンバーである値と一致しない。

Azure DevOps Server 内のユーザー グループまたはプロジェクトに定義されたカテゴリ グループの名前に一致する String。

句内の値と一致せず、かつ句内のノードの下に含まれない。

TreePath

句内の値と一致するか、または句内のノードの下に含まれる。

TreePath

句内の値が前のいずれかと一致する。

String、DateTime

説明

[作業項目の種類] または [状態] フィールドで使って、すべての作業項目の種類またはすべての状態を検索します。 たとえば、Work Item Type=[Any] では、作業項目タイプに基づくフィルターは一切適用されません。

[イテレーション パス] フィールドで使い、現在のチームのフォーカスまたはコンテキストに基づいて、現在のスプリントに割り当てられている作業項目で自動的にフィルター処理します。 具体的な例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。
@CurrentIteration マクロは、Web ポータルから実行する場合にのみ機能します。 テスト スイートとテスト ケースをコピーまたは複製するとき、アラートを定義するとき、または REST API では、このマクロを使用できません。

[イテレーション パス] フィールドで使い、現在のチームのフォーカスまたはコンテキストに基づいて、現在のスプリント +/- n スプリントに割り当てられている作業項目のセットをフィルター処理します。 具体的な例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。
@CurrentIteration +/- n マクロは、Web ポータルから実行する場合、Azure Boards および Azure DevOps Server でサポートされます。

[ID] フィールドで In 演算子と共に使って、プロジェクトでフォローしているすべての作業項目の一覧を表示します。 詳細については、作業項目または pull request のフォローに関する記事を参照してください。 この同じ一覧は、[作業項目] ページの [フォロー] ピボット ビューから見ることができます。
@Follows マクロは、Web ポータルから実行する場合にのみサポートされます。

ID またはユーザー アカウントのフィールドで使って、自分のユーザー名またはアカウント名に関連付けられている項目を自動的に検索します。 たとえば、Created By=@Me 句を使うと、自分で開いた作業項目を見つけることができます。 その他の例については、割り当て、ワークフロー、またはボードの変更によるクエリに関する記事を参照してください。

ID フィールドと In 演算子を使用して、過去 30 日以内にプロジェクトで表示または更新した作業項目を一覧表示します。 この同じ一覧は、[作業項目] ページの [マイ アクティビティ] ピボット ビューから見ることができます。

[チーム プロジェクト] フィールドで使って、他のプロジェクトの作業項目についてフィルター処理します。 たとえば、Team Project=@Project 句を使うと、現在選ばれているプロジェクト内のすべての作業項目を検索できます。 既定では、現在のプロジェクトに基づいて自動的にフィルター処理されます。 詳細については、クエリの定義に関する記事の複数のプロジェクトを対象とするクエリに関する説明をご覧ください。

ID フィールドと In 演算子を使用し、[ディスカッション] セクションで自身がメンションされている作業項目を一覧表示します。 この同じ一覧は、[作業項目] ページの [メンション] ピボット ビューから見ることができます。

ID フィールドおよび In 演算子と共に使用して、最近更新された作業項目を一覧表示します。 表示される作業項目の数は、プロジェクトの作業追跡アクティビティによって異なります。 非常にアクティブなプロジェクトの場合、マクロにより、過去 30 日以内にプロジェクトで更新された作業項目が一覧表示されます。 一方、アクティブでないプロジェクトの場合は、30 日より前の作業項目がこの一覧に含まれる場合があります。 同様の一覧は、[作業項目] ページの [最近作成]、[最近更新]、[最近完了] の各ピボット ビューから見ることができます。 返される作業項目の数は 5,000 に制限されます。

DateTime フィールドで使って、現在の日付またはそれにオフセットを加減したものに関連する作業項目にフィルター処理します。 たとえば、Closed Date>=@StartOfDay-7 句を使うと、過去 1 週間に終了されたすべての項目を見つけることができます。 他の例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。

DateTime フィールドで使って、現在の月またはそれにオフセットを加減したものに関連する作業項目にフィルター処理します。 たとえば、Created Date>=@StartOfMonth-3 句を使うと、過去 3 か月間に作成されたすべての項目を見つけることができます。 他の例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。

DateTime フィールドで使って、現在の週またはそれにオフセットを加減したものに関連する作業項目にフィルター処理します。 たとえば、Changed Date>=@StartOfWeek-2 句を使うと、過去 2 週間に変更されたすべての項目を見つけることができます。 他の例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。

DateTime フィールドで使って、現在の年またはそれにオフセットを加減したものに関連する作業項目にフィルター処理します。 たとえば、Target Date>=@StartOfYear 句を使うと、目標とする日が今年にスケジュールされているすべてのフィーチャーを見つけることができます。 他の例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。

[区分パス] フィールドでのみ使って、区分パスが特定のチームに割り当てられているものに対応する作業項目にフィルター処理します。 = 演算子を使う必要があります。 たとえば、Area Path=@TeamAreas [Fabrikam Fiber]\Web 句を使うと、Web チームに割り当てられた区分パスに割り当てられているすべての項目を検索できます。 他の例については、区分またはイテレーション パスによるクエリの実行に関する記事をご覧ください。
@TeamAreas マクロは、Web ポータルから実行される場合のみ、Azure DevOps Server でサポートされます。

DateTime フィールドで使って、現在の日付または以前の日付に関連する作業項目にフィルター処理します。 また、日数を引くことで @Today マクロを変更することもできます。 たとえば、Created Date>=@Today-7 句を使うと、過去 1 週間に作成されたすべての項目を見つけることができます。 他の例については、日付または現在のイテレーションによるクエリの実行に関する記事をご覧ください。