Jira Software モジュール

NOTE
これらの手順は、従来のJira CloudおよびJira Server コネクタに適用されます。 Jiraと単にラベル付けされるJira コネクタの新しいバージョンについては、Jira モジュール ​を参照してください。

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 Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。

Adobe Workfront ライセンス

標準

Work またはそれ以上

Adobe Workfront Fusion ライセンス

オペレーションベース:Workfront Fusion ライセンス要件なし

コネクターベース(レガシー):Workfront Fusion for Work Automation および Integration

製品 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

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

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

前提条件

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

Jira API情報

Jira コネクタでは、次の機能を使用します。

Jira Cloud
Jira Server
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
    このダイアログを閉じた後は、トークンを再度表示することはできません。
  3. 生成されたトークンを安全な場所に保存します。

  4. Workfront Fusionで Jira API トークンを設定します。

Workfront FusionでJira API トークンを設定する

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

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

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

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
      Windowsを使用している場合は、公開鍵をjira_publickey.pem ファイルに手動で保存する必要がある場合があります。
      1. ターミナルで、次のコマンドを実行します。
      openssl x509 -pubkey -noout -in jira_publickey.cer
      1. -------BEGIN PUBLIC KEY---------------END PUBLIC KEY--------を含むターミナル出力をコピーします。

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

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

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

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

  2. 左側のナビゲーションパネルで、Jira設定 Jira設定アイコン ​ > アプリケーション> アプリケーションリンク​をクリックします。

  3. リンクするアプリケーションの URL を入力」フィールドに、次のように入力します。

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

  5. アプリケーションをリンク​ウィンドウで、Consumer key および 共有シークレット​フィールドに値を入力します。

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

  6. Consumer key および​ 共有シークレット ​フィールドの値を安全な場所にコピーします。

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

  7. 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
  8. 受信リンクを作成​チェックボックスを選択します。

  9. 続行」をクリックします。

  10. アプリケーションをリンク​ウィンドウで、次のフィールドに入力します。

    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. 続行」をクリックします。

  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. 接続の作成パネルで、次のフィールドに入力します。

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

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

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

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

マップ切り替え

トリガー

レコードの監視

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

Webhook

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

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

  1. Add をクリックします。

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

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

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

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

    • Comment
    • Issue
    • Project
    • Sprint

アクション

スプリントへのイシューの追加

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

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

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

レコードを作成

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

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

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

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

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

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

カスタム API 呼び出し

このアクションモジュールは、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 で使用する場合は、条件文を引用符で囲みます。

レコードを削除

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

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

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

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

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

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

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

添付ファイルをダウンロード

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

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

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

レコードの読み取り

このアクションモジュールは、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 を入力またはマッピングします。

レコードの更新

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

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

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

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

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

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

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

検索

IMPORTANT
従来の 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
これは、Jira 側の廃止によるものです。
このエラーが発生した場合は、従来の Jira コネクターの検索モジュールを新しいコネクターの検索モジュールに置き換えることができます。新しいコネクターでは、使用する API バージョンを選択できます。接続を作成する際は、必ずV3を選択してください。
新しいJira コネクタの API バージョン オプション ​
メモ:
  • 影響を受けるのは検索モジュールのみです。現時点では、Fusion コネクターで使用される他の Jira API エンドポイントは、この廃止の影響を受けません。

  • 地理的なロールアウトによって不整合が発生する場合があります。Atlassian はこの変更を地域的に展開しています。つまり、一部の Jira クラウドインスタンスでは、引き続き一時的に古いエンドポイントをサポートしている可能性があります。これにより、環境間で動作に一貫性がなくなる可能性があります。

レコードをリスト表示

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

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

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

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

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

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

レコードを検索

この検索モジュールは、指定された検索クエリに一致するレコードを 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
workfront-fusion-help-workfront-fusion