Jira 課題で利用できるすべてのスマート値を見つける

 

スマート バリューを使用すると、Jira 内部の課題データにアクセス、操作できます。それによって、ルールの大幅な強化、複雑化が可能になります。大半のケースでは、利用可能な関数リストからスマート バリューを選択できます。

Jira 課題で利用可能なすべてのスマート値を表示することもできます。インスタンスが大幅にカスタマイズされている場合、REST API で適切なスマート値を検索する必要があります。

スマート値を見つける

構文は Jira の課題の JSON 表現に従います。この表現には、Jira Cloud の REST API を使用してアクセスできます。

データを読みやすくするためには、JSON データをフォーマットする拡張機能やツールのダウンロードを検討してください。

次の URL から、課題の JSON 表現を確認してください:

1 https://<yourinstanceurl>/rest/api/2/issue/<issuekey>?expand=names

課題フィールドのスマート値を見つけるには、以下を行います。

  1. ルールに表示したいフィールド値まで移動し、そのフィールドをクリックします。

  2. フッターに表示されているドット表記をコピーします。

課題の JSON のスクリーンショット。ドット表記の「fields.priority.name」がハイライトされて、フッターでのその位置が示されています。

この例では、priority フィールドが選択され、スマート バリューが {{issue.fields.priority.name}} として表示されています。フィールド セクションは必要ないので省略し、スマート バリューは {{issue.priority.name}} または単に {{priority.name}} とすることができます。

expand=names パラメーターを使用する

課題の JSON を表示中にパラメーター「?expand=names」を使用すると、出力の最初にガイドが表示されます。

以下の例では、フィールド Cascade List はカスタム フィールドで、フィールド名が表示されていません。

課題の JSON のスクリーンショット。カスタム フィールドが展開されています。フィールドの URL、値、ID が表示されています。

このフィールドは、{{customfield_10034.value}} を使用するとスマート値で参照できます。スマート値を読みやすくするために、フィールド名 {{Cascade List.value}} を、customfield_10034 で代用することも可能です。

課題の JSON のスクリーンショット。「names」が展開されて「Cascade List」の横にあるカスタム フィールド ID がハイライトされています。

スマート バリューをテストする

スマート バリューの戻り値をテストするために [手動] トリガーを [ログ] アクションと併用します。結果は以下のように監査ログに表示されます。

デバッグのルールと、スマート値についての詳細は、こちらからご確認ください

Jira Cloud の自動化ルールの監査ログ。[ログ] アクションが成功したことが示されて「This is the issue summary (これは課題の要約です)」と出力されています。

 

その他のヘルプ