Jira モジュール
Adobe Workfront Fusionでは、Jiraを使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりできます。
Jira コネクタは、Jira CloudとJira Data Serverの両方に使用できます。
シナリオの作成手順について詳しくは、シナリオの作成：記事のインデックスの記事を参照してください。
モジュールについて詳しくは、モジュール：記事インデックスの記事を参照してください。
アクセス要件
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront パッケージ |
任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ Workfront Ultimate Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。 |
| Adobe Workfront ライセンス |
標準 Work またはそれ以上 |
| Adobe Workfront Fusion ライセンス |
オペレーションベース：Workfront Fusion ライセンス要件なし コネクターベース（レガシー）：Workfront Fusion for Work Automation および Integration |
| 製品 | 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。 |
この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
- Jira モジュールを使用するには、Jira アカウントが必要です。
- JiraでOAuth2 アプリケーションを作成するには、Jira Developer Consoleにアクセスする必要があります。
JiraとWorkfront Fusionの連携
Jiraへの接続を作成する手順は、基本的な接続を作成するか、OAuth2接続を作成するかによって異なります。
JiraへのOAuth2接続の作成
JiraへのOAuth2接続を作成するには、Fusionで接続を設定する前に、Jiraでアプリケーションを作成する必要があります。
JiraでのOAuth2 アプリケーションの作成
-
Jira Developer Consoleに移動します。
-
マイアプリ領域で、Createをクリックし、OAuth 2.0統合を選択します。
-
統合の名前を入力し、開発者条件に同意して、作成をクリックします。
アプリケーションが作成され、アプリケーション設定領域に移動します。
-
左側のナビゲーションパネルで「権限」をクリックします。
-
「権限」領域で、Jira API行を探します。
-
Jira API行の Add をクリックし、同じ行の Continue をクリックします。
-
次のスコープを有効にします。
- Jiraの問題データの表示（
read:jira-work） - ユーザープロファイルの表示（
read:jira-user） - 問題の作成と管理（
write:jira-work）
- Jiraの問題データの表示（
-
左側のナビゲーションで、認証をクリックします。
-
OAuth 2.0認証の行の Add をクリックします。
-
「コールバック URL」フィールドに、Workfront Fusion データセンターに基づいて、次のいずれかのURLを入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion データセンター コールバック URL 米国 https://app.workfrontfusion.com/oauth/cb/workfront-jira2EU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jira2Azure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira2 -
左側のナビゲーションで、設定をクリックします。
-
（オプション）説明フィールドに説明を入力し、そのフィールドの下の 変更を保存 をクリックします。
-
設定エリアから安全な場所にクライアント IDとクライアント秘密鍵をコピーするか、Fusionで接続を設定する際にこのページを開いたままにします。
-
引き続きFusionでOAutt2接続を設定します
FusionでのOAuth2接続の設定
-
任意のJira モジュールで、接続フィールドの横にある 追加 をクリックします。
-
次のフィールドを設定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header 接続タイプ OAuth 2を選択します。 接続名 新しい接続の名前を入力します。 サービス URL Jira インスタンス URLを入力します。 Jiraへのアクセスに使用するURLです。 Jira アカウント タイプ Jira CloudとJira Data Centerのどちらに接続しているかを選択します。 クライアント ID で作成したJira アプリケーションのクライアント IDを入力し、JiraでOAuth2 アプリケーションを作成します。 クライアントシークレット で作成したJira アプリケーションのClient Secretを入力し、JiraでOAuth2 アプリケーションを作成します。 その他の範囲 この接続に追加する追加のスコープを入力します。 API バージョン この接続を接続するJira API バージョンを選択します。 -
「続行」をクリックし、接続を作成して、モジュールに戻ります。
Jiraへの基本的な接続の作成
Jiraへの基本的な接続の作成は、Jira CloudまたはJira Data Centerへの接続を作成するかどうかによって異なります。
Jira Cloudへの基本的な接続の作成
Jira API トークンの取得手順については、Atlassian ドキュメントの「Atlassian アカウントのAPI トークンを管理」を参照してください。
-
任意のJira モジュールで、接続フィールドの横にある 追加 をクリックします。
-
次のフィールドを設定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header 接続タイプ 基本接続とOAuth 2接続のどちらを作成するかを選択します。 接続名 新しい接続の名前を入力します。 サービス URL Jira インスタンス URLを入力します。 Jiraへのアクセスに使用するURLです。 Jira アカウント タイプ Jira CloudとJira Data Centerのどちらに接続しているかを選択します。 メール メールアドレスを入力します。 API トークン API トークンを入力します。 API バージョン この接続を接続するJira API バージョンを選択します。 -
「続行」をクリックし、接続を作成して、モジュールに戻ります。
Jira Data Centerへの基本的な接続の作成
Jira個人アクセストークンの取得方法については、Atlassian ドキュメントの「Atlassian アカウントのAPI トークンを管理」を参照してください。
PATを作成する際の考慮事項については、この記事の「PATを設定する」を参照してください。
-
任意のJira モジュールで、接続フィールドの横にある 追加 をクリックします。
-
次のフィールドを設定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header 接続タイプ 基本接続とOAuth 2接続のどちらを作成するかを選択します。 接続名 新しい接続の名前を入力します。 サービス URL Jira インスタンス URLを入力します。 Jiraへのアクセスに使用するURLです。 Jira アカウント タイプ Jira CloudとJira Data Centerのどちらに接続しているかを選択します。 PAT （個人アクセストークン） Jira個人アクセストークンを入力します。 API バージョン この接続を接続するJira API バージョンを選択します。 -
「続行」をクリックし、接続を作成して、モジュールに戻ります。
PATの設定
Jira Data Centerへの基本的な接続を作成するには、Jira個人アクセストークン（PAT）が必要です。
Jira個人アクセストークンの取得方法については、Atlassian ドキュメントの「Atlassian アカウントのAPI トークンを管理」を参照してください。
PATを設定する際には、次の情報が必要になる場合があります
-
リダイレクト URL
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion データセンター リダイレクト URL 米国 https://app.workfrontfusion.com/oauth/cb/workfront-jiraEU https://app-eu.workfrontfusion.com/oauth/cb/workfront-jiraAzure https://app-az.workfrontfusion.com/oauth/cb/workfront-jira -
ファイル設定
PATを使用するには、ファイル jira-config.propertiesのファイル jira/bin/WEB-INF/classesで次の機能を有効にする必要があります。
jira.rest.auth.allow.basic = truejira.rest.csrf.disabled = true
このファイルが存在しない場合は、作成する必要があります。
Jira モジュールとそのフィールド
Jira モジュールを設定すると、Workfront Fusionに次のフィールドが表示されます。 これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加のJira フィールドが表示される場合があります。 モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、モジュール間での情報のマッピングを参照してください。
トリガー
レコードを監視する
このトリガーモジュールは、レコードが追加、更新または削除された時点でシナリオを開始します。
アクション
スプリントにイシューを追加
このアクションモジュールは、スプリントに 1 つ以上のイシューを追加します。
レコードを作成
このアクションモジュールは、Jira に新しいレコードを作成します。
カスタム API 呼び出し
このアクションモジュールでは、Jira APIに対してカスタム認証済み呼び出しを行うことができます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。 詳しくは、HTTP リクエスト方法を参照してください。
<Instance URL>/rest/api/2/リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
Workfront Fusion は認証ヘッダーを追加します。
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
例： {"name":"something-urgent"}
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
レコードの削除
このアクションモジュールは、指定されたレコードを削除します。
添付ファイルのダウンロード
このアクションモジュールは、指定された添付ファイルをダウンロードします。
レコードの読み取り
このアクションモジュールは、Jiraで指定されたレコードからデータを読み取ります。
レコードの更新
このアクションモジュールは、イシューやプロジェクトなどの既存のレコードを更新します。
検索
[410] The requested API has been removed. Please migrate to the /rest/api/3/search/jql API. A full migration guideline is available at https://developer.atlassian.com/changelog/#CHANGE-2046
-
影響を受けるのは検索モジュールのみです。 現時点では、Fusion コネクターで使用される他の Jira API エンドポイントは、この廃止の影響を受けません。
-
地理的なロールアウトによって不整合が発生する場合があります。 Atlassian はこの変更を地域的に展開しています。つまり、一部の Jira クラウドインスタンスでは、引き続き一時的に古いエンドポイントをサポートしている可能性があります。 これにより、環境間で動作に一貫性がなくなる可能性があります。
レコードの検索
この検索モジュールは、指定した検索クエリに一致するJira内のオブジェクト内のレコードを検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。