フィールドのスマート値

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}} に代用できます (読みやすくなります)。

確信が持てない場合は試してみましょう

スマート値を把握してデバッグするには、「ログ」アクションの使用を強くお勧めします。「ルールのデバッグ」をご参照ください。また、スマート値をデバッグ関数で囲んでも同じ処理を実行できます。このアクションを手動トリガーと組み合わせると、テストが非常に簡単になります。フィールド セットの値が設定されている課題に進んで、ルールを手動でトリガーします。その後、結果は監査ログですぐに確認できます。

最終更新日 2020 年 6 月 24 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.