アセット クエリ言語 (AQL) 構文を使用する

objectSchema

検索結果を次のように特定のオブジェクト スキーマ名に制限できます。objectSchema = "ITSM Schema".

objectSchemaId

検索結果はオブジェクト スキーマ ID に制限できます。例:objectSchemaId in (1, 2).

objectType

検索結果は次のように特定のオブジェクト タイプ名に制限できます。objectType = "Employment Start Date".

objectTypeId

検索結果はオブジェクト タイプ ID に制限できます。例:objectTypeId in (1, 2).

object

オブジェクトの検索は次のように制限できます。"object having inboundReferences()" では、インバウンド参照を持つすべてのオブジェクトを検索します。

objectId

次のように、オブジェクト ID でオブジェクトを検索できます。"objectId = 114".オブジェクト ID はオブジェクトのキーにある番号ですが、プレフィックスがありません。たとえば、オブジェクトのキーが ITSM-1111 の場合、プレフィックスは ITSM でありオブジェクト IDは 1111 です。

=

大文字と小文字を区別しない値の等価テスト。

Office = Stockholm

Office 属性に、Stockholm または STOCKHOLM と等しい値があるかどうかを確認します。

==

大文字と小文字を区別する値の等価テスト。

Office==Stockholm

Office 属性に、入力した大文字/小文字を考慮して Stockholm と等しい値があるかどうかを確認します。

!=

不等式テスト

objecttype=Employee と Office!=Stockholm

Employee オブジェクトに、値が Stockholm と等しくない属性 Office があるかどうかを確認します。

<

指定の値より小さいかどうかのテスト。

Price < 2000

Price が 2000 ドル未満かどうかを確認します。

>

指定の値より大きいかどうかのテスト

Price > 2000

Price が 2000 ドルを超えているかどうかを確認します。

<=

指定の値以下かどうかのテスト

Price <= 2000

Price が 2000 ドル以下かどうかを確認します。

>=

指定の値以上かどうかのテスト

Price >= 2000

Price が 2000 ドル以上かどうかを確認します。

like

クエリ内の入力のサブセットと値を照合します。大文字と小文字は区別されません。

objecttype=Employees と Office like Stock

'Stock' または 'STOCK' という文字を含む Office 属性値のある Employees type のオブジェクトを返します。

not like

クエリの入力のサブセットと一致する値を除外します。

objecttype=Employees and Office not like Stock

「Stock」という文字を含まない Office 属性値のある Employees type のすべてのオブジェクトを返します。

in()

指定された引数と一致するものを検索して、結果を返します。

Office in (Stockholm, Oslo, "San Jose")

Stockholm、Oslo、または San Jose のいずれかの値を持つ Office タイプのすべてのオブジェクトを返します。

not in()

指定された引数との一致が見つかった結果を除外します。

Office not in (Stockholm, Oslo, "San Jose")

Stockholm、Oslo、または San Jose のいずれかの値を持たない Office タイプのすべてのオブジェクトを返します。

startswith

値が指定された入力で始まる一致を検索します。大文字と小文字は区別されません。

Office startsWith St

文字 "St" または "ST" で始まる Office タイプの値と一致する結果を返します。

endswith

値が指定された入力で終わる一致を検索します。大文字と小文字は区別されません。

Office endsWith St

文字「St」または「ST」で終わる Office タイプの値と一致する結果を返します。

is

値が存在するかどうかをテストするのに役立ちます。

Office is EMPTY

Office タイプの値が存在するかどうかをチェックして、それに応じて結果を返します。

"Office is not EMPTY"

Office タイプの値が空ではないかどうかを確認します。

dot operator(.)

オブジェクトの Referenced タイプ属性にナビゲートできます。

この演算子は一般に、次の場合に使用されます。

inboundReferences() または inR() 関数。

outboundReferences() または outR() 関数。

order by 句。

Country.Office = Stockholm

ここで、ドット演算子は属性 Country で参照されるオブジェクト Office に移動して、Office を値 Stockholm と比較します。

having

inboundReferences() または outboundReferences() 関数で使用

object having inboundReferences()

インバウンド参照を持つすべてのオブジェクトを返します。

not having

inboundReferences() または outboundReferences() 関数で使用

object not having inboundReferences()

インバウンド参照を持つすべてのオブジェクトを除外して、結果を返します。

日時

now()
startOfDay()
endOfDay()
startOfWeek()
endOfWeek()
startOfMonth()
endOfMonth()
startOfYear()
endOfYear()

幅広い関数を使用して、日時を含むクエリを記述できます。

m は分、h は時間、d は日数、w は週数をそれぞれ表します。

例: Created > "now(-2h 15m)" のような条件のあるクエリは、2 時間と 15 分以内に作成されたすべてのオブジェクトを返します。

例: 次のものを含むクエリ: objectType = Employees and "Employment End Date" < endOfMonth(-90d)

は、Employment End Date が現在月の最終日までの 90 日間になるすべての Employee オブジェクトを返します。

例: また、将来の日付を確認できます。たとえば、ソフトウェアのライセンスの有効期限が年末のいつまでに期限切れになるかを確認します。クエリは次のようにできます。licenseEndDate = endOfYear()

他のすべての日付関数も同様の方法で使用できます。

ユーザー

currentUser()

AQL クエリでこの関数を呼び出すと、現在の (ログイン) ユーザーに接続されているユーザー属性をフィルタリングできます。クエリでフィルタリングに使用する属性は、User タイプである必要があります。

例: objecttype = Computer and User = currentUser()

この関数は、CurrentUser が選択されている、つまりユーザーがログインしているときに機能します。

currentReporter()

AQL クエリでこの関数を呼び出すと、カスタム フィールドの現在の報告者に接続されているユーザー属性をフィルタリングできます。 クエリでフィルタリングに使用する属性は、User タイプである必要があります。

例: User = currentReporter()

この関数は、課題が選択されている場合にのみ機能して、現在の課題に表示される報告者を参照します。

user(user1, user2, ..)

関数の引数リストで指定したユーザーへの参照を持つオブジェクトをフィルタリングできます。フィルタリングに使用する属性は、User タイプである必要があります。 

この関数は、フィルタリングする User タイプ属性が複数の値を許可する場合、つまりこのカーディナリティが複数の場合のみ、複数の引数で機能します。

例: オブジェクト タイプ Team には属性 Member があります。この属性は User タイプです。さらに、この属性のカーディナリティは 3 と設定されています。ユーザー admin と manager がメンバーである一連の Team オブジェクトを検索する場合は、以下のクエリを記述できます。

objecttype=Team and Member having user("admin", "manager")

グループ

group(group1, group2,...)

特定のグループ内のユーザーに接続されている任意のオブジェクトをフィルタリングできます。フィルタリングに使用する属性は、User タイプである必要があります。

例:User in group("jira-users", "jira-administrators")

user(user1, user2, ...)

特定のグループ内のユーザーに接続されている任意のオブジェクトをフィルタリングします。フィルターに使用する属性は、Group タイプである必要があります。

例 Group having user("currentReporter()")

Project

currentProject()

現在選択されている Jira プロジェクトに接続されているオブジェクトを絞り込みます。チケットのコンテキスト内でのみ機能します。

例: Project = currentProject()

a

• inboundReferences(AQL)

• inR(AQL)

インバウンド参照のあるオブジェクトをフィルタリングします。この参照オブジェクトは、関数への引数として提供された AQL クエリに一致するものです。

例:object having inboundReferences() のような AQL クエリは、関数に対する空の AQL 引数がすべてのインバウンド参照オブジェクトと一致するため、インバウンド参照のあるすべてのオブジェクトを返します。

ただし、object having inboundReferences(Name="John") のようなクエリの例では、属性 Name があり Name の値が「John」のようなインバウンド参照オブジェクトのあるすべてのオブジェクトを返します。

B

• inboundReferences(AQL, referenceTypes)

• inR(AQL, refTypes)

これは、(a) で説明されている inboundReferences(AQL) 関数から派生したものです。

これを使用すると、参照タイプを 1 つ以上の値として指定することによって、インバウンド参照オブジェクトをさらにフィルタリングできます。これは "IN" 演算子を使用して行えます。

参照タイプは、オブジェクト タイプの参照オブジェクトを定義するときに属性に指定する [追加値 (Additional Value)] フィールドです。

例:object having inR(objectType = "File System", refType IN ("Depends")) のような AQL クエリは

「File System」というインバウンド参照オブジェクトがあり、その File System オブジェクトの参照タイプが 「Depends」であるオブジェクトを返します。

同様に、object having inR(objectType = "File System", refType IN ("Depends", "Installed", "Using")) のような AQL クエリは

File System というインバウンド参照オブジェクトがあり、その File System オブジェクトの参照タイプが Depends、Installed、Using のいずれかであるオブジェクトを返します。

c

• outboundReferences(AQL)

• outR(AQL)

アウトバウンド参照のあるオブジェクトをフィルタリングします。この参照オブジェクトは、関数への引数として提供された AQL クエリに一致するものです。

例:object having outboundReferences() のような AQL クエリは関数への空の AQL 引数がすべてのアウトバウンド参照オブジェクトと一致するため、アウトバウンド参照のあるすべてのオブジェクトを返します。

ただし、bject having outboundReferences(Name="John") のようなクエリの例では、属性 Name があり、Name の値が "John" のようなアウトバウンド参照オブジェクトのあるすべてのオブジェクトを返します。

d

• outboundReferences(AQL, referenceTypes)

• outR(AQL, refTypes)

これは、(b) で説明されている outboundReferences(AQL) 関数から派生したものです。

これを使用すると、参照タイプを 1 つ以上の値として指定することによって、アウトバウンド参照オブジェクトをさらにフィルタリングできます。これは "IN" 演算子を使用して行えます。

参照タイプは、オブジェクト タイプの参照オブジェクトを定義するときに属性に指定する [追加値 (Additional Value)] フィールドです。

例:object having outR(objectType = "Employees", refType IN ("Location")) のような AQL クエリは

アウトバウンド参照オブジェクト Employees があり、その Employees オブジェクトの参照タイプが "Location" であるオブジェクトを返します。

同様に、object having outR(objectType = "Employees", refType IN ("Location", "Country")) のような AQL クエリは

アウトバウンド参照オブジェクト Employees があり、その Employees オブジェクトの参照タイプが Location, Country のいずれかであるオブジェクトを返します。

connectedTickets(JQL query)

指定の JQL クエリに一致するチケットが接続されているオブジェクトが返されます。

たとえば、クエリ: object HAVING connectedTickets(labels is empty)

は JQL クエリ (labels is empty) を接続されているすべてのチケットで実行して、その結果に基づいてオブジェクトを返します。

objectTypeAndChildren(Name)

Name とその子によって指定されたオブジェクト タイプに基づき、オブジェクトをフィルタリングします。名前にスペースが含まれている場合は、必ず二重引用符で囲んでください。

objectTypeAndChildren(ID)

ID とその子によって指定されたオブジェクト タイプに基づき、オブジェクトをフィルタリングします。