Automation の変数
関連項目: ルールにカスタム フィールドを使用する
変数は、中括弧で囲まれた特別なテキストであり、自動化の実行時に現在の値に置き換えられます。リスト名、カードタイトル、カードの説明、およびコメントで変数を使用できます。
たとえば、自動化 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 |
日付変数
You can prepend tomorrow, yesterday, nextworkingday_, and previousworkingday_ to the following variables. For example, {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 |
You can prepend last and next to the following variables. For example: {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 |
After the create board
automation, the following board variables with the new prefix, such as {newboardlink}
, refer to the new board. After the copy board
automation, the variables with the copy prefix, such as {copyboardlink}
, refer to the new copy of the board.
変数 | 説明 |
---|---|
| 現在のボードの 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, |
| カード作成日付。 |
For the following variables, adding round at the end such as {cardagedaysround}
, rounds the number to the nearest integer.
カードの時間 | |
| カードの経過日数 (小数点以下 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 と表示されます。この変数によってタスクに費やされた時間を追跡できます。 |
| カードが前のリストで費やした日数。 |
| カードが前のリストで費やした時間数。 |
| カードが前のリストで費やした分数。 |
| トリガー カードの由来となるリスト名。 |
Additionally, you can use the following variables if your automation has a trigger that involves a source card (like when a card is copied
):
| ソース カードのタイトル。 |
| ソース カードへのリンク。 |
プレフィックスをカード変数に追加
プレフィックス | 用途 | プレフィックスが利用できない変数 |
---|---|---|
| Variables with the new prefix are available after the |
例: 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"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
---|---|---|
| Variables with the trigger prefix are available in automations where the automation trigger involves a card, such as | 使用できない変数のリストは、自動化をトリガーした Trello アクションによって異なります。 |
例: when a card is added to list "Doing", find a card titled "Rollup", and add item "{triggercardlink}" to checklist "Doing"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
---|---|---|
| Variables with the copy prefix are available after the |
例: 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"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
---|---|---|
| Variables with the found prefix are available after the | 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"
プレフィックス | 用途 | プレフィックスが利用できない変数 |
---|---|---|
| Variables prepended by multiplier are available after the multiplier automation ( |
例: 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}"
The following variables are available only for particular match types (add, mention) and in automations with triggers where a user is matched such as when someone is added to a card
or when someone is mentioned
.
In multipliers (for every member in the card
), the following variables are only available for comments and email notification actions.
変数 | 説明 |
---|---|
| 自動化で一致した (追加、メンションなど) メンバーのユーザー名。 |
| 自動化で一致した (追加、メンションなど) ユーザーの氏名。 |
| 自動化で一致した (追加、メンションなど) ユーザーのイニシャル。 |
| カードに追加されたメンバーのユーザー名。 |
| カードに追加されたユーザーの氏名。 |
| カードに追加されたユーザーのイニシャル。 |
| カードから削除されたメンバーのユーザー名。 |
| カードから削除されたユーザーの氏名。 |
| カードから削除されたユーザーのイニシャル。 |
| カードでメンションされたメンバーのユーザー名。 |
| カードでメンションされたユーザーの氏名。 |
| カードでメンションされたユーザーのイニシャル。 |
特定のトリガーを持つ自動化で変数を使用する
このセクションには、特定のトリガー条件でのみ自動化で使用できる変数のリストが含まれます。
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 (次を含む名前のカード) などのトリガー条件を持つルール
| 条件に一致したテキスト。一般に |
| 一致したテキストの前のテキスト。 |
| 一致したテキストの後のテキスト。 |
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 リクエストの後に利用できる変数
| 応答の本文。 |
Jira 課題の作成後に使用できる変数
| 作成された Jira 課題へのリンク。 |
Butler Bot の変数
注: Butler Bot の公式サポートは終了しました。Butler を新しく使い始めた場合は、従来の機能を使用できません。Trello ワークフローの自動化に関する詳細は、「自動化の概要」ガイドをご参照ください。
To see the current value of most variables, in the Automation list, create a new card named print variables
. For example, when a label is added to a card, print variables
.
自動化を実行すると、ルール ログに変数が表示されます。
この内容はお役に立ちましたか?