質問

自動化で送信したメール内にカスタムフィールドで作成した内容を入れたいです。

手順を教えてください。

回答

issue.customfield_<カスタムフィールドのID>というスマート値を利用することでカスタムフィールドの情報を取得することができます。
カスタムフィールドの ID については、 Jira 管理権限を持つユーザーであれば、カスタムフィールド一覧から確認することが可能です。管理権限を持たないユーザーであっても、 REST API を利用して、JSON 形式のデータから確認することが可能です。

カスタムフィールドのIDの確認方法

カスタムフィールド一覧から確認する方法

1. 画面右上の歯車マークから課題をクリックします。
   
   

   Open

   

    

2. 画面左のサイドバーからカスタムフィールドを開き、該当するカスタムフィールドの・・・マークから詳細を編集をクリックします。
   
   

   Open

   

    

    

3. 遷移後の画面の URL からカスタムフィールド ID の確認ができます。
   以下の例だと ID は10392になります。
   
   

    

    

JSON 形式のデータから確認する方法

1. API トークンを作成するために、画面右上のプロフィールメニューからアカウントを管理をクリックします。
   
   

    

2. 画面上のセキュリティタブから API トークンの作成と管理リンクをクリックします。
   
   

    

3. 画面中心の API トークンを作成するボタンをクリックします。
   
   

    

4. Name の欄に任意のトークン名を、Expires on の欄に有効期限を入力し、作成ボタンをクリックします。
   
   

    

5. コピーボタンをクリックし、クリップボードにコピーされたトークンを任意の場所にペーストし、終了ボタンをクリックします。
   
   

    

6. 作成に成功すると、画像のようにトークンが発行されていることが確認できます。
   情報流出や不正アクセスなどのトラブルを防ぐため、トークンの管理には十分にお気を付けください。
   
   

    

   以下は Postman のインストールが完了している前提で記載しております。ご了承ください。
   
   

7. 画面左上の New ボタンをクリックして API を作成します。
   
   

    

8. HTTP Request を実行するため、 HTTP をクリックします。
   
   

    

9. メソッドに GET を選択し、 URL に「https://<ご利用の環境の Jira インスタンスの URL >/rest/api/2/issue/<該当する課題の課題キー>?expand=names」と入力します。
   さらに認証情報を設定するために Authorization タブを選択します。
   Typeに Basic Auth 、 username に Jira へログインするユーザ ID 、 Password に先ほど取得した API トークンを張り付けます。
   全ての入力が完了したら、画面右上の send ボタンをクリックします。
   
   

    

    

    

10. 成功すると画像のように JSON 形式でデータ（該当するカスタムフィールド）の取得が完了します。
    カスタムフィールド名を探して対応する ID をご確認ください。
    
    

     

    
    以下は自動化ルールの作成が完了していることを前提に記載しております。ご了承ください。

スマート値設定手順

1. 作成している自動化ルールのメールを送信アクションのコンテンツの欄にissue.customfield_<カスタムフィールドのID>というスマート値を記載します。＜カスタムフィールドのID＞の箇所には先ほど取得したカスタムフィールドのIDを設定します。
   以下の例だと ID は10392になります。
   
   

    

2. 自動化ルールが成功すると、送信されるメールにカスタムフィールドの内容が記載されます。