自動化の基本
Atlassian Cloud 製品における自動化の一般的なコンセプトとベスト プラクティスを説明します。
Jira Automation テンプレート ライブラリでスマート バリューを使用する方法をご確認ください。
以下のスマート バリューを利用して、ルール設定時にユーザー データにアクセスし、形式を設定できます。
次のプロパティはすべてのユーザー向けスマート バリューでアクセス可能です。
accountId: Jira によって設定されるユーザーの一意の ID。この ID は変更できません。ユーザー名をユーザー アカウント ID に変換する方法の詳細をご確認ください。
active: ユーザー アカウントがアクティブかどうか
avatarUrls: サイズが 16x16、24x24、32x32、48x48 のユーザー アバターにアクセスできます
displayName: ユーザーのプロファイル内の氏名
emailAddress: ユーザーのプロファイルに記載されているメール アドレス
タイムゾーン: Atlassian Cloud サイトの既定のタイムゾーン。
プロファイル情報にアクセスできない場合、スマート値は値を返しません。たとえば、ユーザーのメール アドレスの表示設定が [プロファイルとその公開範囲] で [自分と管理者のみ] に設定されている場合、emailAddress スマート値は値を返しません。
1
2
3
4
5
6
{{creator.displayName}}
{{comment.author.displayName}}
{{reporter.emailAddress}}
{{assignee.timeZone}}
{{assignee.accountId}}
{{assignee.avatarUrls."48x48"}}
アクティブな課題の担当者です。
1
{{assignee.displayName}}
課題にコメントを追加するユーザー。
1
{{comment.author.displayName}}
アクティブな課題の作成者。課題の作成者は変更できません。
1
{{creator.displayName}}
ルールをトリガーしたユーザー。
1
2
3
4
5
{{initiator.displayName}}
{{initiator.emailAddress}}
{{initiator.accountId}}
{{initiator.timeZone}}
{{initiator.locale}}
アクティブな課題の報告者。
1
{{reporter.displayName}}
ユーザー選択カスタムフィールドに関連する情報にアクセスするには、{{ と }} の間にフィールド名を入力してください。たとえば、「Squad leader」というカスタム フィールドがあり、そのユーザーの表示名にアクセスする場合は次のように入力します。
1
{{Squad leader.displayName}}
自動化ルールで別のユーザーをメンションするには、そのユーザーのアカウント ID が必要です。ユーザーのプロファイルにアクセスして URL の末尾を見ることでアカウント ID を確認できます。
次に、以下を入力する必要があります。
1
[~accountId:their account ID]
例:
1
2
3
4
5
[~accountId:557057:1d4fd7f4-bbac-4466-82ee-aaabbbccc]
// returns
@Alana Grant
課題の担当者など、特定のフィールドのユーザーをメンションするには以下を入力します。
1
[~accountId:{{user field name.accountId}}]
たとえば「Squad leader」というユーザー カスタム フィールドがあり、該当者をメンションする場合は、次のように入力します。
1
2
3
4
5
Hi [~accountid:{{Squad leader.accountId}}], could you please assign this bug to someone on your team?
//returns
Hi @Alana Grant, could you please assign this bug to someone on your team?
Slack でユーザーをメンションする
ユーザーをメンションする自動化ルールを構築して、Slack のユーザーにダイレクト メッセージを送信できます。Slack における自動化の使用に関する詳細をご確認ください。
エンティティのプロパティは、Jira のユーザーに対して設定できる任意のキーと値のペアです。ユーザーは、2 つのタイプのエンティティのプロパティを使用できます。
1
2
3
4
5
{{reporter.properties}}
// e.g. if 'financeAccountId' is an entity property set
// programmatically by another app
{{reporter.properties.financeAccountId}}
エンティティのプロパティは、/rest/api/3/user/properties REST API を使用した API 呼び出しを介してのみ設定できます。これは [設定] > [ユーザー管理] > [詳細を表示] > [Jira プロパティを編集] にある従来の [ユーザー プロパティ] 機能と同じではありません。
また、プロジェクト管理者が API を操作しなくても、ルール ビルダー UI から設定できる [エンティティ プロパティを設定] アクションもあります。
この内容はお役に立ちましたか?