Automation の変数
We're updating our terminology in Jira
'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.
See also: Use Custom Fields in rules
変数は、中括弧で囲まれた特別なテキストであり、自動化の実行時に現在の値に置き換えられます。リスト名、カードタイトル、カードの説明、およびコメントで変数を使用できます。
たとえば、自動化 when a card is moved into list "In progress", post comment "started on {date}" の {date} 変数は、カードが移動された日付を返します。
同様に、自動化 when a card is moved to "Done", post a comment "Closed by {username}" の {username} 変数は、カードを移動したユーザーのユーザー名を返します。
日時の各変数
日時の各変数は特定の時間または日付の値を返します。
注: 桁数の多い数字には、並べ替えに必要な一貫した長さになるようにゼロが含まれます。
時間変数
変数 | 例 |
|---|---|
| 9:59 PM |
| 21:59 |
| 21:59:59 EDT |
日付変数
tomorrow、yesterday、nextworkingday_、previousworkingday_ を次の変数の先頭に追加できます。たとえば、{previousworkingday_monthdaynumber}、{tomorrowmonthdaynumber}、{yesterdayisodate} などです。
変数 | 例 |
|---|---|
| October 2, 2021 |
| 3 |
| 03 |
| 277 |
| 277 |
| 1 |
| 月曜日 |
| Mon |
| 2021年10月 3日) |
| October 3, 2021 |
| 10/3/2021 |
| 2021-10-03 |
| 2021-05-08T12:17:01+03:00 |
last と next を次の変数の先頭に追加できます。たとえば、{lastweeknumber}、{nextusmonthweeknumber}、{nextquarternumber}、{lastyearshort}などです。
変数 | 説明 | 例 |
|---|---|---|
| ISO 週番号 (月曜日から開始) | 40 |
| ISO 週番号 (ゼロを含む) | 40 |
| 米国の週番号 (日曜日に開始) | 41 |
| 米国の週番号 (ゼロを含む) | 41 |
| 週が始まった年 (ISO 週番号) | 2021 年 |
| 週が始まった年、短い形式 (ISO週番号) | 21 |
| 週が始まった年 (米国の週番号) | 2021 年 |
| 週が始まった年、短い形式 (米国の週番号) | 21 |
| 月の週 (ISO週番号) | 1 |
| 月の週 (米国の週番号) | 1 |
| 現在の月番号 | 9 |
| 現在の月の番号 (ゼロを含む) | 09 |
| 現在の月名 | 9 月 |
| 現在の月の名前、短い形式 | Sep |
| 現在の年の四半期番号 | 4 |
| 現在の年 | 2021 年 |
| 現在の年、短い形式 | 21 |
ボード変数
ボード変数はボード関連データの値を返します。
変数 | 説明 | 例 |
|---|---|---|
| カードが見つかったボードの名前。 | サポート計画 |
| ボードが最後にアクティブになった日付。 | 2021年05月 7日) |
| ボードが最後にアクティブになった日時 (ISO週番号)。 | 2021-05-07T18:07:57+03:00 |
| ボードが最後にアクティブになった日付 (ISO週番号)。 | 2021-05-07T18:14:27+03:00 |
| ボードが最後にアクティブになった日付、短い形式。 | 2021年05月 7日) |
| ボードが非アクティブである日数。 | 3 |
| ボードのチームのエンタープライズ ID。 | 588efeb2ba9d0fb398 |
create board 自動化の後で、{newboardlink} などの new プレフィックスを持つ次のボード変数は、新しいボードを参照します。copy board 自動化の後で、{copyboardlink} などの copy プレフィックスを持つ変数は、ボードの新しいコピーを参照します。
変数 | 説明 |
|---|---|
| 現在のボードの ID |
| 現在のボードの名前 |
| 現在のボードへのリンク |
カード変数
カード変数はカード関連データの値を返します。これらの変数は、コンテキストにカードを持つ自動化で使用できます。
一般的なカード情報 | |
| カードの名前。 |
| カードの説明 (利用できない場合があります)。 |
| 現在のカードへのリンク。 |
| カードがあるリストの名前 (利用できない場合があります)。 |
| カードの内部 ID (例: FY2OWrnc)。この値は常に一定です。 |
| カードの内部用の長い ID (例: 571d07b591c8b68aeb4f6acc)。この値は常に一定です。 |
| ボード上のカードの内部番号 (例: 48)。この値はカードが別のボードに移動されると変化します (利用できない場合があります)。 |
| カードがあるリストの ID。 |
| カードがあるボードの ID。 |
| カードがあるボードへのリンク。 |
| カードが最後に移動された時刻 (例: 2021-05-08T09:21:26.472Z)。 |
| カードが最後にアクティブだった時刻。 |
| カードが最後にアクティブだった時刻 (ISO週番号)。 |
| カードが非アクティブだった期間 (例: a few seconds ago または 9 days ago)。 |
| カード作成時刻 (ISO週番号)。 |
カード ラベル | |
| カードに追加されたすべての名前付きカード ラベルの名前と色 (カンマ区切り)。 |
| カードに追加されたすべての名前付きラベルの名前 (カンマ区切り)。 |
| カードに追加されたすべての名前付きラベルの色 (コンマ区切り)。 |
| カードに追加されたラベルの数。 |
カード メンバー | |
| カードの全メンバーのユーザー名 (カンマ区切り)。 |
| カードのすべてのメンバーの氏名 (カンマ区切り)。 |
| カードのメンバーの数。 |
| カードの最初のメンバーに関する情報。 |
カードのチェックリスト | |
| カードにあるすべてのチェックリストの状態を含む、フォーマットされたテキスト。この変数によって、カードのチェックリストの状態のスナップショットを含むコメントを追加できます。 |
| カード上のチェックリストの数。 |
| カード上の完了済みのチェックリストの数。 |
| カード上の未完了のチェックリスト数。 |
カードの日付 | |
| 期限が完了としてマークされている場合、値は「True」です。それ以外の場合、値は「False」です。 |
| The due date of the card (not always available). You can combine this variable with all time and date variables. For instance, |
| The start date of the card (not always available). You can combine this variable with all time and date variables. For instance, |
| カード作成日付。 |
次の変数では、{cardagedaysround} のように round を末尾に追加すると、数値が最も近い整数に丸められます。
カードの時間 | |
| カードの経過日数 (小数点以下 2 桁)。たとえば、1 日 6 時間は 1.25 と表示されます。 |
| カードの経過時間 (小数点以下 2 桁)。たとえば、1 時間 40 分は 1.67 と表示されます。 |
| カードの経過時間 (分)、小数点以下 2 桁。たとえば、1 時間 40 分 30 秒は 100.5 と表示されます。 |
| カードが現在のリストで費やした時間数 (小数点以下 2 桁)。たとえば、1 時間 40 分は 1.67 と表示されます。この変数によってタスクに費やされた時間を追跡できます。 |
| カードが現在のリストで費やした分数 (小数点以下 2 桁)。たとえば、1 時間 40 分 30 秒は 100.5 と表示されます。この変数によってタスクに費やされた時間を追跡できます。 |
| カードが前のリストで費やした日数。 |
| カードが前のリストで費やした時間数。 |
| カードが前のリストで費やした分数。 |
| トリガー カードの由来となるリスト名。 |
さらに、自動化にソース カードを含むトリガー (例: when a card is copied) がある場合は、次の変数を使用できます。
| ソース カードのタイトル。 |
| ソース カードへのリンク。 |
プレフィックスをカード変数に追加
プレフィックス | 用途 | プレフィックスが利用できない変数 |
|---|---|---|
| new プレフィックスを持つ変数は、 |
例: when a card with a name containing "information security" is added to the board, create a new card with title "Security training" in list "In progress" and set the card's description to "{newcardname}: task for the current week"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
|---|---|---|
| trigger プレフィックスを持つ変数は、自動化トリガーにカードが含まれる自動化 ( | 使用できない変数のリストは、自動化をトリガーした Trello アクションによって異なります。 |
例: when a card is added to list "Doing", find a card titled "Rollup", and add item "{triggercardlink}" to checklist "Doing"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
|---|---|---|
| copy プレフィックスを持つ変数は、 |
例: when a card with the blue "Marketing" label is added to list "Backlog", copy the card to the top of list "Week 1-3" on board "Marketing team", and rename the card to "{copycardname}: incoming request"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
|---|---|---|
| found プレフィックスを持つ変数は、 | Card members, card checklists, card labels, custom field variables. |
例: when a card with the yellow "Sales" label is added to the board, find a card titled "Sales tasks", move the card to the top of the list, and post comment "{foundcardname} deadline: end of the week"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
|---|---|---|
| 先頭に multiplier が付いた変数は「乗算」自動化 ( |
例: when a card is moved into list "In progress", for each card linked in the attachments, set the card's description to "{multipliercardname}: In progress"
メンバー変数
自動化ルール (when トリガーによる自動化) でのみ使用できる変数を次に示します。
例: when a card is moved into list "Done", post comment "Completed by {username}"
コンテキストにカードを持つルールと「期限」自動化でのみ使用可能な変数を次に示します。
変数 | 説明 |
|---|---|
| カードを作成したユーザーのユーザー名。 |
| カードを作成したユーザーの氏名。 |
| カードを作成したユーザーのイニシャル。 |
例: when the due date is marked as complete in a card in list "In progress", post comment "Completed by {creatorusername}"
次の変数は、特定の一致タイプ (追加、メンション)、when someone is added to a card や when someone is mentioned などのユーザーが一致するトリガーを持つ自動化でのみ使用できます。
乗算 (for every member in the card) において、次の変数はコメントとメール通知アクションでのみ利用できます。
変数 | 説明 |
|---|---|
| 自動化で一致した (追加、メンションなど) メンバーのユーザー名。 |
| 自動化で一致した (追加、メンションなど) ユーザーの氏名。 |
| 自動化で一致した (追加、メンションなど) ユーザーのイニシャル。 |
| カードに追加されたメンバーのユーザー名。 |
| カードに追加されたユーザーの氏名。 |
| カードに追加されたユーザーのイニシャル。 |
| カードから削除されたメンバーのユーザー名。 |
| カードから削除されたユーザーの氏名。 |
| カードから削除されたユーザーのイニシャル。 |
| カードでメンションされたメンバーのユーザー名。 |
| カードでメンションされたユーザーの氏名。 |
| カードでメンションされたユーザーのイニシャル。 |
特定のトリガーを持つ自動化で変数を使用する
このセクションには、特定のトリガー条件でのみ自動化で使用できる変数のリストが含まれます。
Automations with triggers that include a custom field value:
| カスタム フィールドの名前。 |
| カスタム フィールドの値。 |
| 変更前のカスタム フィールドの値。 |
「リストが作成されたとき」、「ボードにカードが追加されたとき」などのトリガーを持つルール (これらの変数は、コンテキストにリストを含む自動化で使用可能) を次に示します。
| リストの名前 |
| リストの ID |
when a due date is added (期限が追加されたとき) トリガーを持つルール
| 期限の日付変数 |
| 開始日の日付変数 |
when a comment is posted (コメントが投稿されたとき) トリガーを持つルール
| コメントのテキスト |
| コメントへのリンク |
メンション トリガー (例: when a card is mentioned、when a member is mentioned) を持ち、find the mentioned card アクション後のルール
| メンションが発生したカードへのリンク。 |
| メンションを含むテキスト (コメント、カードの説明、またはチェックリスト項目)。 |
| すべてのカード メンションとリンクが削除された、メンションを含むテキスト (コメント、カードの説明、またはチェックリスト項目)。 |
| すべてのユーザー メンション (@ユーザー名) が削除されたメンションを含むテキスト (コメント、カードの説明、またはチェックリスト項目)。 |
| すべてのユーザーまたはカード メンションが削除された、メンションを含むテキスト (コメント、カードの説明、またはチェックリスト項目)。 |
when a checklist is added (チェックリストが追加されたとき) などの、チェックリストを含むトリガーを持つルール
| チェックリストの名前。 |
when a checklist item is checked/unchecked (チェックリスト アイテムが選択/選択解除されているとき) トリガーを持つルール
| チェックリスト項目の名前。 |
| チェックリスト項目の状態:「完了」または「未完了」 |
when a green label is added (緑のラベルが追加されたとき) などの、ラベルを含むトリガーを持つルール
| ラベル名。 |
| ラベルの色。 |
when the name of a card starts with (次でカードの名前が開始されたとき) トリガーと when a card with a name containing (次を含む名前のカード) などのトリガー条件を持つルール
| The text that matched the condition, typically used with a condition including a |
| 一致したテキストの前のテキスト。 |
| 一致したテキストの後のテキスト。 |
when the name of a card contains a date (カード名に日付が含まれるとき) トリガーを持つルール
| 自動化によって解釈された日付。 |
when an attachment is added to a card (カードに添付ファイルが追加されたとき) などのトリガーを持つルール
| 添付ファイルへのリンク。 |
| 添付ファイルの名前。 |
when the name or the description of a card starts with (カードの名前または説明の開始) などのトリガーを持つルール
| 変更されたフィールドの名前 (名前または説明)。 |
| 更新前の名前または説明のテキスト。 |
| 更新後の名前または説明のテキスト。 |
HTTP リクエストの後に利用できる変数
| 応答の本文。 |
Variables available after a Jira work item is created:
| The link to the created Jira work item. |
Butler Bot の変数
Note: Butler Bot is no longer officially supported. If you're starting out with Butler, you won’t be able to use the legacy functionality. Please see Automation overview guide to learn more about automating your Trello workflows.
ほとんどの変数の現在の値を確認するには、自動化リストで、print variables という名前の新しいカードを作成します。たとえば、when a label is added to a card, print variables などです。
自動化を実行すると、ルール ログに変数が表示されます。
この内容はお役に立ちましたか?