Confluence 自動化の条件

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

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

For example, let's imagine your rule is set to trigger when a new page is published. You could add a User condition so the rule only runs if the page was published by a specific person.

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

Confluence 条件

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

ユーザー

If you add a User condition, your rule only runs when it’s triggered by certain users or groups.

For example, let's imagine your rule is set to trigger when a new page is published. You could add a User condition so the rule only runs if the page was published by a specific person.

同じフィールドに複数のユーザーまたはグループを追加すると、いずれかのユーザーまたはグループ (つまり、ユーザーが Person 1、Person 2、Person 3 のいずれか) によってトリガーされた際にルールが実行されます。

 

CQL

If you add a CQL condition, your rule only runs when the trigger meets parameters you define in a query (using Confluence Querying Language [CQL]).

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

The CQL condition is a way to create a custom condition using any object type that you want.

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

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 クエリを作成できます。

Below are some examples of common CQL queries to provide contextual starting points for different objects. To learn more about how to construct your own queries, see Advanced searching using 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.

For example, if your rule is set to trigger when a new page is published, you could add an AI condition so the rule only runs if the page’s body relates to “meeting notes”.

Premium プランと Enterprise プランのすべての製品で Atlassian Intelligence の利用が可能になり、自動的に有効化されるようになりました。組織管理者は、アトラシアンの管理の [設定] > [Atlassian Intelligence] から Atlassian Intelligence の設定を管理できます。

管理者が Atlassian Intelligence をオフにしている場合、AI コンポーネントを使用するルールは実行されません。

Atlassian Intelligence の仕組み、制限、およびプライバシーに対する当社の取り組みの詳細については、Atlassian Trust Center をご確認ください。

Analytics

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

ページ条件

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

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

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

  • Total views: equal to, less than, or more than a specified number

  • Total edits: equal to, less than, or more than a specified number

  • Total comments: equal to, less than, or more than a specified number

  • Page title: contains or doesn’t contain a specified text string

  • Labels: Contains or doesn’t contain one or more specified label

  • Status: Page status is one of the statuses configured for the page’s space

一般条件

If you’ve used automation for Jira, you’ll recognize some of the same general conditions like Advanced compare. You’ll configure them in a similar way, but they won’t currently function across products. This is on our roadmap.

{スマート値} 条件

This condition is considered advanced because it requires the use of Confluence smart values or regular expressions.

If you add a {{smart values}} condition, your rule only runs when it’s triggered by a certain state as defined by comparing either a smart value or a regular expression in the first field – to criteria you define in the second field.

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

The {{smart values}} condition is a way to create a custom condition using dynamic variables.

 

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.

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

The If/else block condition isn’t compatible with branch components.

どちらもルールのパスを分割しますが、逆の機能を果たします。If/else 条件は片方のパスまたはもう 1 つのパスのいずれかを、ブランチは複数のパスを同時に実行します。

You therefore won’t see If/else block as an option when you add a condition to a branch.

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。