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 プラン |
新規：標準 または 現在：仕事以上 |
| Adobe Workfront Fusion ライセンス** |
現在：Workfront Fusion ライセンス要件なし または 従来のバージョン：作業の自動化と統合のためのWorkfront Fusion |
| 製品 |
新規：
または 現在：Adobe Workfront Fusion を購入する必要があります。 |
このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
Jira モジュールを使用するには、Jira アカウントが必要です。
Jira のWorkfront Fusion への接続
必要な認証情報を作成
Jira への接続を作成するには、次が必要です。
これらの作成方法については、Jira のドキュメントを参照してください。
これらの資格情報を作成する際には、次の情報が必要です。
-
Oauth 2 の場合：
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion データセンター リダイレクト URL US 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 -
個人用アクセストークン（PAT）の場合：
table 0-row-2 1-row-2 2-row-2 3-row-2 Fusion データセンター リダイレクト URL US 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-jiranote important IMPORTANT PAT を使用するには、ファイル jira/bin/WEB-INF/classesのファイルjira-config.propertiesで次の項目を有効にする必要があります。jira.rest.auth.allow.basic = truejira.rest.csrf.disabled = true
このファイルが存在しない場合は、作成する必要があります。
Workfront Fusion で Jira への接続を作成します
Workfront Fusion で接続を作成するには：
-
任意の 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 8-row-2 9-row-2 layout-auto html-authored no-header 接続タイプ 基本接続と OAuth 2 接続のどちらを作成するかを選択します。 接続名 新しい接続の名前を入力します。 サービス URL Jira インスタンスの URL を入力します。 これは、Jira へのアクセスに使用する URL です。 Jira アカウントタイプ Jira Cloud と Jira データセンターのどちらに接続するかを選択します。 クライアント ID Oauth 2 接続を作成する場合は、Jira クライアント ID を入力します クライアントシークレット OAuth 2 接続を作成する場合は、Jira クライアント秘密鍵を入力します メール Jira Cloud への基本的な接続を作成する場合は、メールアドレスを入力します。 API トークン Jira Cloud への基本的な接続を作成している場合は、API トークンを入力します。 個人用アクセストークン Jira データセンターへの基本的な接続を作成している場合は、個人用アクセストークンを入力します。 API バージョン この接続を接続する Jira API バージョンを選択します。 -
「続行」をクリックし、接続を作成して、モジュールに戻ります。
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 のオブジェクト内のレコードを検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。