Confluence 自動化のアクション

Flows always end with an action step. Actions are what you want the flow to do, that is, what you want to happen if it executes successfully.

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.

When this flow runs, it is transfering ownership on your behalf — as the admin who created the flow.

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

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

Content statuses are specific to each space. So, if you’re in Global Automation, the action can’t provide status selections until you set and save the flow’s Scope (in flow details) to a specific space or spaces. Once the scope is saved, both Suggested and Custom statuses will surface as options.

スマート値

• {priorContentStatus}

ページをコピーする

This action publishes a copy of an existing page in a designated location. The flow's trigger often defines the page that gets copied. (So, for example, if the trigger is “when a page is edited”, the edited page is the page that gets copied.)

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

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

スマート値

• {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 flow. AI summaries and action items can be generated each time a flow is run or you can add them to other actions within the flow. They are are not saved for future use.

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

AI で要約する

This action uses AI to generate a summary from text. This summary is stored in the {{generatedAISummary}} smart value for the duration of the flow execution.

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

スマート値

• {generatedAISummary}

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

This action generates an AI-based list of action items from text you pass to it. These action items are stored in the {{generatedAIActionItems}} smart value for the duration of the flow’s execution.

例: ページが公開されたときにチームメイトが @メンションされると、そのチームメイトに対して 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 flow.

For example, you could set your flow to run only on pages created by a certain person more than six months ago. Let’s say that Sarah has 200 pages from more than six months ago. Building a flow without a lookup action would result in Sarah receiving one email per page. By adding Lookup pages to your flow, she will receive just one email referring to all pages.

ページの検索

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

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

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

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

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

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

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

スマート値

• {lookupPages}

• {lookupPagesPerOwner}

• {lookupPagesPerAuthor}

Jira アクション

These actions allow you to connect Confluence automation and Jira, so that a flow triggered in Confluence can make something happen in Jira.

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

Jira の作業項目

Jira で作業項目を作成する

このアクションにより、Jira スペースに新しい作業項目が作成されます。

For example, you could create a flow that says when a page is published in a particular Confluence space, create a task to review it in a corresponding Jira space.

To configure the Jira work item step:

1. Select the Jira space you’d like the flow to add an work item to.

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

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

   1. (When the flows runs, a Summary ID number will automatically be added to keep the name unique.)

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

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

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

When the work item is viewed in Jira, the person who created the flow will be listed as the Reporter.

Jira で作業項目をトランジションする

このアクションは Jira 作業項目のステータスを変更します。

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

• Copy from work item: copies the status from related work items or a work item on a branch flow.

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

• エピックからコピー: 作業項目に関連するエピックからステータスをコピーします。

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

Jira で作業項目を編集する

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

Jira Service Management のインシデント

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

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

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

一般アクション

通知

メールを送信

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

To configure the email step:

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

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

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

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

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

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

To configure the Microsoft Teams step:

1. Create an incoming webhook for Microsoft Teams

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

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

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

Learn more about using automation with Microsoft Teams.

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

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

To configure the Slack step:

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 リクエストを送信

This action sends an outgoing web request to notify another system when a flow is run. You can set this action to return response data that can then be used in a subsequent action.

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

Advanced

変数の作成

Define your own smart value, which can be used in other actions and conditions in the same flow. The smart value you define can consist of other smart values, as well as math functions.

ログ アクション

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