アセットの JQL 関数
Jira で課題を検索する際に便利な JQL 関数が多数用意されています。それらがどのように機能して何ができるかを次に説明します。追加の JQL 関数についてリクエストがあればお知らせください。バックログに追加します。
以下の例における issueFunction とは?
以下の JQL の例には、customField と呼ばれるものがあります。Jira インスタンスに追加できるのはカスタム フィールドです。名前は自分で選択できるので、作成した名前をご使用ください。
aqlFunction
AQL 関数をオブジェクト スキーマで使用したり、AQL でオブジェクト タイプを指定したりすると、パフォーマンスが大幅に向上します。たとえば、JSD SLA の計算時に AQL 関数を使用する場合は、オブジェクト タイプ名、スキーマ ID、またはオブジェクト キーを追加して AQL を制限すると、クエリを実行する時間が短縮されます。
aqlFunction(aql)
aql はフィルターをかける AQL です。
例:
customField in aqlFunction("Customer.\"Account Manager\" = \"Mathias Edblom\"")
または
customField in aqlFunction("Host.Virtual = true")
これによってアプリが報告されて仮想サーバーにアプリがインストールされているすべての課題が絞り込まれます。
aqlFunction(object schema name/id, aql) (非推奨)
オブジェクト スキーマは、それ自体のカスタム フィールド設定によって決まるため、廃止されました。この可能性は将来のリリースで削除される予定です。
Object Schema Name/ID は、オブジェクト スキーマの名前 (または ID) です。
aql はフィルターをかける AQL です。
attributeValue (非推奨)
この JQL 関数は廃止されました。aqlFunction を代用してください。
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 関数では、属性名の大小文字が区別されることにご注意ください。