Confluence 自動化のブランチ

ステータス: アーリー アクセス ** 新規参加者は利用不可 **

Automation は、アーリー アクセス プログラムにサインアップした限られた数の Confluence 顧客が利用できます。サインアップは締め切られましたが、Automation コミュニティ ページで最新情報をウォッチしてください。

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

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

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

If/else ブロック条件はブランチ コンポーネントと互換性がありません。

その理由は、これらが逆の機能を果たすためです。If/else ブロック条件は、片方のパスまたはもう 1 つのパスのいずれかを実行します。一方、ブランチは複数のパスを同時に実行します。

したがって、条件コンポーネントをブランチに追加する際に、オプションとして If/else ブロックは表示されません。

Confluence ブランチ

Confluence 自動化では、ブランチは常に「~ごと」という形にオブジェクトのタイプを加えたものです。[ごと] ブランチは、設定した条件を満たすオブジェクト タイプごとに、それに続くすべての条件またはアクションを適用します。

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

タスクごと

タスクは、メンションすることによって個人またはチームに割り当てられたアクション アイテムです。

[タスクごと] ブランチは、設定した条件を満たす各タスクに同じ条件またはアクションを適用します。

一部のコンポーネントとは異なり、[タスクごと] はトリガーを変更しません。このブランチのスコープは、関連するスペース (スペースの自動化) またはスペース (グローバル自動化) のすべてのタスクを参照します。

このため、これは通常 [スケジュール設定済み] トリガーと組み合わせてスペース レベルのタスク監査を実行するために使用されます。ルール テンプレートの「期限が迫っている未完了のタスクをユーザーに通知する」で利用例を示しています。

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

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

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

  • 担当者: どのユーザー (またはグループ) がタスクに割り当てられているか。

[タスクごと] は、ステータス基準モジュールの初期設定になります。削除するには [X] を選択します。[フィルターを追加] を選択して、[担当者] や [期限日] などの異なる (または追加の) 基準を追加します。

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

[CQL の結果ごと] ブランチは、クエリで定義されたオブジェクトごとに、常に後続の条件またはアクションを適用します。

これは、任意のオブジェクト タイプによってカスタムの「~ごと」ブランチを作成する方法です。

[CQL の結果ごと] はトリガーを変更します。このブランチが正しく機能するためには、CQL クエリがルールのトリガーのオブジェクトに関連している必要があります。

 

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

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

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

1 space = "TEST"

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"

     

一般ブランチ

Confluence には、他の製品と共通した一般ブランチ コンポーネントはありません。

その他のヘルプ