Confluence 自動化のアクション

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

Confluence アクション

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

ページとブログ

ページをアーカイブする

This action removes a standalone page from the content tree and stores it in the archive.

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

This action transfers page ownership to the person you specify.

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

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

This action changes a page’s content status to a status you specify (for example, “ready for review”).

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

スマート値

• {priorContentStatus}

ページをコピーする

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

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

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

スマート値

• {page}

• {content}

ページの削除

This action deletes a page, sending it to the trash.

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

スマート値

• {content}

• {page}

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

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

ページの移動

This action moves a page, and any nested pages it may have, to another space you specify.

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

スマート値

• {content}

• {page}

• {space}

新しいページを公開する

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

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

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

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

• Visit their profile page and copy the characters at the end of the URL, for example: https://hello.atlassian.net/wiki/people/557057:1d4fd7f4-bbac-4466-82ee-aaabbbccc

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

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

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

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

スマート値

• {content}

• {page}

ページの制限

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

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

ブログを削除

This action deletes a blog post, sending it to the trash.

コメントを追加

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

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

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

• Visit their profile page and copy the characters at the end of the URL, for example: https://hello.atlassian.net/wiki/people/557057:1d4fd7f4-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}

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

データ分類を更新する

This action changes the data classification level of a page or blog post. Select from any data classification level available in the organization or use the space’s default classification level.

ホワイトボード

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

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

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

スマート値

• {content}

• {whiteboard}

データベース

データベースを作成する

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

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

スマート値

• {content}

• {database}

スマート リンク

スマート リンクを作成

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

フォルダー

フォルダの作成

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

スペース

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

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

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

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

スマート値

• {space}

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

This action removes a space from the Space Directory without fully deleting it, and stores it in a list of Archived Spaces.

スマート値

• {space}

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

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

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

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

AI アクション

Use AI to generate smart values for your rule. AI summaries and action items can be generated each time a rule is run or you can add them to other actions within the rule. They are are not saved for future use.

You can also add an AI condition to help define which content is subject to your rule.

AI で要約する

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

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

スマート値

• {generatedAISummary}

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

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

例: ページが公開されたときにチームメイトが @メンションされると、そのチームメイトに対して AI アクション アイテムが生成され、Slack で通知されます。

スマート値

• {generatedAIActionItems}

AI でラベルを追加

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

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

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

Rovo エージェントを使用する

This action prompts an agent of your choosing on your behalf to generate a response. It must be coupled with a secondary action with text-based output, like Add comment, to direct the response to.

When setting up this action, you provide a prompt describing what the agent should analyze. For example:

このページのコンテンツを確認して、推奨事項を提示してください。

スマート値

• {agentResponse}

ルックアップ アクション

Lookup actions work similarly to branches. They let you find a specific set of objects and then use that set as a smart value in your rule.

たとえば、特定のユーザーが 6 か月よりも前に作成したページにのみルールを実行するように設定することができます。佐藤氏の 6 か月よりも前のページが 200 ページあるとします。ルックアップ アクションなしでルールを作成すると、佐藤氏は 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. Create an incoming webhook for Microsoft Teams

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

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

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

Learn more about using automation with Microsoft Teams.

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

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

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

1. Create an incoming webhook for Slack

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

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

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

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

Learn more about using automation with Slack.

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

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

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

Web リクエストを送信

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

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

Advanced

変数の作成

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

ログ アクション

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