自動化スマート値 - 課題

スマート値を使うと、Atlassian Automation 内の課題データにアクセスできます。たとえば、次のスマート値を使用して、課題キーと課題の要約を含む Slack メッセージを送信できます: {{issue.key}} {{issue.summary}}

Check out how we use smart values in our Jira automation template library.

{issue.[property]}

課題のスマート値は、ルールのアクティブな課題 (現在ルールを適用中の課題) に関連する情報にアクセスするために使用されます。

課題でアクセスできる情報は、「利用可能なプロパティ」セクションで後述しています。課題のプロパティの中でも特に複雑なものについては、このページの個別セクションで説明しています。

 Learn how to use these to interact with Jira’s REST API.

利用可能なプロパティ

課題フィールド

• {{issue.description}} - 課題の [説明] フィールドにあるコンテンツを返します。

• {{issue.key}} - 課題のキーを返します。このキーは、プロジェクト キーと課題の番号を組み合わせた一意の識別子です。例: PROJ-123

• {{issue.project}} - この課題が属しているプロジェクト。

• {{issue.status}} - 課題のステータス ID を返します。

• {{issue.status.name}} - 課題のステータスを返します。

• {{issue.summary}} - 課題の要約を返します。

• {{issue.versions}} - 課題の影響を受けたバージョンを返します。

• {{issue.issueType.name}} - 課題のタイプを返します (ストーリー、バグ、タスクなど)。

• {{issue.issueType.hierarchyLevel}} - 課題タイプの階層レベル、たとえば 4 を返します。

• {{issue.resolution.name}} - 課題の解決状況を返します。たとえば、修正済み、キャンセル済みなど。

• {{issue.updated}} - Returns the date the issue was updated. Can be combined with other date and time smart values. Learn more about date and time smart values.

• {{issue.Story Points}} - 課題のストーリー ポイントの見積もりを返します (企業管理対象 Jira Cloud のみ)。

• {{issue.Story point estimate}} - 課題のストーリー ポイントの見積もりを返します (チーム管理対象 Jira Cloud のみ)。

課題の日付

These can be combined with other date and time smart values. Learn more about date and time smart values.

• {{issue.created}} - 課題の作成日を返します。

• {{issue.duedate}} - 課題の期限を返します。

課題のユーザー

These can be combined with other user smart values. Learn more about user smart values.

• {{issue.assignee.displayName}} - 課題の担当者を返します。

• {{issue.reporter.displayName}} - 課題の報告者を返します。 

{issue.[Custom Field]}

{{issue.[property]}} と同様、自分の課題のカスタム フィールド情報にアクセスすることもできます。

利用可能なプロパティ

• {{issue.[Custom Field].id}} - Jira によって割り当てられたフィールドの一意の ID を返します。これは変更できないため、名前よりも優先して使用することをお勧めします。

• {{issue.[Custom Field].description}} - [簡易検索] 列で表示されているカスタム フィールドの下に表示されているテキストを返します。

• {{issue.[Custom Field].name}} - フィールドの左側に表示されるラベルを返します。

例

以下の例では、Team Leader というカスタム フィールドがあり、フィールドの値は現在 Alana Grant になっています。 

{issue.affectedServices}

Accesses the values in an issue's Affected services field. Learn more about services in Jira Service Management.

Because this smart value deals with multiple items (i.e: issues can have many fix versions), it can be used with the # symbol to apply the rule to each individual fix version. Learn more about using smart values with sections and lists.

スマート値 {{affectedServices}} は、ITSM (IT サービス管理) テンプレートを使用するプロジェクトでのみ利用できます。ITSM ベースの Jira Service Management プロジェクトでは、インシデント管理などの IT サービス プロセスをサポートするために特定の設定とフィールドが設計されています。

他のテンプレートを使用しているプロジェクトの場合は、代わりにフィールド名を直接参照してください。この方法の例を以下に示します。

• {{issue.Affected services.name}}

• {{issue.Affected services.tier}}

• {{issue.Affected services.changeApprovers.displayName}}

利用可能なプロパティ

• {{issue.affectedServices.name}} - 課題の影響を受けるサービスの名前を返します。

• {{issue.affectedServices.tier}} - 課題の影響を受けるサービスの階層を返します。

• {{issue.affectedServices.changeApprovers}} - Returns the account ID of all change approvers of the issue's services. Can be combined with other user-related smart values. For example, {{issue.affectedServices.changeApprovers.displayName}} will return their names. Learn more about user smart values.

• {{issue.affectedServices.dependentServices}} - この課題のサービスが依存しているサービスのリストを返します。上記の 3 つのプロパティもこれに追加できます。たとえば、{{issue.affectedServices.dependentServices.tier}} は依存しているサービスの階層を返します。

{issue.comments}

Returns the issue's comments. Because this smart value deals with multiple items (i.e: issues usually have many comments), it can be used with the # symbol to apply the rule to each individual comment. Learn more about using smart values with sections and lists.

利用可能なプロパティ

• {{issue.comments.last.body}} - 最後のコメントの本文を返します。

• {{issue.comments.first.body}} - 最初のコメントの本文を返します。

• {{issue.comments.reverse.body}} - 課題のコメントを逆順で返します。

• {{issue.comments.size}} - 課題にあるコメント数を返します。

• {{issue.comments.author.displayName}} - コメントの作成者を返します。

例

以下の例では、課題にある各コメントを一覧表示して、作成者と作成日時を含めています。

この例では、課題に最後にコメントを追加したユーザーの名前を返します。

{issue.components}

Used to access the values in an issue's Components field. Because this smart value deals with multiple items (i.e: issues can have many components), it can be used with the # symbol to apply the rule to each individual component. Learn more about using smart values with sections and lists.

利用可能なプロパティ

• {{issue.components.name}} - 課題の [コンポーネント] フィールドの値を返します。

{issue.epic}

課題のエピックに関する情報にアクセスするために使用されます。このスマート バリューはエピックに追加された課題でのみ機能します。

利用可能なプロパティ

• {{issue.epic.key}} - エピックのキーを返します。例: PROJ-213

• {{issue.epic.status.name}} - 「進行中」などエピックのステータスを返します。

• {{issue.epic.[Custom Field]}} - エピックのカスタム フィールドの値を返します。たとえば、エピックに [Initiative] というカスタム フィールドがある場合 {{issue.epic.Initiative}} は [Initiative] フィールドの値を返します。

{issue.fixVersions}

Used to access the values in an issue's Fix Versions field. Because this smart value deals with multiple items (i.e: issues can have many fix versions), it can be used with the # symbol to apply the rule to each individual fix version. Learn more about using smart values with sections and lists.

利用可能なプロパティ

• {{issue.fixVersions.name}} - 修正バージョンの名前を返します。

• {{issue.fixVersions.description}} - 修正バージョンの説明を返します。

• {{issue.fixVersions.archived}} - 修正バージョンがアーカイブされている場合は true を返し、そうでない場合は false を返します。

• {{issue.fixVersions.released}} - 修正バージョンがリリースされている場合は true を返し、そうでない場合は false を返します。

• {{issue.fixVersions.releaseDate}} - Returns the fix version's release date. Can be combined with other date and time smart values. Learn more about date and time smart values.

例

以下の例では、課題が追加された各修正バージョンに続けて、バージョンのリリース日を箇条書き形式でリストしています。

{issue.latest}

課題キーとそのステータスを表示します (例.: To do、進行中、または完了)。

利用可能なプロパティ:

• {{issue.latest.description}} - ステータスの説明を返します。

このスマート バリューにはコストのかさむ課題データのリロードが必要です。後続アクションが課題の最新ステータスを把握する必要がある状況でのみ使用してください。たとえば、課題を編集アクション 2 件がフィールドの値を上書きではなく追加する必要がある場合などです。

{issue.parent}

サブタスクの親課題の詳細にアクセスします。アクティブな課題がサブタスクの場合にのみ使用でき、標準課題の親課題にアクセスするために使用することはできません。

利用可能なプロパティ:

• {{issue.parent.key}} - サブタスクの親課題の課題キーを返します。

• {{issue.parent.priority.name}} - サブタスクの親課題の優先度を返します。

• {{issue.parent.epic.summary}} - 親課題のエピックの要約を返します。

{issue.properties}

任意の課題プロパティにアクセスします。プロパティは、値を格納するためにアドオンと統合機能によって頻繁に使用されます (例: {{issue.properties.some.value}})。

{issue.Request Type}

Jira Service Management リクエストから情報にアクセスします。

利用可能なプロパティ:

• {{issue.Request Type.requestType.name}} - 顧客リクエスト タイプを返します。

• {{issue.Request Type.currentStatus.status}} - 現在のリクエストのステータスを返します。

• {{issue.Customer Request Type}} - 古い Jira インスタンスの顧客リクエスト タイプを返します。

{issue.security}

セキュリティ レベルのテキストです。

利用可能なプロパティ:

• {{issue.security.name}} - セキュリティ レベル名を返します。

• {{issue.security.id}} - セキュリティ レベル ID を返します。

{issue.timetracking}

Accesses time tracking estimates. Learn more about configuring time tracking

利用可能なプロパティ:

• {{issue.timetracking.timespent}} - 課題に記録された時間を [滞在時間] フィールドに返します。

• {{issue.timetracking.remainingestimate}} - [残り時間] フィールドの値を返します。

{issue.url}

課題にアクセスするための URL。Jira Service Management リクエスト用のカスタマー ポータル URL も提供します。

利用可能なプロパティ:

• {{issue.url}} - 課題の URL を返します。

• {{issue.url.customer}} - Jira Service Management リクエスト用のカスタマー ポータル URL を返します。

{issue.versions}

Accesses the value in the issue's Affects versions field. Because this smart value deals with multiple items (i.e: issues can have many Affects versions), it can be used with the # symbol to apply the rule to each individual component. Learn more about using smart values with sections and lists.

利用可能なプロパティ:

• {{versions.name}} - 影響を受けるバージョンの名前を返します。

• {{versions.description}} - 影響を受けるバージョンの説明を返します。

• {{versions.archived}} - 影響を受けるバージョンがアーカイブされている場合は true を返し、そうでない場合は false を返します。

• {{versions.released}} - 影響を受けるバージョンがリリースされている場合は true を返し、そうでない場合は false を返します。

• {{versions.releaseDate}} - Returns the affects version's release date. Can be combined with other date and time smart values. Learn more about date and time smart values.

例

以下の例では、課題で最初に影響を受けるバージョンのリリース日が表示されます。

{issue.watchers}

Accesses the current watchers of an issue. Because this smart value deals with multiple items (i.e: issues can have many watchers), it can be used with the # symbol to apply the rule to each individual component. Learn more about using smart values with sections and lists.

利用可能なプロパティ:

• {{issue.watchers.displayName}} - ウォッチャーの表示名を返します。

• {{issue.watchers.emailAddress}} - ウォッチャーのメール アドレスを返します。

例

以下の例では、表示名とメール アドレスも含めて、課題をウォッチしている各ユーザーを箇条書き形式でリストしています。

{lookupIssues}

Returns a list of issues from a JQL search caused by the Lookup issues action.

利用可能なプロパティ:

• {{key}} - 課題キーを返します

• {{url}} - 課題の URL を返します

• {{summary}} - 課題の要約を返します。

• {{assignee.displayName}} - 担当者を返します。

• {{reporter.displayName}} - 報告者を返します。

• {{status}} - ステータスを返します。

• {{issueType.name}} - 課題タイプを返します。

• {{resolution}} - 解決状況ステータスを返します。

• {{fixVersion}} - 修正バージョンを返します。

• {{created}} - 課題の作成日を返します。

• {{updated}} - 課題の更新日を返します。

• {{Story Points}} - 課題のストーリー ポイントを返します (企業管理対象 Jira)

• {{Story point estimate}} - 課題のストーリー ポイントを返します (チーム管理対象 Jira)

例

以下の例では、JQL 検索で返されたすべての課題キーを箇条書き形式で表示します。

次の例は、JQL 検索から返された課題のすべてのストーリー ポイントを合計します。

{triggerIssue}

Refers to the original issue that triggered the rule; used when you branch the chain. Used with the Related issues condition. All properties available to {{issue}} are also available on this smart value.

{attachment}

Accesses information related to a file attachment on an issue. This will return a list of values, if the issue has more than one attachment. Learn more about list smart values.

利用可能なプロパティ:

• {{attachment.filename}}: 添付ファイルのファイル名を返します。

• {{attachment.mimeType}}: 添付ファイルのファイル フォーマットを返します。

• {{attachment.created}}: 添付ファイルが課題に追加された日時を返します。

• {{attachment.[xxx].size}}: Returns the file size of a specific attachment. Your smart value must identify a specific attachment for this to work. For example, {{attachment.first.size}} will return the file size of the first attachment. Learn more about list smart values.

• {{attachment.content}}: バイナリ コンテンツを文字列としてレンダリングして添付ファイルの内容を返します。

• {{attachment.author}}: 添付ファイルを追加したユーザーを返します。 

  • {{attachment.author.accountId}}: ユーザー名に関連付けられた ID を返します。

  • {{attachment.author.emailAddress}}: ユーザー名に関連付けられたメールアドレスを返します。

  • {{attachment.author.displayName}}: Jira インスタンスに表示される名前を返します。

  • {{attachment.author.active}}: アカウントが有効な場合は true を返し、そうでない場合は false を返します。

  • {{attachment.author.timeZone}}: ユーザーが登録されているタイムゾーンを返します (これはユーザーのログイン場所に基づいた動的な変化はせず、ユーザー アカウントに登録されているタイムゾーンです)。

{baseUrl}

Jira インスタンスの URL を表示します。

{changelog}

• 使用方法: 課題を編集するトリガー 

このスマート バリューは変更履歴と、各フィールドの変更リストにアクセスします。たとえば課題が移行される場合は、課題が移行する前のステータスが確認できます。

 セクションとリストでスマート バリューを使う方法の詳細は、こちらをご覧ください。

利用可能なプロパティ

• {{changelog.summary}} - [要約] フィールドの変更履歴情報です。

• {{changelog.issuetype}} - [課題タイプ] フィールドの変更履歴情報です。 

• {{changelog.status}} - [ステータス] フィールドの変更履歴情報です。

例

この例では、課題の [要約] フィールドの変更後の新しい値を返します。

この例では、課題の変更前のタイプを返します。

この例では、移行された課題の以前のステータスを表示します。

この例では、以前のステータス ID (別の [編集] アクションで使用するため) を表示します。

{comment}

• Used with: the Issue commented trigger.

This value won't work for any other trigger, even if a comment was added as a result (e.g. - the Issue transitioned trigger).

利用可能なプロパティ

• {{comment.body}} - ルールをトリガーしたコメントの本文を返します。

• {{comment.author}} - コメント作成者の ID を返します。

• {{comment.created}} - コメントの日時を返します。

• {{comment.visibility.type}} - コメントの制限タイプ (ある場合) を返します。例:ロール。

• {{comment.visibility.value}} - コメントの制限ラベル (ある場合) を返します。例:開発者。

• {{comment.internal}} - Jira コメントで、コメントが顧客に表示される場合は false を返します。

• {{comment.properties}} - コメントのプロパティにアクセスします。プロパティはアドオンや統合で値を保存するためによく使用されます。

• {{comment.properties."sd.public.comment".internal}} - 

例

以下の例では、誰かが課題にコメントを追加した旨の通知をSlack メッセージなどとして送信します。

{comment.id}

Used by triggers that involve adding a comment, such as Issue commented, Issue transitioned, or Issue updated. The comment that triggers the rule is stored in this smart value.

{createdIssue}

ルールで作成された過去の課題にアクセスします。 

利用可能なプロパティ

{{issue}} スマート バリューで使用されるプロパティは {{createdIssue}} でも使用できます。 

{createdIssues}

• Used with: the Clone issue, Create issue, and Create sub-tasks actions

ルールで作成された課題のリストです。 

利用可能なプロパティ

Any property used with the {{issue}} smart value can also be used with {{createdIssue}}.  Learn more about using smart values with sections and lists.

{eventType}

ルールをトリガーしたイベントのタイプです。たとえば、jira:issue_updated :issue_commented のようになります。

{fieldChange}

変更されたフィールド値にアクセスする、どこでも利用可能なスマート バリューがサポートされます。たとえば、フィールドの担当者が変わる場合、課題にコメントを追加して、前の担当者と新しい担当者を記録できます。

When there are multiple fields that have changed, {{fieldChange}} only contains the first changed value. If multiple values are changed, use # to iterate over these. For example, when setting multiple Fix Versions, then you can iterate over these using {{#changelog.fixVersion}}{{toString}}. Learn more about using smart values with sections and lists.

利用可能なプロパティ

• {{fieldChange.fromString}} - 前の値を表示されるとおりに返します。

• {{fieldChange.toString}} - 新しい値を表示されるとおりに返します。

• {{fieldChange.from}} - フィールドの前の未加工の値、つまり値の JSON 表現を返します。

• {{fieldChange.to}} - フィールドの新しい未加工の値、つまり値の JSON 表現を返します。

• {{addedfieldChange.field}} - 値の追加によって変更されたフィールドを返します。

• {{addedFieldChange.fieldId}} - 値の追加によって変更されたフィールドの fieldID を返します。

• {{addedFieldChange.fieldType}} - 値の追加によって変更されたフィールドの fieldType を返します。

• {{addedfieldChange.valueIds}} - 追加された新しい値の ID を返します。

• {{addedfieldChange.values}} - 追加された新しい値を返します。

• {{deletedFieldChange.field}} - 値の削除により値が変更されたフィールドを返します。

• {{deletedFieldChange.fieldId}} - 値の削除によって変更されたフィールドの fieldID を返します。

• {{deletedFieldChange.fieldType}} - 値の削除によって変更されたフィールドの fieldType を返します。

• {{deletedFieldChange.valueIds}} - 削除された値の ID を返します。

• {{deletedFieldChange.values}} - 削除された値を返します。

{rule}

現在の実行ルールの情報にアクセスします。

利用可能なプロパティ

• {{rule.name}} - 現在実行中のルール名を返します。

• {{rule.actor}} - ルール実行者にアクセスします。

{webhookData.[value].[childValue]}

• Used with: the Incoming webhook trigger

受信 Webhook とともに送信されたデータ (Webhook リクエストの本文など) にアクセスできます。

{webhookResponse}

• Used with: the Send web request action (Wait for response enabled)

On successful request, you will be able access webhook response data using the available smart values. If you have multiple webhook responses, you can add the # symbol to apply the rule to each individual response. Learn more about using smart values with sections and lists.

利用可能なプロパティ:

• {{webhookResponse.status}} - 応答コードを返します。例:200

• {{webhookResponse.headers}} - ドットネーションでアクセスできるヘッダー

• {{webhookResponse.headers.Content-Type}}

• {{webhookResponse.body}} - ドット ネーションでアクセスできる本文

• {{webhookResponse.body.name}}

• {{webhookResponses}} - リスト オペレーション時に作成された応答リスト

• {{webhookResponses.last.body}}

例

これは、スマート バリューで複数の応答を返す方法です。

{worklog}

• Used with: the Work logged trigger

課題に対してログが作成されたばかりの作業ログ エントリ情報にアクセスします。

利用可能なプロパティ

• {{worklog.comment}}

• {{worklog.started}}

• {{worklog.timeSpentSeconds}}

• {{worklog.timeSpent}}

• {{worklog.visibility}} - 作業ログが制限される場合に利用可能

• {{worklog.visibility.type}} - 作業ログが制限される場合に利用可能

• {{worklog.visibility.value}} - 作業ログが制限される場合に利用可能

{issue.InsightField}

インサイト フィールドの正式名、キー、または要約にアクセスします。

利用可能なプロパティ

• {{issue.InsightField}} - 課題の要約と課題キーを返します

• {{issue.InsightField.key}} - 課題キーを返します

• {{issue.InsightField.summary}} - 課題の要約を返します。

{issue.TempoAccountField}

Tempo アカウント フィールドのプロパティにアクセスします。

利用可能なプロパティ

• {{issue.TempoAccountField}} - アカウントの名前を返します

• {{issue.TempoAccountField.id}} - アカウントの ID を返します

• {{issue.TempoAccountField.name}} - アカウントの名前を返します

• {{issue.TempoAccountField.value}} - アカウントの名前を返します

{approval}

• Can be used with: the Approval required trigger and the Approval completed trigger

承認が必要: 承認が必要な課題が作成または更新された、または新しい承認者が課題に追加された際に、情報にアクセスします。

承認完了済み: 課題の承認ステップが承認または却下された際に、承認に関する情報にアクセスします。

利用可能なプロパティ

「承認が必要」トリガーと「承認完了」トリガーの両方で使用可能:

• {{approval.createdDate}} - Returns creation date of approval. Learn more about date smart values

• {{approval}} - 承認の名前を返します。

「承認が必要」トリガーのみ:

• {{approval.initiator}} - Returns account id of initiator of request. Learn more about user smart values

• {{approval.addedApprovers}} - 課題に追加された承認者のセットを返します。

  • ユーザー スマート バリューの詳細についてご確認ください

  • リスト スマート バリューに関する詳細についてご確認ください。

「承認完了」トリガーのみ:

• {{approval.approver}} - Returns approver’s account id. Can be combined with other user smart values. Learn more about user smart values

• {{approval.completedDate}} - Returns completion date of approval. Can be combined with other date smart values. Learn more about date smart values

• {{approval.decision}} - 承認の最終決定を返します。

デフォルト値

フィールドまたは値が存在しない場合は空の値 ({{invalid reference}}) を返します。これを避けるためにデフォルト値を指定できます。

たとえば、無効な参照に値が含まれていない場合、{{invalid reference|"Hello world"}} を使用して Hello world を表示できます。