Jira Software モジュール
Adobe Workfront Fusion のシナリオでは、Jira Software を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。
これらの手順は、Jira Cloud と Jira 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 API 情報
Jira コネクタでは、以下を使用します。
Jira Software を Workfront Fusion に接続
接続方法は、Jira Cloud を使用しているか、Jira Server を使用しているかによって決まります。
Jira Cloud を Workfront Fusion に接続
Jira Cloud を Workfront Fusion に接続
Jira Software を Workfront Fusion に接続するには、API トークンを作成し、それをサービス URL およびユーザー名と共に Workfront Fusion の Create a connection フィールドに挿入する必要があります。
Jira での API トークンの作成
-
Jira で API トークンを作成します。
手順については、Jira ドキュメントで「API トークンの作成」を検索することをお勧めします。
-
トークンを作成したら、そのトークンを安全な場所にコピーします。
note important IMPORTANT このダイアログを閉じた後は、トークンを再度表示することはできません。 1. 生成されたトークンを安全な場所に保存します。
-
Workfront Fusion で Jira API トークンを設定するに進みます。
JiraWorkfront Fusion の API トークンを設定
-
Workfront Fusion の任意の Jira Cloud モジュールで、connection フィールドの横にある「Add」をクリックします。
-
次の情報を指定します。
- 環境
- タイプ
- Service URL: これは、Jira アカウントへのアクセスに使用するベース URL です。 例:
yourorganization.atlassian.net
- Username
- API token: この記事の API トークンの作成 Jira の節で作成した API トークンです。
-
「Continue」をクリックして接続を作成し、モジュールに戻ります。
Jira Server を Workfront Fusion に接続
Workfront Fusion と Jira Server の間の接続を承認するには、コンシューマキー、プライベートキー、サービス URL が必要です。この情報については、Jira 管理者への問い合わせが必要になる場合があります。
Jira 接続の公開鍵と秘密鍵の生成
Workfront Fusion Jira 接続の秘密鍵を取得するには、公開鍵と秘密鍵を生成する必要があります。
-
ターミナルで、次の
openssl
コマンドを実行します。-
openssl genrsa -out jira_privatekey.pem 1024
このコマンドは、1024 ビットの秘密鍵を生成します。
-
openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365
このコマンドは X509 証明書を作成します。
-
openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8
このコマンドは、秘密キー(PKCS8 形式)を
jira_privatekey.pcks8
ファイルに抽出します。 -
openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pem
このコマンドは、証明書から
jira_publickey.pem
ファイルに公開鍵を抽出します。note note NOTE Windows を使用している場合は、公開鍵を jira_publickey.pem
ファイルに手動で保存する必要がある場合があります。-
ターミナルで、次のコマンドを実行します。
openssl x509 -pubkey -noout -in jira_publickey.cer
-
-------BEGIN PUBLIC KEY--------
と-------END PUBLIC KEY--------
を含むターミナル出力をコピーします。 -
ターミナル出力を
jira_publickey.pem
という名前のファイルに貼り付けます。
-
-
-
Jira でクライアントアプリをコンシューマーとして設定するに進んでください
Jira でクライアントアプリをコンシューマーとして設定する
-
Jira インスタンスにログインします。
-
左側のナビゲーションパネルで Jira Settings
-
「Enter the URL of the application you want to link」フィールドに、
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
-
「Create new link」をクリックします。 「入力した URL から応答が受信しませんでした」というエラーメッセージを無視します。
-
Link applications ウィンドウで、「Consumer key」フィールドと「Shared secret」フィールドに値を入力します。
これらのフィールドの値を選択できます。
-
Consumer key フィールドと Shared secret フィールドの値を安全な場所にコピーします。
これらの値は、設定プロセスの後半で必要になります。
-
URL フィールドに次のように入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 フィールド 説明 Request Token URL <Jira base url>/plugins/servlet/oauth/request-token
Authorization URL <Jira base url>/plugins/servlet/oauth/authorize
Access Token URL <Jira base url>/plugins/servlet/oauth/access-token
-
「Create incoming link」チェックボックスをオンにします。
-
Continue をクリックします。
-
Link applications ウィンドウで、次のフィールドに入力します。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Consumer Key 安全な場所にコピーした Consumer key を貼り付けます。 Consumer name 任意の名前を入力します。この名前は、参照用です。 Public key jira_publickey.pem
ファイルから公開鍵を貼り付けます。 -
Continue をクリックします。
-
Workfront Fusion🔗 で Jira Server または Jira Data Center への接続を作成
Workfront Fusion で Jira Server または Jira Data Center への接続を作成
-
Workfront Fusion の任意の Jira Server モジュールで、connection フィールドの横にある「Add」をクリックします。
-
Create a connection パネルで、次のフィールドに入力します。
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 Connection name 接続の名前を入力 Environment 実稼動環境と非実稼動環境のどちらを使用しているかを選択します。 Type サービスアカウントと個人用アカウントのどちらを使用するかを選択します。 Consumer Key Jira でのクライアントアプリのコンシューマーとしての設定で、安全な場所にコピーした Consumer key に貼り付けます。 Private Key Jira 接続のパブリックキーとプライベートキーの生成で作成した jira_privatekey.pcks8
ファイルのとプライベートキーに貼り付けます。Service URL Jira インスタンス URL を入力します。 例: yourorganization.atlassian.net
-
「Continue」をクリックして接続を作成し、モジュールに戻ります。
Jira Software モジュールとそのフィールド
Jira Software モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Jira Software フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。
トリガー
Watch for records
このトリガーモジュールは、レコードが追加、更新または削除された時点でシナリオを開始します。
アクション
Add issue to sprint
このアクションモジュールは、スプリントに 1 つ以上のイシューを追加します。
このモジュールを設定する際には、次のフィールドが表示されます。
Create a Record
このアクションモジュールは、Jira に新しいレコードを作成します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Custom API Call
このアクションモジュールでは、Jira Software API への認証済みのカスタム呼び出しを実行できます。このモジュールを使用して、他の Jira Software モジュールでは実現できないデータフローの自動化を作成します。
このモジュールを設定する際には、次のフィールドが表示されます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
Delete a record
このアクションモジュールは、指定されたレコードを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Download an attachment
このアクションモジュールは、特定の添付ファイルをダウンロードします。
このモジュールを設定する際には、次のフィールドが表示されます。
Read a record
このアクションモジュールは、Jira Software の単一レコードからデータを読み取ります。
レコードの ID を指定します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Update a record
このアクションモジュールは、イシューやプロジェクトなどの既存のレコードを更新します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
検索
List records
この検索モジュールは、検索クエリに一致する特定のタイプのすべての項目を取得します
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
Search for records
この検索モジュールは、指定された検索クエリに一致するレコードを Jira Software のオブジェクト内で検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。