Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
この記事では、クエリ エディターで使用するフィールド データ型、クエリ演算子、およびクエリ マクロについて説明します。 一部の型、演算子、マクロは、特定の Azure DevOps バージョンにのみ適用されます。
簡単な例とエディター タスクについては、「 クエリクイック リファレンス 」および「 クエリの管理と整理」を参照してください。
必須コンポーネント
| カテゴリ | 必要条件 |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには、プロジェクトメンバー が必要です。 - 共有クエリを追加して保存するには:少なくとも Basic アクセス。 |
| アクセス許可 | クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。 |
Note
パブリック プロジェクトの 利害関係者 アクセスが付与されたユーザーは、 基本 アクセスが付与されたユーザーと同様に、クエリ機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。
| カテゴリ | 必要条件 |
|---|---|
| アクセス レベル | - 共有クエリを表示して実行するには、プロジェクトメンバー が必要です。 - 共有クエリを追加して保存するには、少なくとも Basic アクセスが必要です。 |
| アクセス許可 | クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。 |
クエリのフィールドのデータ型と値
フィールドのデータ型と一致する値を指定する必要があります。 次の表に、サポートされているデータ型を示します。
Note
Azure Boards (クラウド) の場合、データ型は [ プロセス > フィールド] ページに表示されるフィールドと一致します。 オンプレミスデプロイの場合、データ型はtype定義のFIELD属性に対応します。 詳細については、 作業項目フィールドとフィールド属性を 参照してください。
データ型
説明
Boolean
True/False 値を格納します。
DateTime または Date/Time
日付変数 ( @Today や @Today-1など) や、 01/01/2025などの明示的な日付を使用します。 プロファイルに設定されたパターンに従って日付を入力します。 クエリの例については、 Query by date or @CurrentIterationを参照してください。
WIQL クエリの場合は、UTC で日付を指定することもできます。
作業項目クエリ言語 (WIQL) の構文を参照してください。
Double または Decimal
0.2 や 3.5 などの実数を格納します。 例については、 数値フィールドによるクエリ を参照してください。
GUID
一意の識別子を文字列として格納します。
履歴
履歴情報用のカスタム書式設定フィールド (履歴フィールド) フルテキスト検索が使用可能な場合、このフィールドはフルテキスト クエリ用にインデックスが作成されます。 「履歴と監査」を参照してください。
HTML
書式設定されたテキスト ( 説明 や 再現手順など) を格納します。 フルテキスト検索が使用可能な場合、これらのフィールドにはインデックスが作成されます。 リッチ テキスト フィールドのクエリについては、タイトル、ID、リッチ テキスト フィールドによるクエリに関する記事をご覧ください。
ID
ユーザー ID を識別する短いテキスト文字列を格納します。
Integer
符号付き 32 ビット整数 (0、1、2、34 など) を格納します。
PlainText または Text フィールド (複数行)
長いテキスト値 (アプリケーション の開始情報など) を格納します。 これらのフィールドは、サポートされている場合にフルテキスト検索のインデックスを作成します。 「タイトル、ID、およびリッチ テキスト フィールドによるクエリ」を参照してください。
picklistDouble
10 進値の選択リストを保持するユーザー設定フィールド。
picklistInteger
整数値の選択リストを保持するユーザー設定フィールド。
picklistString
短いテキスト値 (255 文字以下) の選択リストを保持するユーザー設定フィールド。
String または Text フィールド (単一行)
最大 255 Unicode 文字の短いテキストを格納します。 チームは多くの場合、これらのフィールドを選択リストまたはプルダウンメニューに使用します。
TreePath
分岐ツリー (エリア パスや反復パスなど) を表します。 有効なノード値を選択します。 等値、不等値、"Under" / "Not Under" をフィルター処理したり、 In / Not In 演算子を使用して複数の値を指定したりできます。 プロジェクトのツリー構造 (エリア パス と イテレーション パス) を定義し、チームに関連付けるノードを選択します。
クエリの例については、「 領域または反復パスによるクエリ」 および 「日付または現在のイテレーションによるクエリ」を参照してください。
Note
picklist...型は、継承されたプロセスに対して定義されたユーザー設定フィールドにのみ適用されます。
日付と時刻のパターン
DateTime フィールドに入力する日付と時間のパターンは、プロファイルで選んだものと一致する必要があります。 選んだ内容を確認または変更するには、「ユーザーの優先設定を設定する」を参照してください。
![[時刻とロケール] ペインの [日付パターン] ドロップダウン オプションを示すスクリーンショット。](../../organizations/settings/media/user-preferences/date-patterns.png?view=azure-devops)
![[時刻とロケール] ペインの [時刻パターン] ドロップダウン オプションを示すスクリーンショット。](../../organizations/settings/media/user-preferences/time-pattern.png?view=azure-devops)
![[日付パターン] フィールドと [時刻パターン] フィールドを含む [時刻とロケール] ペインを示すスクリーンショット。](../../organizations/settings/media/user-preferences/jamalh-locale-settings-server.png?view=azure-devops)
クエリ演算子
演算子を使用して、作業項目のフィールド値に句値を関連付ける方法を定義します。 フィールド データ型については、 作業項目フィールド参照を参照してください。 クエリの作成については、「 クエリの定義」を参照してください。
クエリ演算子
演算子が一致する作業項目を返す場合
適用可能なデータの種類
=
式の値と一致します。
数値 (Double/Decimal/GUID/Integer)、String、DateTime、TreePath
<>
句の値と一致しません。
Number、String、DateTime、TreePath
>
条件の値より大きい。
Number、String、DateTime
<
条件式の値より小さい。
Number、String、DateTime
>=
句の値に対して大なりイコールです。
Number、String、DateTime
<=
句の値以下です。
Number、String、DateTime
=[Field]
別の指定されたフィールドの値と一致します (同じデータ型である必要があります)。
同じデータ型のフィールドの名前 (ブール型フィールドは、他のフィールドと等しい値を比較します)。
<>[フィールド]
別の指定されたフィールドの値と一致しません。
同じデータ型のフィールドの名前。
>[フィールド]
指定した別のフィールドの値より大きい値です。
同じデータ型のフィールドの名前。
<[フィールド]
指定した別のフィールドの値より小さい値です。
同じデータ型のフィールドの名前。
>=[フィールド]
指定した別のフィールドの値以上です。
同じデータ型のフィールドの名前。
<=[フィールド]
指定した別のフィールドの値以下です。
同じデータ型のフィールドの名前。
含む
テキストの完全一致または部分的一致を含みます。
String
含まれない
ぴったりまたは部分的に一致するテキストは見つかりません。
String
単語を含む
正確な語句または単語と一致します (末尾のワイルドカード *をサポートします)。 制限: 100 文字。 この演算子はフルテキスト インデックス作成を使用します。サーバーと照合順序の要件については、この記事の「フルテキスト」セクションを参照してください。
フルテキスト検索用にインデックスが作成された長いテキスト フィールド (PlainText、HTML、History、Title)。
単語を含まない
指定した語句を含む項目を除外します。 制限: 100 文字。 キーワードを含めたり除外したりするには、コンパニオン句の Contains Words と共に使用します。
フルテキスト検索用にインデックスが作成されたテキスト フィールド。
含まれる
区切り記号付きセット内の任意の値と一致します (OS の地域リスト区切り記号 (通常はコンマ) を使用します)。
Number、String、DateTime、TreePath
空です
HTML フィールドにコンテンツが含まれていません (値が指定されていない) アイテムと一致します。 Azure Boards と Azure DevOps Server でサポートされています。
HTML
空ではない
HTML フィールドにコンテンツが含まれているアイテムと一致します。 Azure Boards と Azure DevOps Server でサポートされています。
HTML
含まれない
区切り記号付きセット内の値を除外します (地域リストの区切り記号を使用します)。 Azure Boards と Azure DevOps Server でサポートされています。
Number、String、DateTime、TreePath
グループ内
名前付きグループ (チーム、セキュリティ グループ、またはカテゴリ) のメンバーである値と一致します。 たとえば、パターン [Project Name]\Team Nameで名前が付けられた共同作成者グループまたはチーム グループを使用します。 例については、「 割り当てまたはワークフローの変更によるクエリ」 を参照してください。
文字列 (グループ名またはチーム名に一致) または作業項目の種類
Note
[ グループ内] は、文字列型フィールドまたは作業項目の種類でのみ使用します。 Microsoft Entra ID グループは、アカウントで Microsoft Entra ID を使用する場合、またはオンプレミスの Active Directory グループを使用する場合に使用できます。 :::column-end:::
グループ外
名前付きグループのメンバーを除外します。
ユーザー グループまたはプロジェクト カテゴリに一致する文字列。
次の値の下ではない
指定したツリー ノードと同じか、または指定したツリー ノードの下に含まれている項目を除外します。
TreePath
の下
指定したツリー ノードと等しいか、または指定したツリー ノードの下に含まれる項目と一致します。
TreePath
今までだった
フィールドが以前に保持していた値と一致します。
String、DateTime
Note
クエリ エディターは現在、日付フィールドの Was Ever をサポートしていません。このような場合は、直接 WIQL を使用します。
:::column-end:::
ヒント
反復パスなどの他のデータ型に対して演算子 ( Was Ever など) を使用する WIQL クエリを作成できます。 例については、「 スプリントから移動された作業項目を一覧表示 する」を参照してください。
マクロと変数のクエリ
クエリを動的にフィルター処理するには、次のマクロを使用します。
Note
次のマクロは、Web ポータルからのみサポートされています: @CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity、@TeamAreas。 これらのマクロを含むクエリは、Visual Studio のチーム エクスプローラー、Microsoft Excel、または Microsoft Project で開くと機能しません。
マクロ
説明
[任意]
作業項目の種類または状態と共に使用して、すべての種類または状態を検索します。 たとえば、 Work Item Type=[Any] は型ベースのフィルター処理を削除します。
@CurrentIteration
イテレーション パスと共に使用して、現在のチーム コンテキストに基づいて現在のスプリント内の作業項目をフィルター処理します。 例については、「 日付または現在のイテレーションによるクエリ」 を参照してください。 @CurrentIteration は、Web ポータルから実行する場合にのみ機能します (REST API または一部のコピー/複製操作では機能しません)。
@CurrentIteration +/- n
イテレーション パスと共に使用して、現在のイテレーションに対するスプリントを含めます (たとえば、@CurrentIteration-1や@CurrentIteration+2)。 Azure Boards と Azure DevOps Server の Web ポータルでサポートされます。
@Follows
ID と In 演算子を使用して、プロジェクトでフォローする作業項目を一覧表示します。
作業項目やプルリクエストのフォローについて参照してください. このマクロは、Web ポータルからのみ機能します。
@Me
ID フィールドと共に使用して、アカウントにリンクされているアイテム ( Created By=@Me など) をフィルター処理します。
「割り当て、ワークフロー、またはボードの変更によるクエリ」を参照してください。
@MyRecentActivity
ID とInを使用して、過去 30 日間に表示または更新した作業項目を一覧表示します。 同じリストの [作業項目] ページ の [マイ アクティビティ ] ピボットを参照してください。
@Project
チーム プロジェクトと共に使用して、現在のプロジェクトの作業項目 (Team Project=@Project など) をフィルター処理します。
プロジェクト間のクエリを参照してください。
@RecentMentions
ID とInを使用して、ディスカッションに記載されている作業項目を一覧表示します。 [作業項目] ページ の [メンション] ピボットを参照してください。
@RecentProjectActivity
ID とInを使用して、プロジェクト全体で最近更新された作業項目を一覧表示します。 このマクロは、最大 5,000 個の項目を返します。実際のウィンドウはプロジェクトのアクティビティによって異なります。
@StartOfDay
DateTime フィールドと共に使用して、今日を基準としてフィルター処理します (たとえば、 Closed Date>=@StartOfDay-7)。
@StartOfMonth
DateTime フィールドと共に使用して、月の始まりを基準としてフィルター処理します (たとえば、 Created Date>=@StartOfMonth-3)。
@StartOfWeek
DateTime フィールドと共に使用して、週の始まりを基準としてフィルター処理します (たとえば、 Changed Date>=@StartOfWeek-2)。
@StartOfYear
DateTime フィールドと共に使用して、年の開始日を基準としてフィルター処理します (たとえば、 Target Date>=@StartOfYear)。
@TeamAreas
チームのエリア パスに割り当てられているアイテムを検索するには、エリア パスと = オペレーターでのみ使用します (たとえば、Area Path=@TeamAreas [Fabrikam Fiber]\Web)。 Azure DevOps Server の Web ポータルでサポートされます。
@Today
DateTime フィールドと共に使用して、今日を基準としてフィルター処理します (たとえば、 Created Date>=@Today-7)。
日付または現在のイテレーションによるクエリを参照してください。
フルテキスト検索と部分単語検索
長いテキスト フィールドを対象にContainsまたはDoes Not Containを使用して完全一致または部分的一致を検索します。これらの演算子はクエリ インデックスを使用します。 完全な語句を検索するには、[単語を含む] または [単語を含まない] を使用するか、末尾のワイルドカード () を使用します。これらの演算子にはフルテキスト インデックスが必要です。
ワイルドカードは、部分的な単語または語句の末尾でのみ使用できます。 例については、作業項目クエリの例および [履歴] フィールドを使用した作業項目のクエリに関する記事をご覧ください。
Note
すべてのデプロイでフルテキスト検索がサポートされているわけではありません。 たとえば、SQL Express と一部のクラウド SQL 構成では、フルテキスト検索がサポートされていません。 これらのデプロイでは、 Contains 演算子と Not Contain 演算子のみが表示されます。
Azure DevOps Server では、基になる SQL Server でフルテキスト インデックス作成がサポートされている場合に、フルテキスト フィールド (PlainText と HTML) と Title フィールドにフルテキスト検索用のインデックスが作成されます。
フルテキスト検索には、使用する言語の登録されたワードブレーカーを含む SQL コレーションも必要です。 コレクション データベースの照合順序がサポートされている言語と一致しない場合、結果が期待値と一致しない可能性があります。このような場合は、代わりに Contains または Not Contain を使用します。
詳しくは、「フルテキスト検索のクエリと照合順序の設定」をご覧ください。
関連コンテンツ
REST API
プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。