Jiraクエリ言語を実際に使用する方法

みなさん、こんにちは！



私の名前はセルゲイ・ラコフです。RostelecomITのB2G部門の責任者です。 Jira Query Language（JQL）について、実際の使用方法、基本的なテクニック、発生した問題、およびそれらの解決方法について説明します。



deviniti.com/atlassianから撮影した元の写真



タスクトラッカーはたくさんありますが、それぞれがいくつかの問題を解決するのに適しており、他の問題を解決するのに実際には役立ちません。私たちはそれらの多くを使用しましたが、今ではJiraに落ち着きました-それが私たちの主要なツールです。個人的には、作業を大幅に簡素化し、箱から出してチケットを見つけるための強力で柔軟なツールを使用できるJQL言語が本当に気に入っています。



箱から出して、Jiraには基本的な検索と高度な検索があります。これらの2つの検索オプションは、ユーザーが直面している問題のほとんどを解決できます。基本的な検索は、オンラインストアのサービスを少なくとも1回使用したことがある人なら誰でも知っています。これは、同じ単純なスキームに従って機能します。多くのフィルターがあります：プロジェクト別、タスクのタイプ別、実行者別、ステータス別。 Jiraでサポートされている基準に基づいてフィールドを追加することもできます。



ただし、基本的なクエリを超える必要がある場合は問題が発生します。たとえば、特定の実行者にこれまでに実行されたタスクを検索したり、1つのプロジェクトを除くすべてのタスクを検索したりする場合です。基本検索を使用して、1つのタスクステータスと実行者、およびもう1つの実行者と別のタスクステータスを持つプロジェクトに対してトリッキーな選択を行うことはできなくなりました。



高度な検索が役に立ちます。 JQL構文はSQLと非常によく似ています。ただし、JQLでは、選択する特定のフィールドを選択する必要はなく、表示するテーブルとデータベースを示します。条件付きのブロックのみを指定し、並べ替えを処理します。残りはJiraが自動的に実行します。



JQLを使用するために知っておく必要があるのは、チケットを選択するフィールドの名前、演算子（=、！ =、<、>、In、not in、was、isなど）、キーワード（ AND 、OR、NOT、EMPTY、ORDER BYなど）および詳細モードですぐに使用できる関数（ Now（）、CurrentUser（）、IssueHistory（）、EndOfDay（）など）。

田畑

Jiraは、検索バーに入力すると、フィールドとこれらのフィールドの値の両方によって、探しているすべての可能な値のヒントを提供します。私自身、最近、興味深いシステムフィールドlastViewedを発見しました 。 Jiraはチケットビューを追跡します。



最近のタスクを表示するためのフィルターを作成するための2つのオプションを次に示します。 1つ目はlastViewedオプションで、 Jiraは過去7日間に表示した問題を降順で返します。このフィルターはダッシュボードでガジェットとして構成されており、頻繁に使用します。チケットが閉じていたので、タブと番号を覚えていなかったので、すぐに開いて、最後のチケットが何であるかを調べました。



最近表示された標準フィルターがあります。IssueHistory（）関数を使用し 、並べ替えもlastViewedフィールドによって行われます 。結果は同じですが、Jiraでも、方法は異なります。これは、ことは注目に値する LastViewedと IssueHistory（）フィールドは、あなたが第三者の歴史をこのように見ることができません-のみ閲覧履歴を返します。





ほとんどの場合、Jiraには標準の演算子があります。私のお気に入りのオペレーターは、 WAS、 WAS IN、 WAS NOT IN、 WAS NOT、 CHANGED彼らは時間で動作しているため。これは、従来のデータベースでは不可能です。







Jiraを使用すると、箱から出してすぐに履歴データを操作できます。WASオペレーターを使用する と、実行者がUser1であったチケットを見つけることができます。チケットが私にあった後、他の誰かに渡された場合、リクエストには、このチケットがかつて私にあったことが示されます。より詳細な選択を行うには、さらにいくつかの条件を追加する必要があることは明らかですが、これについては後で説明します。



ただし、注意点が1つあります。Jiraはテキストフィールドの履歴を保存しません。チケット名とその説明です。そこに書くことはできません：「 概要フィールドに「Rostelecom」という単語が含まれているチケットを持ってきてください」。



2番目の例は、CHANGED演算子を使用したもの です。2020年1月1日以降にアーティストが変更されたチケットを受け取りたいです。他の追加の単語、たとえば、BEFOREまたはsigns>、<を使用できます。 これは、誰にとっても便利であり、特定の日付です。同じ例で、否定を行って、どのユーザーがスタックしているチケットを確認することもできます。担当者は 「2020-01-01」の後で変更されていません。

キーワード

主なキーワードは OR、 AND、 NOTです。これらは論理演算子と同じように機能します。ORを使用して 、2つのプロジェクトAとBからチケットの完全なセットを取得します。選択を絞り込む必要がある場合は、ANDを使用します 。例-ユーザーがBedを実行していたドラフトAからのチケットが必要であり、 project = A = BedおよびAND担当者です。それは否定と同じです。

関数

ドキュメントによると、Jiraには47の関数がありますが、私はそれらすべてを使用したことはありません。私の意見では、主なものは次のとおりです







。now（）は、たとえば期限切れのチケットを検索できる人気のある機能です。



currentUser（）は現在のユーザーを返します。 Jiraには、この機能を使用する事前構成済みのフィルターが含まれています。で あるCurrentUser（）、あなたは一般的な検索を行うことができます。これが私が開発チーム全体のためのユニバーサルダッシュボードを作成した方法です。ダッシュボードにガジェットを詰め込み、それぞれの特定のユーザーの代わりにcurrentUser（）を示しました 。このダッシュボードは、構成は同じですが、ログインしているユーザーごとに一意になります。



unreleasedVersions（）は、未リリースバージョンのチケットを返す関数です。ただし、バージョンのないチケットは返却されません。



startOfDay（）は、当日の開始を返します。週、月、年の機能があります。同じことがendOfDay（）終了関数にも当てはまります 。特定の日付を取り除くことができ、引数を与えることができます。startOfDay（-1）と書く と、前日の始まりが返されます。すべてをそのままにしておくと、当日の始まりが表示され、出力は時刻になります。これらの関数はハードコードを回避するのに役立ち、私たちはそれらを頻繁に使用します。 issueHistory



から （）すでに例を挙げましたが、この関数はビューのみのリストを返します。



linkedIssues（）は、特定のチケットにリンクされているチケットを見つけることができる関数です。



これらは最も単純な関数です。しかし、もう少し深く掘り下げて、より複雑な接続を見てみましょう。

assignee was currentUser()

AND fixVersion was in
unreleasedVersions()

AND created > startOfYear()

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

少し総合的な例ですが、それでも。これは、3つのブロックに分割された単一のリクエストです。リクエストの最初の部分を完了すると、私がこれまでに実行者であったか、現在実行者であるチケットを受け取ります。WASが存在しただけでなく、まだ存在していることは非常に重要です 。



2番目の部分では、フィルタリングが追加されます。これまでにリリースされていないバージョンであったチケットの受信スコープをフィルタリングします。つまり、この未リリースバージョンにチケットがあり、現時点ではまだリリースされていないのに、チケットを別のバージョンに転送し、すでにリリースされている場合、そのチケットはこの選択に含まれます。



3番目の条件は作成日です。今年の初め以降に作成されたチケットのみをフィルタリングします。

ScriptRunner

これは、Jiraの機能を大幅に強化するプラグインです。通常、プロセスを自動化するために使用されますが、JQLに多くの追加機能も追加します。 ScriptRunnerは、2018年の終わりにJiraに移行するとすぐに提供した最初のプラグインでした。このプラグインがないと、エピックとのリンクに関するデータを収集できなかったため、このプラグインのインストールを非常に積極的に依頼しました。たとえば、特定のリクエストのすべてのエピックチケットや、サブクエリからのチケットのすべてのエピックを返す必要があることがよくありました。 ScriptRunnerを使用すると、これらすべてを正常に実行できます。



ScriptRunner機能を使用するには、追加の単語を追加する必要が でissueFunctionのか ではないにJQL。次は、たとえば関数です。 epicsOf（） -サブクエリ条件に一致するチケットエピックを返します。サブクエリは括弧内の2行目にあり、詳しく見ていきます。

issueFunction in epicsOf
("worklogDate >= startOfWeek(-1) AND worklogDate <= endOfWeek(-1)")
AND project in (".B2G")
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

最初の例では、先週の時間償却のある叙事詩を探しています。チームリーダーとマネージャーのライフハック：タイムシートに記入するのを忘れて、先週何をしたか覚えていない場合は、このリクエストを完了すると、チームがどのような叙事詩に取り組んだかがわかります。そして、おそらく、チームが明らかに質問をしてきたので、あなたもそれらに取り組みました。一般に、このクエリはあなたが何をしていたかを思い出すのに役立ち、すべてがうまくペイントできます。



クエリ自体は、括弧から、つまり、worklogDateサブクエリ（借方記入の日付）から実行を開始します 。さらに、> = startOfWeek（-1） -週の初めという仕様 があります。ただし、-1という数字に注意してください。これは、今週の月曜日ではなく、最後の月曜日が必要であることを意味します。また、 worklogDate <= endOfWeek（-1）、つまり、先週の終わりよりも少ないです。このリクエストは、バグ、タスク、ユーザーストーリーなど、従業員が先週の月曜日から日曜日までの時間を書き留めたチケットを発行します。



トリックは、ということですstartOfWeek（）と endOfWeek（）関数は、 日付を取り除くことができます。私がこのリクエストを行う今週の期間に関係なく、それは私に同じ壮大な範囲を与えます。今週が終わるとすぐに、彼はその叙事詩を返します。驚いたことに、誰もがこの機会を利用しているわけではありません。私は最近、公開されているオープンリクエストを調査し、そこで多くのハードコードの日付を確認しました。そして、これらの日付は絶えず変化しているという疑いがあります。そして、私が言えることは、最初は自分でやったことです。



サブクエリを実行することにより、通常のチケットのセットを取得します。次はepicsOf関数です 。これは、これらのチケットに関連付けられているエピックのリストを提供します。そして、プロジェクトによるフィルタリングがあります。なぜなら、私は自分のプロジェクトにエピックだけが必要であり、他の誰もが面白くないからです。



次のリクエストは、今年は償却のある叙事詩ですが、契約はありません。このリクエストは、Jiraをタスクトラッカーとしてだけでなく、財務会計にも使用しているために発生しました。契約用の別のプロジェクトがあり、チケットの形で実行し、それを電子ドキュメント管理システムとして使用します。ステータスは絶えず変化し、契約を叙事詩とリンクし、何人の人がどの叙事詩に書き留めたかを知り、それがいくらかかるかを知っています。契約ごとに作業費を設定します。さらに、契約を通じて、人件費はRedmine2.0に転送されます。つまり、Jiraで償却し、自動スクリプトがこれらの契約に基づいてコストをRedmine2.0に転送します。



この自動化が機能し始めたとき、私はタイプの同僚からリクエストを受け取り始めました。そこには契約がないため、人件費をRedmineに転送できない叙事詩があります。リクエストをさらに詳しく考えてみましょう。

issueFunction in epicsOf("worklogDate >= startOfYear()")
AND issueFunction not in hasLinkType(Contract)
AND project in (".B2G")
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

同封のリクエストは、今年請求されたチケットに関心があることを意味します。epicsOf関数 は前の例に続き、epicのリストを提供します。次に、契約の存在でフィルタリングします。



括弧内の契約は、契約をエピックに接続する一種の内部リンクです。 hasLinkType（）は、このリンクタイプのチケットを返すScriptRunnerの関数です。しかし、私はこのタイプの関係を含まないチケットが必要なので、ではない否定を使用します。



最初の条件が満たされたとき、私は今年関連する叙事詩の範囲を手に入れました。さらに、契約のない叙事詩はフィルタリングされ、最終的には特定のプロジェクト「Video.B2G」のためにフィルタリングされました。このようにして、私はすべての叙事詩を扱うことができました。



そして最後に、この投稿のトピックに関する3つの質問の小さなテストに合格することを提案したいと思います。2分かかります。合格した後、あなたはあなたの評価を見るでしょう。

ポーリングリンク

コメントで何かを明確にしたり、質問に答えたりできれば幸いです。

ありがとうございました。