Confluence 自動化のアクション

ルールは必ずアクション コンポーネントで終わります。アクションはルールに実行させたいこと、つまりルールが正常に実行された後に行われる処理です。

Confluence アクション

これらのアクションは Confluence 自動化に固有のもので、個々のスペース (スペースの自動化) または一度に複数のスペース (グローバル自動化) のコンテンツを整理および管理するために使用できます。

ページとブログ

ページをアーカイブする

このアクションは、コンテンツ ツリーからスタンドアロン ページを削除し、アーカイブに保存するものです。

ページの所有者を変更する

このアクションは、指定したユーザーにページの所有権を譲渡します。

このルールが実行されると、ルールを作成した管理者に代わって、ルールが所有権を譲渡することになります。

ページのステータスを変更

このアクションは、ページのコンテンツ ステータスを指定されたステータス (たとえば、「レビュー待ち」）に変更します。

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

スマート値

• {priorContentStatus}

ページをコピーする

このアクションは、指定した場所に既存のページのコピーを公開します。ほとんどの場合は、ルールのトリガーによって、コピー元のページが定義されます (したがって、たとえばトリガーが「ページが編集されたとき」であれば、コピー元のページは編集されたページです)。

コピーを公開するスペースと、必要に応じて、その下にネストを作る親ページを選択 (または入力) します。既定のページ タイトルを更新するオプションもあります。

ページをコピーすると、チェックボックスをオフにしない限りそのラベルと表示/編集制限もコピーされます。ただし、コメント (ページとインラインの両方) と添付ファイルはコピーできません。

スマート値

• {page}

• {content}

ページの削除

このアクションによってページが削除され、ゴミ箱に移されます。

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

スマート値

• {content}

• {page}

ページの公開リンクを管理する

この操作によって、ページの現在アクティブな公開リンクが無効になるか、ユーザーが新しい公開リンクを作成できなくなります。

ページの移動

このアクションは、ページとそのページにあるネストされたページを、指定した別のスペースに移動します。

ページの移動先のスペースを選択 (または入力) します。選択したスペースのページを、移動するページまたはネストされたグループの親として指定するオプションもあります。

スマート値

• {content}

• {page}

• {space}

新しいページを公開する

このアクションは、指定された場所に新しいページを公開します。

新しいページを公開するスペースと、その下にネストを作る親ページを選択 (または入力) します。ページタイトルを入力し、オプションでテンプレートを選択します。

"ページのコンテンツ" フィールドは、テキストとスマート値をサポートしています。このフィールドでは「accountId」と {page.owner.accountId} などのスマート値でユーザーをメンションできます。

特定のユーザーをメンションする方法:

• ユーザーのプロフィールページにアクセスして、URL の最後にある文字をコピーしてください。例：https://hello.atlassian.net/wiki/people/ 557057:1 d4fd7f4-bbac-4466-82ee-aaabbbccc

• [~accountId:<user's account ID>] をページのコンテンツフィールドに追加します。

スマート値でユーザーをメンションするには、次の手順を実行します。

• アカウント ID を、"accountId" フィールドを含む任意のスマート値に置き換えます。

• 例: [~accountId:{page.owner.accountId}]

スマート値

• {content}

• {page}

ページの制限

このアクションによって、ページの表示権限と編集権限が変更されます。

適用する権限をドロップダウンから選択します。該当する場合は、特定のユーザーやグループの名前を入力するように求められます。

ブログを削除

このアクションによってブログ投稿が削除され、ゴミ箱に移されます。

コメントを追加

このアクションは、トリガーによって定義されたとおりに、ページまたはブログ投稿の下部にページ コメントを追加します。

コメントをテキスト フィールドに入力します。このフィールドはテキストとスマート値をサポートしています。このフィールドでは「accountId」と {page.owner.AccountId} などのスマート値でユーザーをメンションできます。

特定のユーザーをメンションする方法:

• ユーザーのプロフィールページにアクセスして、URL の最後にある文字をコピーしてください。例：https://hello.atlassian.net/wiki/people/ 557057:1 d4fd7f4-bbac-4466-82ee-aaabbbccc

• [~accountId:<user's account ID>] をページのコンテンツフィールドに追加します。

スマート値でユーザーをメンションするには、次の手順を実行します。

• アカウント ID を、"accountId" フィールドを含む任意のスマート値に置き換えます。

• 例: [~accountId:{page.owner.accountId}]

スマート値

• {comment}

• {content}

• {space}

• {page} *

• {blogpost} *

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

ラベルを追加する

このアクションは、トリガーによって定義されたとおりに、ページまたはブログ投稿に 1 つ以上のラベルを追加します。

追加するラベルを選択 (または入力) します。

スマート値

• {page} *

• {blogpost} *

• {content}

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

ラベルを削除する

このアクションは、トリガーによって定義されたとおりに、1 つ以上のラベルをページまたはブログ投稿から削除します。

削除するラベルを選択 (または入力) します。

スマート値

• {page} *

• {blogpost} *

• {content}

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

ウォッチャーの管理

このアクションは、トリガーによって定義されたとおりに、特定のユーザーまたはグループをページまたはブログ投稿のウォッチャーとして追加または削除します。

追加するウォッチャーまたは削除するウォッチャーを選択 (または入力) します。

スマート値

• {page} *

• {blogpost} *

• {content}

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

データ分類を更新する

このアクションは、ページまたはブログ投稿のデータ分類レベルを変更します。組織で利用可能な任意のデータ分類レベルから選択するか、スペースの既定の分類レベルを使用してください。

ホワイトボード

ホワイトボードを作成する

このアクションは、指定された場所に新しいホワイトページを作成します。

新しいホワイトボードを作成するスペースと、その下にネストを作る親ページを選択 (または入力) します。既定のホワイトボード タイトルを更新するオプションもあります。

スマート値

• {content}

• {whiteboard}

データベース

データベースを作成する

このアクションは、指定された場所に新しいデータベースを公開します。

新しいデータベースを作成するスペースと、その下にネストを作る親ページを選択 (または入力) します。既定のデータベース タイトルを更新するオプションもあります。

スマート値

• {content}

• {database}

スマート リンク

スマート リンクを作成

このアクションは、指定された場所に、指定されたタイトルとリンクのコンテンツの URL を持つ新しいスマート リンクを作成します。

フォルダー

フォルダの作成

このアクションにより、指定した場所に指定したタイトルのフォルダーが作成されます。

スペース

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

スペースの権限を追加する

このアクションは、指定した特定のユーザーやグループに、スペース、ページ、特定のページ コンポーネント、またはブログを作成、アーカイブ、または削除する権限を付与します。

このアクションで権限を付与するユーザーやグループの名前を選択 (または入力) します。既定では、このアクションは、ページを追加 (作成) する権限を付与しますが、各ドロップダウンで別のオプションを選択できます。

スマート値

• {space}

スペースをアーカイブする

このアクションは、スペースを完全に削除せずにスペース ディレクトリから削除し、アーカイブされたスペースのリストに保存します。

スマート値

• {space}

スペースへのアクセス権を割り当てる

スペースに 1 人以上のゲスト ユーザーを割り当てるか、現在割り当てられているスペースから 1 人以上のゲスト ユーザーを削除します。

スペースの公開リンクをブロックする

この操作により、スペース内のどのページの公開リンクにも誰もアクセスできなくなります。

AI（Atlassian Intelligence）

Atlassian Intelligence を使用して、ルールのスマート値を生成します。AI 要約とアクション アイテムはルールが実行されるたびに生成され、ルール内の他のアクションに追加できます。これらは将来の使用のために保存されません。

また、 AI 条件 を追加して、どのコンテンツをルールの対象となるかを定義できます。

AI 要約を生成する

このアクションでは AI を使用してテキストから要約を生成します。この要約は、ルールの実行中は {generatedAISummary} スマート値に保存されます。

使用例には、要約テキストを通知またはメールとして特定のユーザーに送信したり、ページやブログ投稿にコメントとして追加したりする方法があります。

スマート値

• {generatedAISummary}

AI アクション アイテムを生成する

このアクションは、渡されたテキストから AI に基づくアクション アイテムのリストを生成します。これらのアクション アイテムは、ルールが実行されている間、{generatedAIActionItems} スマート値に保存されます。

使用例には、ページが公開されるたびにメンションされたチーム メンバーのアクション アイテムを生成し、Slack でチーム メンバーに通知するなどがあります。

スマート値

• {generatedAIActionItems}

AI でラベルを追加

このアクションは、Atlassian Intelligence がコンテンツ アイテムのタイトルや本文で検出したテーマに基づいてスマート ラベルを追加します。

このアクションを設定するときは、コンテンツ アイテムがテーマまたはトピックに関連しているかどうかを AI が判断できるようにするプロンプトを提供します。既存のラベルを使用することも、新規で作成することもできます。アクションによって、関連するすべてのラベルを適用するか、最適なラベルのみ適用できます。

使用例の 1 つとして、今後のイベントやチーム ミーティングに関連するページを誰かが公開するたびに「チーム スケジュール」というラベルを適用します。

ルックアップ アクション

ルックアップ アクションは ブランチと同様に機能します。これによって特定のオブジェクト セットを見つけて、そのセットを ルールのスマート値 として使用できます。

たとえば、特定のユーザーが 6 か月以上前に作成したページにのみルールを実行するように設定することができます。Sarah の 6 か月以上前のページが 200 ページあるとします。ルックアップアクションなしでルールを作成すると、Sarah は 1 ページにつき 1 通のメールを受け取ることになります。ルックアップ ページをルールに追加すると、彼女はすべてのページを参照する 1 通のメールを受信するようになります。

ページの検索

このアクションは、指定した条件を満たすページを検索します。次の値を1つ以上選択して、AND/OR ステートメントとリンクさせてください。

• 作成者が次のいずれかに含まれる: 1 人または複数の人やチームを入力して、ページの作成者に関するユーザーまたはグループの情報を検索します。

• 作成者が次のいずれにも含まれない: 検索結果から 1 人または複数のユーザーまたはグループを除外します。

• 次より前/後に作成: 月、日、または週数で検索を絞り込みます。

• 次の期間中に作成: 特定の 2 つの日付間で検索します。

• 次より前に最終更新: 月、日、または週の数で検索を絞り込みます。

• 次の期間中に最終更新: 特定の 2 つの日付間で検索します。

スマート値

• {lookupPages}

• {lookupPagesPerOwner}

• {lookupPagesPerAuthor}

Jira アクション

これらのアクションにより、Confluence 自動化と Jira を接続して、Confluence でトリガーされたルールが Jira で適用されます。

Jira アクションはスペースの自動化とグローバル自動化の両方で使用できます。

Jira の課題

Jira で課題を作成

このアクションは、Jira プロジェクトで新しい課題を作成します。

たとえば、特定の Confluence スペースでページが公開されたら、対応する Jira プロジェクトでそのページをレビューするタスクを作成するというルールを作成できます。

Jira 課題コンポーネントを設定するには、次の手順を実行します。

1. ルールに課題を追加する Jira プロジェクトを選択します。

2. 作成する課題のタイプ (エピック、バグ、タスクなど) を選択します。

3. テキスト フィールドに課題の要約を入力し、課題に名前を付けます。

   1. (ルールが適用されると、名前が重複しないように要約 ID 番号が自動的に追加されます)。

4. (オプション) テキスト フィールドに既定の説明を入力します。

5. (オプション) 既定として設定するその他のフィールドを選択 (または削除) します。

選択した課題の種類に応じて、異なる既定フィールドが表示される場合や、必須になる場合があります。

Jira で課題を表示すると、ルールを作成した人が報告者として表示されます。

Jira 課題をトランジションする

このアクションは Jira 課題のステータスを変更します。

ターゲット ステータスのドロップダウンを使用してステータスを選択するか、このトランジションでコピーするソース課題を選択できます。例を以下に示します。

• 課題からコピー: 関連する課題やブランチ ルールの課題からステータスをコピーします。

• 親からコピー: サブタスクと併用するために、親課題からステータスをコピーします。

• エピックからコピー: 課題に関連するエピックからステータスをコピーします。

• 同一ステータス (ループ): トランジションした課題が現在のステータスに戻ってくる際に使用します。画面と一緒に使用すると、ユーザーから詳細データを収集できます。たとえば、エスカレーションへのトランジションなどです。

Jira で課題を編集

このアクションは、Jira 課題のフィールドにコンテンツを追加します。これを使用して、"説明" フィールドへのメモの追加や担当者の変更ができます。ドロップダウン メニューを使用して編集するフィールドを選択します。編集アクションは、既定でメール通知を送信するように設定されています。

Jira Service Management のインシデント

Jira Service Management でインシデントを作成する

このアクションにより、Jira Service Management でインシデント チケットが作成されます。 リクエスト タイプとサービス プロジェクトを選択する必要があります。

このアクションを手動トリガーで設定すると、ユーザーは Confluence コンテンツの表示中にインシデント チケットを作成できます。

一般アクション

通知

メールを送信

このアクションは、自動メール メッセージを指定された受信者に送信します。

メール コンポーネントを設定するには、次の手順に従います。

1. [宛先:] フィールドに 1 人以上の受信者を入力します。

2. [Cc] または [Bcc] を選択して、必要に応じてフィールドと受信者を追加します。

3. テキスト フィールドに [件名] 行とメッセージの内容を入力します。

4. 送信者情報を編集するには、[その他のオプション] を選択します。

Microsoft Teams のメッセージを送信する

このアクションは Microsoft Teams メッセージをチャンネルに送信します。

Microsoft Teams コンポーネントを設定するには、次の手順に従います。

1. Microsoft Teams 用の着信 Webhook を作成します。

2. URL を適切なフィールドに貼り付けます。

3. 自動メッセージのタイトルと内容をテキスト フィールドに入力します。

4. (オプション) メッセージに画像を追加するには、[その他のオプション] を選択します。

Microsoft Teams で自動化を使用する方法の詳細をご確認ください。

Slack のメッセージを送信する

このアクションは Slack メッセージをチャンネルまたは個人に送信します。

Slack コンポーネントを設定するには、次の手順に従います。

1. Slack 用の着信 Webhook を作成します。

2. URL を適切なフィールドに貼り付けます。

3. 自動メッセージをテキスト フィールドに入力します。

4. (オプション) 自分からのメッセージを受信しない場合は [送信者] をオフにします。

5. (オプション) 新しいチャンネルまたはユーザーを入力して、Webhook の初期設定を上書きします。

Slack で自動化を使用する方法の詳細をご確認ください。

Twilio (SMS) メッセージを送信する

このアクションは、Twilio サービスによって SMS メッセージを送信します。

適切なフィールドに、有効な Twilio 電話番号を含む Twilio アカウント情報を入力します。[宛先:] フィールドに 1 人以上の受信者を追加します。自動メッセージをテキスト フィールドに入力します。

Web リクエストを送信

このアクションは、ルール実行時に発信 Web リクエストを送信して別のシステムに通知します。後続のアクションで使用できる応答データが返るように、このアクションを設定できます。

Web リクエスト本文は [空] のままにするか、カスタム データ形式を入力できます。

Advanced

変数の作成

独自のスマート バリューを定義します。この値は、同一ルールの他のアクションや条件で使用できます。定義したスマート バリューには、他のスマート バリューや数学関数を含めることができます。

ログ アクション

このアクションは、値を監査ログに記録します。