REST API 呼び出しを使って Automation for Jira を拡張する方法

要約

すべての Jira REST API メソッドが Automation for Jira でアクションとして利用できるわけではありませんが、REST API の呼び出しに使用できる [Web リクエストを送信] があります。

ここでは宛先として Jira を使用しますが、パーソナル アクセス トークンを受け入れるツールはすべて互換性があります。

ソリューション

この例では、課題をユーザーに割り当てます。

1. アプリに個人用アクセス トークンを作成します。

すべてのユーザーは、各自の現在の権限レベルと一致する独自の PAT を作成できます。新しいトークンを作成するには、次の手順に従います。

a. Jira アプリケーションで、画面右上の自分のプロファイル画像、[プロファイル] の順に選択します。プロファイルにアクセスしたら、左側のメニューで [個人用アクセス トークン] を選択します。

b. [トークンの作成] を選択します。

c. 新しいトークンに名前を付けます。

d. 必要に応じて、セキュリティ上の理由から、設定した日数が経過すると自動的に失効するようにトークンを設定できます。

e. [作成] をクリックします。

パーソナル アクセス トークンが作成されます。トークンをコピーして、安全なスペースに保存します。

2. ルールを作成して [Web リクエストを送信] アクションを追加します。

3. 早速構成しましょう。

a. まず、次の API URL を追加します。

注: この例では、スマート値 {{issue.key}} を使用して課題キーを動的に追加しました。

b. [ヘッダー] フィールドで、名前を Authorization 、値を Bearer <Personal Access Token> として追加します。注: 記載どおりに大文字と小文字を使用してください。

c. メソッドを PUT として選択します。

d. Webhook 本文をカスタム データとして設定します。

e. カスタム データを PUT ペイロード ({ "name": "assignee_name" }) として設定します。

アクションは次のように表示されます。

4. 公開してテストしましょう。

Jira の REST API に関する詳細: https://developer.atlassian.com/server/jira/platform/rest-apis/

スマート値の詳細: https://support.atlassian.com/jira-software-cloud/docs/what-are-smart-values/