Jira で課題を検索する際に便利な JQL 関数を多数用意しました。以下では、それらがどのように機能して何ができるかを説明します。追加の JQL 関数についてリクエストがあればお知らせください、バックログに追加します。


以下の JQL の例には、customField と呼ばれるものがあります。Jira インスタンスに追加できるのはカスタム フィールドです。名前は自分で選択できるので、作成した名前をご使用ください。

iqlFunction

IQL 関数をオブジェクト スキーマで使用でしたり、IQL でオブジェクト タイプを指定したりすると、パフォーマンスが大幅に向上します。たとえば、JSD SLA の計算時に IQL 関数を使用する場合は、オブジェクト タイプ名、スキーマ ID、またはオブジェクト キーを追加して IQL を制限すると、クエリを実行する時間が短縮されます。


iqlFunction(iql)

iql is the IQL to filter on.

例: 

customField in iqlFunction("Customer.\"Account Manager\" = \"Mathias Edblom\"")

または

customField in iqlFunction("Host.Virtual = true")

これによってアプリが報告されて仮想サーバーにアプリがインストールされているすべての課題が絞り込まれます。

iqlFunction (オブジェクト スキーマ名/ID、iql) (非推奨)

オブジェクト スキーマは、それ自体のカスタム フィールド設定によって決まるため、廃止されました。この可能性は将来のリリースで削除される予定です。

Object Schema Name/ID は、オブジェクト スキーマの名前 (または ID) です。

iql is the IQL to filter on.

attributeValue (非推奨)


この JQL 関数は廃止されました。iqlFunction を代用してください。

attributeValue(attribute、operator、value)

Attribute は、オブジェクト タイプ属性の名前です。

Operator は次のいずれかです: "="、"!="、"<"、"<="、">"、">="、"like"、"startswith"、"endswith"

Value は検索する値です。

例: 

customField in attributeValue("salary", ">", "70000")

Insight オブジェクトが接続されてオブジェクトに「給与」属性があり、値が 70000 を超えるすべての課題が返されます。

例: 

customField in attributeValue("Expiration Date", "<", "28/Jun/14")

Insight オブジェクトが接続されてそのオブジェクトの属性が「期限日」であり、日付が 28/Jun/14 より前のすべての課題が返されます。

現在の日付を使うには now() を使用できます。now(90) によって、今日から 90 日間を追加できます。now(-30) も同様のクエリです。


例: 

customField in attributeValue("Name", "like", "joh")

Insight オブジェクトが接続されて、そのオブジェクトの名前のどこかに「joh」が含まれているすべての課題が返されます。

例: 

customField in attributeValue("Owner", "=", "Mathias Edblom")

Insight オブジェクトが接続されて、Jira ユーザー「Mathias Edblom」がオブジェクトの所有者であるすべての課題が返されます。

ユーザー タイプでは、「currentUser()」によって現在のユーザーを絞り込めます。例: customField in attributeValue("Owner", "=", "currentUser()")

attributeValue 関数では、属性名の大小文字が区別されることにご注意ください。