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

 

スマート バリューを使用すると、Jira 内の課題データにアクセスして操作できます。ルールをさらに強力に、複雑なものにもできます。大半のケースでは、利用可能な関数リストからスマート バリューを選択できます。

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

スマート値を見つける

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

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

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

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 が表示されています。

You can reference this field in a smart value using {{customfield_10034.value}}. To make this smart value easier to read, you can also substitute customfield_10034 for the field’s name: {{Cascade List.value}}.

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

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

To test what a smart value returns, use the Manual trigger with Log action. The result displays in the audit log, as shown below.

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

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

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。