Confluence 自動化のトリガー

ルールは必ずトリガー コンポーネントで始まります。このトリガーが一連のルールの実行を促します。

Confluence では「新しいページが公開された際」などの製品ベースのイベントや「火曜日の午前 10 時」などの時間ベースのイベントがトリガーになる場合があります。

スペース自動化をご利用の場合は、ご利用のスペースでトリガー・イベントが発生するたびにルールが実行されます。グローバル自動化をご利用の場合は、Confluence インスタンスの任意のスペース、または指定したスペースでトリガー・イベントが発生するたびに実行されます。

Confluence トリガー

これらのトリガーは Confluence 自動化に固有のもので、個々のスペースを自動化する (スペースの自動化) ため、または複数のスペースを一度に自動化する (グローバル自動化) ために利用できます。

ページとブログ

ページがアーカイブされました

このトリガーは、ページがアーカイブされるたびにルールを実行します。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです。ブログはアーカイブできません。

スマート値

• {page}

• {content}

• {space}

ページにコメントが追加されました

このトリガーは、ページにページまたはインライン コメントが追加されるたびにルールを実行します。

これには、既存のコメントが編集された際は含まれません。

スマート値

• {page}

• {content}

• {space}

• {comment}

ページをコピーしました

このトリガーは、コピーされたページが公開されるたびにルールを実行します。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです。ブログはコピーできません。

スマート値

• {page}

• {content}

• {space}

ページが削除されました

このトリガーは、ページが削除される (つまり、ごみ箱に移される) たびにルールを実行します。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです。現時点では、「ブログが削除されました」トリガーは存在しません。

スマート値

• {page}

• {content}

• {space}

ページが編集された

このトリガーは、既存のページへの編集がアップデートとして公開されるたびにルールを実行します。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです。現時点では、「ブログが編集されました」トリガーは存在しません。

スマート値

• {page}

• {content}

• {space}

ページにラベルが追加されました

既定の状態では、このトリガーはページにラベルが追加されるたびにルールを実行します。

ドロップダウンから特定のラベルを選択して設定するオプションがあります。複数のラベルを追加する場合は、ラベルのいずれかが追加されるたびにルールがトリガーされます。

スマート値

• {page}

• {content}

• {space}

• {label}

ページを移動しました

このトリガーは、ページが移動されるたびにルールを実行します。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです。現時点では、「ブログが移動されました」トリガーは存在しません。

スマート値

• {page}

• {content}

• {space}

ページの所有者が変更された

このトリガーは、ページの所有権が譲渡されるたびにルールを実行します。

既定では、ページの作成者が所有者になります。ただし、現在のページ所有者、スペース管理者、または Confluence 製品の管理者は、ページの所有権をそのページの編集権限を持つどのユーザーにでも譲渡できます。ブログの所有権は譲渡できません。

スマート値

• {page}

• {content}

• {space}

ページが公開された

このトリガーは、新しいページが作成されて公開されるたびにルールを実行します。

これには、下書き (まだ公開されていない)、他のページからコピーされたページ (「ページをコピーしました」トリガーを参照)、ページが編集された後のアップデート (「ページを編集しました」トリガーを参照) は含まれません。

ここで言う「ページ」は「ブログ」とは異なるコンテンツ タイプです (「ブログを公開しました」トリガーを参照)。

スマート値

• {page}

• {content}

• {space}

ページ ステータスの変更

このトリガーは、ページのコンテンツ ステータスが指定したステータス (「レビュー待ち」など) に変更されるたびにルールを実行します。

コンテンツ ステータスはスペースごとに固有です。つまり、グローバル自動化を使用している場合、(ルール詳細にある) ルールのスコープを特定のスペースに設定して保存するまで、トリガーはステータスを選択できません。スコープが保存されると、提案ステータスとカスタム ステータスの両方がオプションとして表示されます。

スマート値

• {page}

• {content}

• {space}

• {priorContentStatus}

ページに添付ファイルが追加された

このトリガーは、添付ファイル (画像など) がページに追加されるたびにルールを実行します。

スマート値

• {page}

• {content}

• {space}

• {attachment}

添付ファイルがページから削除された

このトリガーは、ページの添付ファイル (画像など) が削除される (つまり、ごみ箱に移される) たびにルールを実行します。

スマート値

• {page}

• {content}

• {space}

• {attachment}

データ分類が更新されました

このトリガーは、選択したデータ分類レベルをページまたはブログに誰かが追加したときにルールを実行します。組織で利用可能な任意のデータ分類レベルから選択するか、スペースの既定の分類レベルを使用します。

タスク

タスクが作成された

このトリガーは、タスクが任意のページでいずれかのユーザーに割り当てられるたびにルールを実行します。

ドロップダウンから特定のユーザーやグループを選択してこのトリガーを設定するオプションが用意されています。その他の場合は、タスクがユーザーに割り当てられるたびにルールがトリガーされます。タスクは、 アクション アイテムでユーザーをメンションすることで割り当てられます。

スマート値

• {page} *

• {blogpost} *

• {content}

• {space}

• {task}

*- これらのスマート値があるかどうかは、ページとブログ投稿のどちらからトリガーされたかによって異なります。

タスク ステータスが変更された

このトリガーは、任意のページでタスクのステータスが変わるたびにルールを実行します。

ドロップダウンでステータスを「完了」(つまり、チェックが付いている) または「未完了」(つまり、チェックが付いていない) に指定して、このトリガーを設定するオプションが用意されています。その他の場合は、ページでタスクのチェックが付いたり外れたりするたびにルールがトリガーされます。

スマート値

• {page} *

• {blogpost} *

• {content}

• {space}

• {task}

*- これらのスマート値があるかどうかは、ページとブログ投稿のどちらからトリガーされたかによって異なります。

ブログにコメントが追加されました

このトリガーは、ブログ投稿にインラインまたはページのコメントが追加されるたびにルールを実行します。

これには、既存のコメントが編集された際は含まれません。

スマート値

• {blogpost}

• {content}

• {space}

• {comment}

ブログにラベルが追加されました

既定の状態では、このトリガーはブログ投稿にラベルが追加されるたびにルールを実行します。

ドロップダウンから特定のラベルを選択して設定するオプションがあります。複数のラベルを追加する場合は、ラベルのいずれかが追加されるたびにルールがトリガーされます。

スマート値

• {blogpost}

• {content}

• {space}

• {label}

ブログが公開された

このトリガーは、新しいブログ投稿が公開されるたびにルールを実行します。

これには、下書き (まだ公開されていない) や、ブログが編集された後のアップデートは含まれません。現時点では、「ブログが編集されました」トリガーは存在しません。

スマート値

• {blogpost}

• {content}

• {space}

ブログに添付ファイルが追加された

このトリガーは、添付ファイル (画像など) がブログに追加されるたびにルールを実行します。

スマート値

• {blogpost}

• {content}

• {space}

• {attachment}

ブログから添付ファイルが削除された

このトリガーは、ブログの添付ファイル (画像など) が削除される (ごみ箱に移される) たびにルールを実行します。

スマート値

• {blogpost}

• {content}

• {space}

• {attachment}

ホワイトボード

ホワイトボードが作成された場合

このトリガーは、新しいホワイトボードが作成されるたびにルールを実行します。

これには、コピーされたホワイトボードや、編集時に更新されたホワイトボードは含まれません。ページとは異なり、ホワイトボードには「公開」アクションがないため、ホワイトボードが作成されるとすぐに実行されます。

データベース

データベースが作成された場合

このトリガーは、新しいデータベースが作成されるたびにルールを実行します。

これには、コピーされたデータベースや、編集時に更新されたデータベースは含まれません。ページとは異なり、データベースには「公開」アクションがないため、データベースが作成されるとすぐに実行されます。

スマート値

• {database}

• {space}

スマート リンク

スマート リンクが作成されました

このトリガーは、新しいスマート リンクがコンテンツ ツリーに追加されるたびにルールを実行します。

スマート値

• {smartlink}

スマート リンクが更新されました

このトリガーは、コンテンツ ツリー内のスマート リンクが編集されるたびにルールを実行します。

スマート値

• {smartlink}

ユーザーとグループ

グループにユーザーを追加

このトリガーは、ユーザーが特定のグループに追加されるたびに実行されます。

スマート値

• {userAdded}

• {group}

ユーザーがメンションされた

初期設定の状態では、このトリガーはユーザーまたはグループがページまたはブログ投稿 (コメントを含む) でメンションされた場合にルールを実行します。

ドロップダウンから特定のユーザーやグループを選択して設定するオプションがあります。複数のユーザーやグループを追加する場合は、選択したユーザーまたはグループのいずれかがメンションされるたびにルールがトリガーされます。

スマート値

• {page} *

• {blogpost} *

• {content}

• {space}

• {user}

• {comment} *

*- これらのスマート値があるかどうかは、ページ、ブログ投稿、コメントのどれからトリガーされたかによって異なります。

スペース

(グローバル自動化のみ)

スペースがアーカイブされた

このトリガーは、スペースがアーカイブされるたびにルールを実行します。

スマート値

• {space}

作成されたスペース

このトリガーは、新しいスペースが作成されるたびにルールを実行します。

スマート値

• {space}

スマートボタン(ユーザー作成トリガー)

ユーザーは任意のページに スマート ボタンを作成して 、手動でルールをトリガーできます。

ページから手動トリガー

このトリガーでは、公開されたページの上部にある自動化メニュー (稲妻アイコン) からユーザーがルールを選択するとルールが実行されます。

自動化メニューはブログでは利用できません。

既定の状態では、このトリガーにより、スペースにアクセスできるユーザーなら誰でも自動化メニューからルールを表示して実行できます。これは必ずしも管理者に限ったことではなく、チームメイトはページ上のアクションを簡単に自動化できます。

ルールを表示して実行できるユーザーを制限するには、トリガーのドロップダウンから特定のユーザーやグループを選択します。

ルールを実行する前にユーザーが自分でルールの一部を設定する必要がある場合は、[Prompt for input (入力を促す)] チェックボックスをオンにして、テキストフィールドやチェックボックスなどを追加してください。

スマート値

• {page}

• {content}

• {space}

一般的なトリガー

スケジュール済み

スケジュール済み

このトリガーは、設定した繰り返し時間にルールを実行します。  

ドロップダウンによって基本設定を追加するか、[詳細] タブの cron 式によって微妙なタイミングを秒単位で制御します。

cron 式はスペースで区切られた値の文字列で構成されており、秒、分、時、月の日にち、曜日、年を表します。

統合 (サードパーティ)

受信 Webhook

このトリガーは、指定の Webhook URL に HTTP POST が送信された際にルールを実行します。

Webhook はサードパーティが自動化ルールをトリガーする手段です。

このトリガーを設定する際に、サード パーティ アプリの発信 Webhook 構成に追加したりカスタム スクリプトから HTTP POST リクエストを実行したりできる、固有の URL を受け取ります。

{{webhookData}} スマート バリューを使用して、Webhook が提供するカスタム データをルール内で参照できます。

その他

コンテンツ スキャン アラート

このトリガーは、コンテンツスキャンのアラートが生成されるたびにルールを実行します。Guard Detect では、認証情報、金融情報、身元情報などの特定の種類の機密データを含む Confluence ページが更新されたときに、アラートを送信できます。

このトリガーを設定するには、組織管理者または Guard Detect 管理者である必要があり、組織はAtlassian Guard プレミアムのサブスクリプションを持っている必要があります。

このトリガーのスマート値