Confluence 自動化のブランチ

ブランチは、ルールの実行を拡張するオプションのコンポーネントです。ブランチが追加されるとルールは順番に実行されなくなりますが、代わりに (複数のアクションを実行できる) 複数のパスに拡張されます。

After you add a branch, you’ll always be prompted to add a condition or an action next. (You can’t add another branch because branches don’t nest.)

追加する条件および/またはアクションは、ルール チェーンのブランチ部分にのみ適用されます。

Confluence ブランチ

Confluence 自動化では、一部のブランチは "For each" [オブジェクト] 形式で構築されています。

A For each ____ branch applies the condition and/or action that follows it, for each object that meets the criteria you set.

たとえば、3 日後が期限 (設定した基準) の各タスク (for each task) (オブジェクト) に同じアクションを適用できます。

ページ ブランチ

ページ ブランチは、設定した基準を満たす最大 1000 ページに対して、同じ条件および/またはアクションを適用します。

設定できる基準には次が含まれます。

• 作成者: 最初にページを公開したユーザー。

• 公開日: ページが最初に公開された日時。

• 更新日: ページが最後に編集された日時。

ページ ブランチの初期設定が作成者基準モジュールになります。削除するには [X] を選択します。公開日 (作成日) や更新日 (編集日) など、異なる (または追加の) 条件を追加するには、[さらに条件を追加] を選択します。

スマート値

• {content}

• {page}

• {pagesPerOwner}

• {pagesPerAuthor}

• {isBranch}

For each inactive page

A For each inactive page branch executes a condition or action on 1,000 pages that align with the criteria you select. An inactive page is any page that has not had activity in the specified time period. Activity includes:

• page creates

• page deletes

• page updates

• page views

• page moves to another space

• comments created

• comments updated

• attachments created

• attachments updated

Activity on a child page will also count towards activity on the parent page. Archived pages are not scanned for activity.

設定できる基準には次が含まれます。

• 過去の日数、週数、または月数。

スマート値

• {content}

• {page}

• {isBranch}

• {inactivePages}

• {inactivePagesPerOwner}

• {inactivePagesPerAuthor}

For each page owned by a deactivated account

For each page owned by a deactivated account ブランチは、Confluence にアクセスできなくなったユーザーが所有する 1000 ページに対して条件またはアクションを実行します。

このブランチを使用するときは、スペースを選択する必要があります。

スマート値

• {content}

• {page}

• {deactivatedOwnerPages}

ゲスト ユーザー ブランチ

Guest users are accounts with access to a single space. They do not count against your total number of paid licenses.

スマート値

• {user}

• {unasignedGuestUsers}

タスク ブランチ

Tasks are action items that may or may not have been assigned to a person or team by mentioning them.

タスク ブランチは、設定した基準を満たす最大 1000 個のタスクに同じ条件および/またはアクションを適用します。

設定できる基準には次が含まれます。

• 担当者: タスクが割り当てられているユーザー。

• 期限: 期限がいつか (また、期限が過ぎているかどうか)。

• ステータス: タスクのステータスが完了か未完了か。

タスク ブランチの初期設定がステータス基準モジュールになります。削除するには [X] を選択します。担当者や期限など、異なる (または追加の) 条件を追加するには、[さらに条件を追加] を選択します。

スマート値

• {task}

• {isBranch}

• {page} *

• {blogpost} *

• {content}

• {space}

• {tasksPerAssignee}

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

関連エンティティ

CQL とは Confluence クエリ言語の略で、Jira の JQL や IQL のように Confluence で高度な検索を実行するために使用できます。

関連エンティティ ブランチは、クエリで定義されてるものと一致する最大 1000 個のオブジェクトに、同じ条件またはアクションを適用します。

これは、任意のオブジェクト タイプを使用してカスタムの “For each” ブランチを作成する方法です。

スマート値

• {isBranch}

• {cqlResult}

  • {cqlResult.id}

  • {cqlResult.state}

  • {cqlResult.title}

  • {cqlResult.type}{page} *

• {cqlResults}

• {blogpost} *

• {content} *

• {whiteboard} *

• {database}*

• {smartlink} *

• {comment} *

• {attachment} *

• {space} *

*- これらのスマート値があるかどうかは、ブランチがページ、ブログ投稿、コメント、添付ファイル、スペースのどれから派生したかによって異なります。

カスタム クエリを作成する

A simple query in CQL (also known as a 'clause') consists of a field, followed by an operator, followed by one or more values or functions.

For example, the following simple query will find all content in the "TEST" space. It uses the Space field, the EQUALS operator, and a text value term ("Test".) CQL terms are not case sensitive.

You can join two or more clauses with keywords (like OR, AND) to form a more complex CQL query.

Below are some examples of common CQL queries to provide contextual starting points for different objects. To learn more about how to construct your own queries, see Advanced searching using CQL.

クエリの例 (オブジェクト タイプ別)

ページごと...

• ...タイトルに同じ語 (または句) が含まれている

  title ~ "meeting minutes"

• ... 同じ Confluence マクロを使用する

  type = Page AND macro = cqlnavigation

   

ブログ投稿ごと...

• ... 先月に作成された

  type = blogpost AND created > startOfMonth("-1M") AND created < startOfMonth()

   

スマート リンクごと...

• …特定のユーザー (アカウント ID 別) によって作成された課題

コメントごと...

• ... 自分が (特定のユーザーとして) 先週書いた

  type = comment AND creator = currentUser() AND created > startOfDay("-1w") order by created desc

   

添付ファイルごと...

• ... 名前に同じ語 (または句) が含まれている

  type = Attachment AND title ~ "screenshot"

• ... 特定の語 (または句) を含む PDF

  type = attachment AND title ~ "pdf" AND text ~ "confluence"

   

Jira ブランチ

これらのブランチを使用すると、Confluence 自動化と Jira を接続して、Confluence でトリガーされたルールの条件とアクションを既存の Jira 作業項目に適用できるようになります。

Jira ブランチはスペースの自動化とグローバル自動化の両方で使用できます。

関連作業項目

JQL とは Jira クエリ言語の略です。Confluence の CQL と同様に、Jira で高度な検索を実行するために使用できます。

関連作業項目ブランチは、クエリで定義されている最大 1000 個の作業項目に同じ条件またはアクションを適用します。この方法で、任意の基準を使用してカスタムの Jira 課題ブランチを作成できます。

Read more about how to construct JQL queries.

高度なブランチ

同時にブランチを作成

自動化ルール コンポーネントの複数のグループが、同時に実行できます。このコンポーネントは、異なるタスクを同時に実行する必要があるが、互いに依存していない場合に使用します。

一般ブランチ

Confluence には一般ブランチ コンポーネントはありません。

一般ブランチとは、すべての Atlassian アプリで機能する自動化ルールで使用できるブランチです。