自動化の基本
Atlassian Cloud 製品における自動化の一般的なコンセプトとベスト プラクティスを説明します。
Confluence 自動化のブランチ
自動化は、Confluence Premium と Enterprise で利用できる管理機能です。
ブランチは、ルールの実行を拡張するオプションのコンポーネントです。ブランチが追加されるとルールは順番に実行されなくなりますが、代わりに (複数のアクションを実行できる) 複数のパスに拡張されます。
このコンポーネント タイプについて詳しくは、「ルール分岐とは？」をご参照ください。
ブランチを追加したあとには必ず、次に条件またはアクションを追加するように求められます (ブランチはネストしないため、別のブランチは追加できません)。
追加する条件および/またはアクションは、ルール チェーンのブランチ部分にのみ適用されます。
If/else ブロック条件はブランチ コンポーネントと互換性がありません。
その理由は、これらが逆の機能を果たすためです。If/else ブロック条件は、片方のパスまたはもう 1 つのパスのいずれかを実行します。一方、ブランチは複数のパスを同時に実行します。
したがって、条件コンポーネントをブランチに追加する際に、オプションとして If/else ブロックは表示されません。
Confluence ブランチ
In Confluence automation, some branches are built in a “For each” [object] format.
For each ____ ブランチは、それに続く条件および/またはアクションを、設定した基準を満たす for each オブジェクトに適用します。
たとえば、3 日後が期限 (設定した基準) の各タスク (for each task) (オブジェクト) に同じアクションを適用できます。
Confluence branches can perform actions on up to 1,000 pages, tasks, etc at a time. If the limit is reached, the rule will stop running even if there are more items that meet the rule’s criteria. This helps to maintain performance.
その他の自動化制限については、こちらをご覧ください。
Page branch
A Page branch applies the same condition and/or action on up to 1,000 pages that meet the criteria you set.
The page branch doesn’t include blog posts, whiteboards, or databases. To create a custom branch for another content type, use a related entities branch and select a type.
設定できる基準には次が含まれます。
作成者: 最初にページを公開したユーザー。
公開日: ページが最初に公開された日時。
更新日: ページが最後に編集された日時。
A Page branch will default to the Author criteria module. Select the X to remove it. Select Add more criteria to add different (or additional) criteria including the date published (created) or updated (edited).
スマート値
{{content}}
{{page}}
{{isBranch}}
For each inactive page
A For each inactive page branch executes a condition or action on 1,000 pages that align with the criteria you select. An inactive page is any page that has not been viewed in the specified time period. The view history includes updates and comments made to the page.
設定できる基準には次が含まれます。
過去の日数、週数、または月数。
スマート値
{{content}}
{{page}}
{{isBranch}}
{{inactivePages}}
For each page owned by a deactivated account
A For each page owned by a deactivated account branch executes a condition or action on 1,000 pages owned by someone who no longer has Confluence access.
このブランチを使用するときは、スペースを選択する必要があります。
Task branch
タスクは、メンションまたはそれ以外の方法によって個人またはチームに割り当てられたアクション アイテムです。
A task branch applies the same condition and/or action on up to 1,000 tasks that meet the criteria you set.
A task branch will look at all tasks in the associated space (Space automation) or spaces (Global automation).
このため、これは通常 スケジュール済みトリガーと組み合わせてスペース レベルのタスク監査を実行するために使用されます。ルール テンプレートの「予定されたときに未完了のタスクについてチームメイトに通知」で利用例を示しています。
設定できる基準には次が含まれます。
担当者: タスクが割り当てられているユーザー。
期限: 期限がいつか (また、期限が過ぎているかどうか)。
ステータス: タスクのステータスが完了か未完了か。
A task branch will default to the Status criteria module. Select the X to remove it. Select Add more criteria to add different (or additional) criteria including Assignee or Due date.
スマート値
{{task}}
{{isBranch}}
{{page}} *
{{blogpost}} *
{{content}}
{{space}}
*- これらのスマート値があるかどうかは、それがページのブランチかブログ投稿のブランチかによって異なります。
このコンポーネントは、ブランチの前にコンテンツとスペースのスマート値をクリアします。スマート値の詳細については、「Confluence 自動化のスマート値」を参照してください。
Related entities
CQL とは Confluence クエリ言語の略で、Jira の JQL や IQL のように Confluence で高度な検索を実行するために使用できます。
A related entities branch applies the same condition or action on up to 1,000 of the same object as defined by your query.
これは、任意のオブジェクト タイプを使用してカスタムの “For each” ブランチを作成する方法です。
スマート値
{{isBranch}}
{{cqlResult}}
{{page}} *
{{blogpost}} *
{{content}} *
{{whiteboard}} *
{{database}}*
{{smartlink}} *
{{comment}} *
{{attachment}} *
{{space}} *
*- これらのスマート値があるかどうかは、ブランチがページ、ブログ投稿、コメント、添付ファイル、スペースのどれから派生したかによって異なります。
このコンポーネントは、ブランチの前にコンテンツとスペースのスマート値をクリアします。スマート値の詳細については、「Confluence 自動化のスマート値」を参照してください。
カスタム クエリを作成する
CQL (別名「句」) の単純なクエリは、フィールド、演算子、1 つ以上の値または関数の順で構成されています。
たとえば、次の単純なクエリは「TEST」スペース内のすべての内容を検索します。スペース フィールド、EQUALS 演算子、テキスト値の語 ("Test") を使用します。CQL で使用する語は大小文字を区別しません。
1
space = "TEST"2 つ以上の句をキーワード (OR、ANDなど) で結合して、より複雑な CQL クエリを作成できます。
次は、さまざまなオブジェクトのコンテキストを知る手がかりとなる一般的な CQL クエリの例です。独自のクエリを作成する方法については「CQL による高度な検索」をご参照ください。
クエリの例 (オブジェクト タイプ別)
ページごと...
...タイトルに同じ語 (または句) が含まれている
1title ~ "meeting minutes"
... 同じ Confluence マクロを使用する
1type = Page AND macro = cqlnavigation
ブログ投稿ごと...
... 先月に作成された
1type = blogpost AND created > startOfMonth("-1M") AND created < startOfMonth()
スマート リンクごと...
…特定のユーザー (アカウント ID 別) によって作成された課題
1
type = smartlink AND creator = "99:27935d01-XXXX-XXXX-XXXX-a9b8d3b2ae2e" コメントごと...
... 自分が (特定のユーザーとして) 先週書いた
1type = comment AND creator = currentUser() AND created > startOfDay("-1w") order by created desc
添付ファイルごと...
... 名前に同じ語 (または句) が含まれている
1type = Attachment AND title ~ "screenshot"
... 特定の語 (または句) を含む PDF
1type = attachment AND title ~ "pdf" AND text ~ "confluence"
Jira ブランチ
これらのブランチを使用すると、Confluence 自動化と Jira を接続して、Confluence でトリガーされたルールの条件とアクションを既存の Jira 課題に適用できるようになります。
Jira ブランチはスペースの自動化とグローバル自動化の両方で使用できます。
Jira ブランチには接続が必要です。自動化ルールを Jira インスタンスに接続するのは、ソーシャル メディア アプリに写真へのアクセス権限を与えるようなものです。
ルール ビルダーで Jira ブランチを選択すると、それらを接続するよう求められます。
Jira branches can perform actions on up to 1,000 issues at a time. If the limit is reached, the rule will stop running even if there are more issues that meet the rule’s criteria. This helps to maintain performance.
その他の自動化制限については、こちらをご覧ください。
関連する課題
JQL とは Jira クエリ言語の略です。Confluence の CQL と同様に、Jira で高度な検索を実行するために使用できます。
A related issues branch applies the same condition or action on up to 1000 issues as defined by your query. This is a way to create a custom Jira issue branch using any criteria you want.
Jira のブランチに関する詳細は、「関連する課題にアクションを実行するために自動化ルールのブランチを作成する」をご確認ください。
一般ブランチ
Confluence には一般ブランチ コンポーネントはありません。
一般ブランチとは、すべてのアトラシアン製品で機能する自動化ルールで使用できるブランチです。
この内容はお役に立ちましたか?
さらにヘルプが必要ですか?
アトラシアン コミュニティをご利用ください。