YouTrack および Hub ヘルプの開発者ポータル

Hub API クエリ構文

概要

このドキュメントでは、Hub クエリ文法の BNF の説明を提供します。

文法

<Query> ::= <OrExpression> EOF <OrExpression> ::= <AndExpression> "or" <AndExpression> <AndExpression> ::= <SignExpression> "and" <SignExpression> <SignExpression> ::= ("not")? <Item> <Item> ::= <Field>| <Tuple>| <Paren>| <Phrase>| <Text> <Field> ::= <FieldName> ":" <FieldValue> <Tuple> ::= <TupleName> "(" <Field> <Field>* ")" <Paren> ::= "(" <OrExpression>| EOF ")"

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

  • <Text> — 任意のテキスト。

  • <Phrase> — 正確に一致するテキスト。

  • <FieldName> — フィールド名(ID、名前など)。使用可能なすべての JSON フィールド名に加えて、「is」、「in」、「has」などの追加の名前が含まれます。

  • <FieldValue> — 一言ではない値の属性値(admin、global、{my globalpermission} など)は「{」「}」で囲む必要があります

  • <Tuple> — フィールドによる条件付き一致(access(project: 「myProject」: " 自分のロール "))

サンプル

クエリ

説明

name: admin

visibleName 「admin」を持つすべてのユーザーを検索します。

is: banned

禁止されているすべてのユーザーを検索します。

access(project: MyProject , with: read-issue-permission )

プロジェクト「MyProject」へのアクセス権と権限「read-issue-permission」を持つすべてのユーザーを検索します。