Confluence 自動化のブランチ

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

ブランチを追加したあとには必ず、次に条件またはアクションを追加するように求められます (ブランチはネストしないため、別のブランチは追加できません)。

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

Confluence ブランチ

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

For each ____ ブランチは、それに続く条件および/またはアクションを、設定した基準を満たす for each オブジェクトに適用します。

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

ページ ブランチ

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

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

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

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

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

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

スマート値

• {{content}}

• {{page}}

• {{pagesPerOwner}}

• {{pagesPerAuthor}}

• {{isBranch}}

For each inactive page

For each inactive page ブランチは、選択した基準と一致する 1000 ページに対して条件またはアクションを実行します。「inactive page (非アクティブページ)」とは、指定された期間に閲覧されていないページのことです。閲覧履歴には、ページの更新やコメントが含まれます。

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

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

スマート値

• {{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}}

ゲスト ユーザー ブランチ

ゲスト ユーザーとは、1 つのスペースのみにアクセスできるアカウントを指します。有料ライセンスの総数にはカウントされません。

スマート値

• {{user}}

• {{unasignedGuestUsers}}

タスク ブランチ

タスクは、メンションまたはそれ以外の方法によって個人またはチームに割り当てられたアクション アイテムです。

タスク ブランチは、設定した基準を満たす最大 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}} *

• {{cqlResult}}

• {{blogpost}} *

• {{content}} *

• {{whiteboard}} *

• {{database}}*

• {{smartlink}} *

• {{comment}} *

• {{attachment}} *

• {{space}} *

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

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

CQL (別名「句」) の単純なクエリは、フィールド、演算子、1 つ以上の値または関数の順で構成されています。

たとえば、次の単純なクエリは「TEST」スペース内のすべての内容を検索します。スペース フィールド、EQUALS 演算子、テキスト値の語 ("Test") を使用します。CQL で使用する語は大小文字を区別しません。

2 つ以上の句をキーワード (OR、ANDなど) で結合して、より複雑な CQL クエリを作成できます。

次は、さまざまなオブジェクトのコンテキストを知る手がかりとなる一般的な CQL クエリの例です。独自のクエリを作成する方法については「CQL による高度な検索」をご参照ください。

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

ページごと...

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

  1 title ~ "meeting minutes"

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

  1 type = Page AND macro = cqlnavigation

   

ブログ投稿ごと...

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

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

   

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

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

コメントごと...

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

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

   

添付ファイルごと...

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

  1 type = Attachment AND title ~ "screenshot"

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

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

   

Jira ブランチ

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

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

関連する課題

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

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

JQL クエリの構築方法に関する詳細をご確認ください。

一般ブランチ

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

一般ブランチとは、すべてのアトラシアン製品で機能する自動化ルールで使用できるブランチです。