Confluence 自動化の条件

条件は、ルールのスコープを制限するオプションのコンポーネントです。

ルールを引き続き実行するには、指定した条件が満たされている (つまり「合格する」) 必要があります。

たとえば、新しいページが公開された際にルールがトリガーされるように設定されているとします。[ユーザー] 条件を追加して、このページが特定のユーザーによって公開された場合にのみルールが実行されるようにできます。

生成するルールがより複雑になっていくと、ルール要約の複数箇所に条件を追加する場合があります。それぞれの条件は、その後に続くものにのみ影響します。条件が満たされない場合、それに続くアクションは実行されません。

Confluence 条件

これらの条件は Confluence 自動化に固有のもので、個々のスペースを自動化する (スペースの自動化) ため、または複数のスペースを一度に自動化する (グローバル自動化) ために利用できます。

ユーザー

[ユーザー] 条件を追加すると、特定のユーザーまたはグループによってトリガーされた際にのみルールが実行されます。

たとえば、新しいページが公開された際にルールがトリガーされるように設定されているとします。[ユーザー] 条件を追加して、このページが特定のユーザーによって公開された場合にのみルールが実行されるようにできます。

CQL

CQL 条件を追加すると、トリガーがクエリで定義したパラメーターを満たすときにのみ、ルールが実行されます (Confluence クエリ言語 [CQL] を使用)。

Jira の JQL や IQL のように、CQL によって Confluence で高度な検索を実行できます。

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

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 週間に (特定のユーザーとして) 自分が書いたものであれば

  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"

AI（Atlassian Intelligence）

Atlassian Intelligence 条件を使用すると、指定したフレーズにトリガーが関連している場合にのみ、ルールをトリガーできます。この条件は常に {{content}} スマート値の現在の状態から取得されて、本文またはタイトルに作用します。

たとえば、新しいページが公開されたときにルールがトリガーされるように設定されている場合は、AI 条件を追加して、ページの本文が「ミーティング議事録」に関連する場合にのみルールが実行されるようにすることができます。

Analytics

分析条件によって、ルールがトリガーされるかどうかを制御する 1 つ以上の条件を設定できます。

ページ条件

ページ条件は、値を指定されたページ統計と比較します。

AND/OR ロジックでリンクされた基準を最大 5 つ選択します。

条件の基準は次のとおりです。

• 合計表示回数: 指定した数と等しい、指定した数より小さい、または指定した数を超える

• 編集総数: 指定した数と等しい、指定した数より小さい、または指定した数を超える

• コメントの合計: 指定した数と等しい、指定した数より小さい、または指定した数を超える

• ページ タイトル: 指定されたテキスト文字列が含まれる、または含まれない

• ラベル： 指定された 1 つ以上のラベルを含む、または含まない

• ステータス： ページ ステータスが、そのページのスペースに設定されているステータスの 1 つである

一般条件

{スマート値} 条件

Confluence のスマート値または正規表現が必要であるため、この条件は詳細な条件と見なされます。

{smart values} 条件を追加した場合は、最初のフィールドにあるスマート値または正規表現のいずれかを、2 番目のフィールドで定義した条件と比較して定義された特定の状態によってトリガーされた場合にのみ、ルールが実行されます。

中央のドロップダウンによって基準の要件を指定します。

If/else ブロック

If/else ブロック コンポーネントは例外です。これは条件ではなく、ルール チェーンの同一ポイントで 2 つの条件を選択するように定義する方法です。パスを 2 つの「if/else」条件に分割することで、ルールは 2 つの異なる結果のいずれかに進めます。

これは、アドベンチャー ゲーム ブックや道路の分岐に少し似ています。この条件が満たされた場合はこのシーケンスが実行されて、そうでない場合は他の条件が満たされて、他のシーケンスが実行されます (どちらの条件も満たされない場合は、ルールは続行されなくなります)。