Jira Software モジュール
Adobe Workfront Fusion のシナリオでは、Jira Software を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。
シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。
モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスの種類、アクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください
前提条件
Jira モジュールを使用するには、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 の「接続の作成」フィールドに挿入する必要があります。
Jira での API トークンの作成
-
https://id.atlassian.com/manage/api-tokens に移動してログインします。
-
「API トークンを作成」をクリックします。
-
トークンの名前を入力します（例：Workfront Fusion）。
-
「クリップボードにコピー」ボタンを使用してトークンをコピーします。
note important IMPORTANT このダイアログを閉じた後は、トークンを再度表示することはできません。 1. 生成されたトークンを安全な場所に保存します。
-
Workfront Fusion で Jira API トークンを設定するに進みます。
JiraWorkfront Fusion の API トークンを設定
-
Workfront Fusion で、Jira モジュールをシナリオに追加して、「接続を作成」ボックスを開きます。
-
次の情報を指定します。
- サービス URL: これは、Jira アカウントへのアクセスに使用するベース URL です。 例：
yourorganization.atlassian.net - ユーザー名
- API トークン： これは、この記事の Jira での API トークンの作成の節で作成した API トークンです。
- サービス URL: これは、Jira アカウントへのアクセスに使用するベース URL です。 例：
-
「続行」をクリックして接続を作成し、モジュールに戻ります。
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設定
-
「リンクするアプリケーションの URL を入力」フィールドに、次のように入力します。
code language-none https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1 -
「新しいリンクを作成」をクリックします。「入力した URL から応答が受信しませんでした」というエラーメッセージを無視します。
-
アプリケーションをリンク ウィンドウで、Consumer key および 共有シークレット フィールドに値を入力します。
これらのフィールドの値を選択できます。
-
Consumer key および 共有シークレット フィールドの値を安全な場所にコピーします。
これらの値は、設定プロセスの後半で必要になります。
-
URL フィールドに次のように入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 フィールド 説明 リクエストトークン URL <Jira base url>/plugins/servlet/oauth/request-token認証 URL <Jira base url>/plugins/servlet/oauth/authorizeアクセストークン URL <Jira base url>/plugins/servlet/oauth/access-token -
受信リンクを作成 チェックボックスを選択します。
-
「続行」をクリックします。
-
アプリケーションをリンク ウィンドウで、次のフィールドに入力します。
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ファイルから公開鍵を貼り付けます。 -
「続行」をクリックします。
-
Workfront Fusion🔗 で Jira Server または Jira Data Center への接続を作成
Workfront Fusion で Jira Server または Jira Data Center への接続を作成
-
Workfront Fusion で任意の Jira Server モジュールで、「接続」フィールドの横にある「追加」をクリックします。
-
接続の作成パネルで、次のフィールドに入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Connection name 接続の名前を入力 Consumer Key Jira でのクライアントアプリのコンシューマーとしての設定で、安全な場所にコピーした Consumer key に貼り付けます。 Private Key Jira 接続のパブリックキーとプライベートキーの生成で作成した jira_privatekey.pcks8ファイルのとプライベートキーに貼り付けます。Service URL Jira インスタンス URL を入力します。 例： yourorganization.atlassian.net -
「続行」をクリックし、接続を作成して、モジュールに戻ります。
Jira Software モジュールとそのフィールド
Jira Software モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Jira Software フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion におけるモジュール間の情報のマッピングを参照してください。
トリガー
レコードの監視
このトリガーモジュールは、レコードが追加、更新または削除された時点でシナリオを開始します。
アクション
スプリントへのイシューの追加
このアクションモジュールは、スプリントに 1 つ以上のイシューを追加します。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードを作成
このアクションモジュールは、Jira に新しいレコードを作成します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
カスタム API 呼び出し
このアクションモジュールは、Jira Software API に対して認証済みのカスタム呼び出しを実行します。これにより、他の Jira Software モジュールでは不可能なデータフロー自動処理を作成できます。
このモジュールを設定する際には、次のフィールドが表示されます。
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
<Instance URL>/rest/api/2/リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
Workfront Fusion によって、認証ヘッダーが追加されます。
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
例： {"name":"something-urgent"}
標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。
メモ：
if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。
レコードを削除
このアクションモジュールは、特定のレコードを削除します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
添付ファイルをダウンロード
このアクションモジュールは、特定の添付ファイルをダウンロードします。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードの読み取り
このアクションモジュールは、Jira Software の単一レコードからデータを読み取ります。
レコードの ID を指定します。
このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードを更新
このアクションモジュールは、イシューやプロジェクトなどの既存のレコードを更新します。
レコードの ID を指定します。
このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
検索
レコードをリスト表示
この検索モジュールは、検索クエリに一致する特定のタイプのすべての項目を取得します
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。
レコードを検索
この検索モジュールは、指定された検索クエリに一致するレコードを Jira Software のオブジェクト内で検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。