Confluence 自動化の条件
条件は、ルールのスコープを制限するオプションのコンポーネントです。
ルールを引き続き実行するには、指定した条件が満たされている (つまり「合格する」) 必要があります。
たとえば、新しいページが公開された際にルールがトリガーされるように設定されているとします。[ユーザー] 条件を追加して、このページが特定のユーザーによって公開された場合にのみルールが実行されるようにできます。
生成するルールがより複雑になっていくと、ルール要約の複数箇所に条件を追加する場合があります。それぞれの条件は、その後に続くものにのみ影響します。条件が満たされない場合、それに続くアクションは実行されません。
Confluence 条件
これらの条件は Confluence 自動化に固有のもので、個々のスペースを自動化する (スペースの自動化) ため、または複数のスペースを一度に自動化する (グローバル自動化) ために利用できます。
ユーザー
[ユーザー] 条件を追加すると、特定のユーザーまたはグループによってトリガーされた際にのみルールが実行されます。
たとえば、新しいページが公開された際にルールがトリガーされるように設定されているとします。[ユーザー] 条件を追加して、このページが特定のユーザーによって公開された場合にのみルールが実行されるようにできます。
同じフィールドに複数のユーザーまたはグループを追加すると、いずれかのユーザーまたはグループ (つまり、ユーザーが Person 1、Person 2、Person 3 のいずれか) によってトリガーされた際にルールが実行されます。
CQL
CQL 条件を追加すると、トリガーがクエリで定義したパラメーターを満たすときにのみ、ルールが実行されます (Confluence クエリ言語 [CQL] を使用)。
Jira の JQL や IQL のように、CQL によって Confluence で高度な検索を実行できます。
[CQL] 条件は、任意のオブジェクト タイプによってカスタム条件を作成する方法です。
カスタム クエリを作成する
CQL (別名「句」) の単純なクエリは、フィールド、演算子、1 つ以上の値または関数の順で構成されています。
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.
space = "TEST"
2 つ以上の句をキーワード (OR、ANDなど) で結合して、より複雑な CQL クエリを作成できます。
次は、さまざまなオブジェクトのコンテキストを知る手がかりとなる一般的な CQL クエリの例です。独自のクエリを作成する方法については「CQL による高度な検索」をご参照ください。
クエリの例 (オブジェクト タイプ別)
もしこのページ...
...のタイトルに同じ語 (または句) が含まれていれば
title ~ "meeting minutes"
...に特定の Confluence マクロが使用されていれば
type = Page AND macro = cqlnavigation
もしブログ投稿...
...が先月に作成されていれば
type = blogpost AND created > startOfMonth("-1M") AND created < startOfMonth()
もしコメント...
...が過去 1 週間に (特定のユーザーとして) 自分が書いたものであれば
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"
AI(Atlassian Intelligence)
An Atlassian Intelligence condition lets you trigger your rule only when the trigger relates to a phrase you provide. This condition always pulls from the current state of the {{content}} smart value and can act on its body or title.
たとえば、新しいページが公開されたときにルールがトリガーされるように設定されている場合は、AI 条件を追加して、ページの本文が「ミーティング議事録」に関連する場合にのみルールが実行されるようにすることができます。
Premium プランと Enterprise プランのすべての製品で Atlassian Intelligence の利用が可能になり、自動的に有効化されるようになりました。組織管理者は、アトラシアンの管理の [設定] > [Atlassian Intelligence] から Atlassian Intelligence の設定を管理できます。
管理者が Atlassian Intelligence をオフにしている場合、AI コンポーネントを使用するルールは実行されません。
Atlassian Intelligence の仕組み、制限、およびプライバシーに対する当社の取り組みの詳細については、Atlassian Trust Center をご確認ください。
Analytics
分析条件によって、ルールがトリガーされるかどうかを制御する 1 つ以上の条件を設定できます。
ページ条件
ページ条件は、値を指定されたページ統計と比較します。
AND/OR ロジックでリンクされた基準を最大 5 つ選択します。
条件の基準は次のとおりです。
合計表示回数: 指定した数と等しい、指定した数より小さい、または指定した数を超える
編集総数: 指定した数と等しい、指定した数より小さい、または指定した数を超える
コメントの合計: 指定した数と等しい、指定した数より小さい、または指定した数を超える
ページ タイトル: 指定されたテキスト文字列が含まれる、または含まれない
ラベル: 指定された 1 つ以上のラベルを含む、または含まない
ステータス: ページ ステータスが、そのページのスペースに設定されているステータスの 1 つである
一般条件
Automation for Jira をご利用の場合は、[詳細な比較] など、同じ一般トリガーがいくつかあることにお気付きになるでしょう。設定方法はよく似ていますが、現在、異なる製品間では機能しません。本件はロードマップには記載されています。
{スマート値} 条件
Confluence のスマート値または正規表現が必要であるため、この条件は詳細な条件と見なされます。
{{smart values}} 条件を追加した場合は、最初のフィールドにあるスマート値または正規表現のいずれかを 2 番目のフィールドで定義した条件と比較することによって定義された特定の状態によってトリガーされた際にのみ、ルールが実行されます。
中央のドロップダウンによって基準の要件を指定します。
{{smart values}} 条件は、動的変数によってカスタム条件を作成する方法です。
If/else ブロック
The If/else block component is an exception. It isn’t a condition – it's a way to define a choice of two conditions at the same point in your rule chain. By splitting the path into two “if/else” conditions, the rule can lead to one of two different outcomes.
これは、アドベンチャー ゲーム ブックや道路の分岐に少し似ています。この条件が満たされた場合はこのシーケンスが実行されて、そうでない場合は他の条件が満たされて、他のシーケンスが実行されます (どちらの条件も満たされない場合は、ルールは続行されなくなります)。
If/else ブロック条件はブランチ コンポーネントと互換性がありません。
どちらもルールのパスを分割しますが、逆の機能を果たします。If/else 条件は片方のパスまたはもう 1 つのパスのいずれかを、ブランチは複数のパスを同時に実行します。
したがって、条件をブランチに追加する際に、If/else ブロックはオプションとして表示されません。
この内容はお役に立ちましたか?