Jira Software モジュール
Adobe Workfront Fusion のシナリオでは、Jira Software を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。
シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。
モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスの種類、アクセス権を確認するには、Workfront 管理者にお問い合わせください。
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 の「接続の作成」フィールドに挿入する必要があります。
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 のオブジェクト内で検索します。
この情報は、シナリオ内の後続のモジュールにマッピングできます。
このモジュールを設定する際には、次のフィールドが表示されます。