フィールドに対応したスマート バリューを見つける
Automation for Jira を作成した際に、アトラシアンは誰にでも使用できるシンプルでありながら強力な Jira アプリを作成することを目標としていました。API やスクリプトの知識は不要です。
この問題を解決してルールをさらに強力にするために、スマート バリューを導入しました。大多数のユース ケースでは、利用可能な値から必要なスマート バリューを簡単に選択できます。
ただし、さらに掘り下げて Jira インスタンスで適切な値を見つける場合は、読み進めてください。
スマート値を見つける
構文は Jira 課題の JSON 表現に従います。この表現には、Jira の REST API によってアクセスできます。まず、作業をより楽にするために、拡張機能をダウンロードして JSON の見栄えをよくします。Chrome 用の JSONView 拡張機能を使用しているため、REST API からのスマート値の抽出と、フィールドとその値の調査が容易になります。
次の URL から、課題の JSON 表現を確認してください:
https://<yourinstanceurl>/rest/api/2/issue/<issuekey>?expand=namesルールに表示するフィールド値まで移動して、そのフィールドをクリックします。それから、フッターに表示されている「ドット表記」をコピーします。
この例では、優先度フィールドが選択されています。つまり、スマート値は {{issue.fields.priority.name}} ですがフィールド セクションは必須ではないため、使用するのは {{issue.priority.name}} か、それをさらに省略した {{priority.name}} でよいということです。
カスタム フィールドによる裏技
Jira のカスタム フィールドは扱いにくい場合があります。上記の URL では、パラメーターが ?expand=names であることにお気づきでしょうか? これによって、出力の最初に次の便利なガイドが表示されます。
「Status AT&T」フィールドはカスタム フィールドであり、次のとおりフィールド名を使用していないことがわかります。
このことから、{{customfield_11200.value}} によってスマート値でこのフィールドを参照できますが、customfield_11200 をフィールドの実際の名前である {{Status AT&T.value}} に代用できます (読みやすくなります)。
確信が持てない場合は試してみましょう
スマート値を把握してデバッグするには、「ログ」アクションの使用を強くお勧めします。「ルールのデバッグ」をご参照ください。また、スマート値をデバッグ関数で囲んでも同じ処理を実行できます。このアクションを手動トリガーと組み合わせると、テストが非常に簡単になります。フィールド セットの値が設定されている課題に進んで、ルールを手動でトリガーします。その後、結果は監査ログですぐに確認できます。