フィールドに対応したスマート バリューを見つける

 

スマート バリューを使用すると、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」がハイライトされて、フッターでのその位置が示されています。

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

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

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

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

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

{{customfield_10034.value}} を使用して、このフィールドをスマート バリューで参照できます。また、スマート バリューを読みやすくするために、customfield_10034 をフィールドの名前 {{Cascade List.value}} に置き換えられます。

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

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

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

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

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

 

その他のヘルプ