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

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Jira モジュールを使用するには、Jira アカウントが必要です。

Jira API 情報

Jira コネクタでは、以下を使用します。

Jira Cloud
Jira サーバー
apiVersion
2
2
apiVersionAgile
1.0
1.0
API タグ
1.7.29
1.0.19

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 トークンの作成

  1. Jira で API トークンを作成します。

    手順については、Jira ドキュメントで「API トークンの作成」を検索することをお勧めします。

  2. トークンを作成したら、そのトークンを安全な場所にコピーします。

    note important
    IMPORTANT
    このダイアログを閉じた後は、トークンを再度表示することはできません。

    1. 生成されたトークンを安全な場所に保存します。

  3. Workfront Fusion で Jira API トークンを設定するに進みます。

JiraWorkfront Fusion の API トークンを設定

  1. Workfront Fusion の任意の Jira Cloud モジュールで、connection フィールドの横にある「Add」をクリックします。

  2. 次の情報を指定します。

    • 環境
    • タイプ
    • Service URL: これは、Jira アカウントへのアクセスに使用するベース URL です。 例:yourorganization.atlassian.net
    • Username
    • API token: この記事の API トークンの作成 Jira の節で作成した API トークンです。
  3. 「Continue」をクリックして接続を作成し、モジュールに戻ります。

Jira Server を Workfront Fusion に接続

Workfront Fusion と Jira Server の間の接続を承認するには、コンシューマキー、プライベートキー、サービス URL が必要です。この情報については、Jira 管理者への問い合わせが必要になる場合があります。

Jira 接続の公開鍵と秘密鍵の生成

Workfront Fusion Jira 接続の秘密鍵を取得するには、公開鍵と秘密鍵を生成する必要があります。

  1. ターミナルで、次の 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 ファイルに手動で保存する必要がある場合があります。
      1. ターミナルで、次のコマンドを実行します。

        openssl x509 -pubkey -noout -in jira_publickey.cer

      2. -------BEGIN PUBLIC KEY---------------END PUBLIC KEY-------- を含むターミナル出力をコピーします。

      3. ターミナル出力を jira_publickey.pem という名前のファイルに貼り付けます。

  2. Jira でクライアントアプリをコンシューマーとして設定するに進んでください

Jira でクライアントアプリをコンシューマーとして設定する

  1. Jira インスタンスにログインします。

  2. 左側のナビゲーションパネルで Jira Settings Jira 設定アイコン /Applications> Application links をクリックします。

  3. Enter the URL of the application you want to link」フィールドに、

    code language-none
    https://app.workfrontfusion.com/oauth/cb/workfront-jiraserver-oauth1
    
  4. Create new link」をクリックします。 「入力した URL から応答が受信しませんでした」というエラーメッセージを無視します。

  5. Link applications ウィンドウで、「Consumer key」フィールドと「Shared secret」フィールドに値を入力します。

    これらのフィールドの値を選択できます。

  6. Consumer key フィールドと Shared secret フィールドの値を安全な場所にコピーします。

    これらの値は、設定プロセスの後半で必要になります。

  7. 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
  8. Create incoming link」チェックボックスをオンにします。

  9. Continue をクリックします。

  10. 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 ファイルから公開鍵を貼り付けます。
  11. Continue をクリックします。

  12. Workfront Fusion🔗 で Jira Server または Jira Data Center への接続を作成

Workfront Fusion で Jira Server または Jira Data Center への接続を作成

NOTE
Jira Server アプリで Jira Server または Jira Data Center に接続します。
  1. Workfront Fusion の任意の Jira Server モジュールで、connection フィールドの横にある「Add」をクリックします。

  2. 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
  3. Continue」をクリックして接続を作成し、モジュールに戻ります。

Jira Software モジュールとそのフィールド

Jira Software モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Jira Software フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

トリガー

Watch for records

このトリガーモジュールは、レコードが追加、更新または削除された時点でシナリオを開始します。

Webhook

レコードの監視に使用する Web フックを選択します。

新規の web フックを追加するには、次の手順に従います。

  1. クリック Add

  2. Web フックの名前を入力します。

  3. Web フックに使用する接続を選択します。

    Jira Software アカウントを Workfront Fusion に接続する手順については、この記事のJira Software を Workfront Fusion に接続を参照してください。

  4. ソフトウェアで監視するレコードの種類を選択します。

    • Comment
    • Issue
    • Project
    • Sprint

アクション

Add issue to sprint

このアクションモジュールは、スプリントに 1 つ以上のイシューを追加します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Sprint ID
イシューを追加するスプリントのスプリント ID を入力またはマッピングします。
Issue ID or Keys
エクスペリエンスを表示するイシューまたはキーごとに、「Add item」をクリックして、イシュー ID またはキーを入力します。 1 つのモジュールに最大 50 個まで入力できます。

Create a Record

このアクションモジュールは、Jira に新しいレコードを作成します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールで作成するレコードのタイプを選択し、そのレコードタイプに固有の他のフィールドを入力してモジュールに表示します。

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
  • Worklog

Custom API Call

このアクションモジュールでは、Jira Software API への認証済みのカスタム呼び出しを実行できます。このモジュールを使用して、他の Jira Software モジュールでは実現できないデータフローの自動化を作成します。

このモジュールを設定する際には、次のフィールドが表示されます。

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
URL
相対パスを入力します<Instance URL>/rest/api/2/
Method
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion によって、認証ヘッダーが追加されます。

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

Delete a record

このアクションモジュールは、指定されたレコードを削除します。

レコードの ID を指定します。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールで削除するレコードのタイプを選択します。

  • Attachment
  • Comment
  • Issue
  • Project
  • Sprint
ID or Key
削除するレコードの ID またはキーを入力またはマッピングします。

Download an attachment

このアクションモジュールは、特定の添付ファイルをダウンロードします。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
ID
ダウンロードする添付ファイルの ID を入力またはマッピングします。

Read a record

このアクションモジュールは、Jira Software の単一レコードからデータを読み取ります。

レコードの ID を指定します。

このモジュールは、レコードに関連付けられた標準フィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールが読み取る Jira レコードのタイプを選択します。

  • Attachment
  • Issue
  • Project
  • Sprint
  • User
Outputs
受け取る出力を選択します。「Record Type」フィールドで選択したレコードのタイプに基づいて、出力オプションを使用できます。
ID
モジュールが読み取るレコードの一意の Jira Software ID を入力またはマッピングします。

Update a record

このアクションモジュールは、イシューやプロジェクトなどの既存のレコードを更新します。

レコードの ID を指定します。

このモジュールは、レコードの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールで更新するレコードのタイプを選択します。レコードタイプを選択すると、そのレコードタイプに固有の他のフィールドがモジュールに表示されます。

  • Comment
  • Issue
  • Project
  • Sprint
  • Transition issue
ID or Key
更新するレコードの ID またはキーを入力またはマッピングし、そのレコードタイプに固有の他のフィールドを入力してモジュールに表示します。

検索

List records

この検索モジュールは、検索クエリに一致する特定のタイプのすべての項目を取得します

この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールのリストに表示するレコードのタイプを選択します。レコードタイプを選択すると、そのレコードタイプに固有の他のフィールドがモジュールに表示されます。

  • Comment
  • Issue
  • Project
  • Sprint issue
  • Worklog
Max Results
シナリオの実行サイクルごとにモジュールが取得するレコードの最大数を入力またはマッピングします。

Search for records

この検索モジュールは、指定された検索クエリに一致するレコードを Jira Software のオブジェクト内で検索します。

この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Jira Software アカウントを Workfront Fusion に接続する方法については、この記事のJira Software を Workfront Fusion に接続を参照してください。
Record Type

モジュールで検索するレコードのタイプを選択します。レコードタイプを選択すると、そのレコードタイプに固有の他のフィールドがモジュールに表示されます。

  • Issues

  • Issues by JQL (Jira Query Lanuguage)

    JQL について詳しくは、Atlassian のヘルプサイトで JQL を参照してください。

  • Project

  • Project by issue

  • User

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3