Confluence 自動化のブランチ

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

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

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

Confluence ブランチ

Confluence の自動化では、ブランチは常に “For each” [object] のような形式を取ります。

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

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

For each page

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

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

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

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

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

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

スマート値

• {{content}}

• {{page}}

• {{isBranch}}

For each inactive page

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

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

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

スマート値

• {{content}}

• {{page}}

• {{isBranch}}

• {{inactivePages}}

タスクごと

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

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

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

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

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

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

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

スマート値

• {{task}}

• {{isBranch}}

• {{page}} *

• {{blogpost}} *

• {{content}}

• {{space}}

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

CQL 結果ごと (関連エンティティ)

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

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

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

スマート値

• {{isBranch}}

• {{cqlResult}}

• {{page}} *

• {{blogpost}} *

• {{content}} *

• {{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()

   

コメントごと...

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

  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 Software を接続して、Confluence でトリガーされたルールの条件とアクションを既存の Jira 課題に適用できるようになります。

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

JQL 結果ごと (関連する課題)

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

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

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

一般ブランチ

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

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