Adobe Workfront for Jira の設定
Jira および Workfront システムを統合するには、Adobe Workfront for Jira を使用できます。
アドオンをインストールした後、Workfront 作業アイテムが作成される場合に、Jira のイシューを自動的に作成するワークフローを定義できます。両方のアプリケーションの項目がリンクされ、両方のシステムで情報の一部が自動的に更新されます。
Workfront のすべてのユーザーおよび Jira は、この統合からメリットを得ることができます。最も頻繁に作業するシステムのライセンスのみ必要で、両方のシステムのライセンスが必要になるわけではありません。
このアドオンは、サーバーおよびOnDemand(またはクラウド)の Jira ソフトウェアのバージョンの両方で使用できます。
Jira が現在サポートしている Workfront for Jira のバージョンのリストについて、🔗 Atlassian Marketplace での Workfront for Jira を参照してください。
アクセス要件
以下が必要です。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
---|---|
Adobe Workfront plan |
新規:任意 または 現在:Pro 以上 |
Adobe Workfront ライセンス |
新規:Standard または 現在:Plan |
Jira アクセス |
システム管理者のアクセス権 重要:ユーザーに関連付けられている既存のアカウントを使用するのではなく、この統合専用のシステム管理者アカウントを Jira と Workfront に個別に作成することをお勧めします。 |
アクセスレベル設定 | Workfront 管理者である必要があります。 |
この表の情報について詳しくは、Workfront ドキュメントのアクセス要件を参照してください。
前提条件
Workfront for Jira を設定する前に、以下を行う必要があります。
- Workfront for Jira をインストールします。
Workfront for Jira のインストールの手順については、 Adobe Workfront for Jira をインストールを参照してください。
Workfront for Jira の設定
Workfront for Jira を設定することで、次の操作を実行できます。
- Workfront 項目が作成される場合、Jira 項目を作成するトリガーを定義します。
- Jira および Workfront の間にリンクされた項目間で同期するフィールドを指定します。
- Jira 環境で Workfront for Jira を設定した後に、すべての Jira ユーザーは、Jira の項目上に Workfront の右側のパネルが表示されることを確認できます。パネルには、Workfront からリンクされる項目に関する情報が含まれています。または、Jira 項目にリンクされる Workfront 項目は、何もないことを指定します。
- Jira Server インストールを使用時に、Workfront 統合のトリガーとして識別されたプロジェクトに関連するイシューに対してのみ、Workfront パネルが表示されます。Workfront to Jira ワークフローのトリガーの設定の詳細については、 Jira および Workfront 間の項目を自動的にリンクするトリガーを設定を参照してください。
Workfront for Jira を設定するには、以下を実行します。
-
Jira に Jira 管理者としてログインします。
-
メインの Jira のメニューで「設定」をクリックします。
-
「アドオン」を選択し、次に「アドオンの管理」をクリックします。
-
Workfront アドオンを展開します。
-
「設定」をクリックします。
-
画面の指示に従って、Workfront にログインします。
note note NOTE ユーザーは、接続を成功させるには、Workfrontで有効な apiKey
何かを持つ必要があります。Workfront 管理者として Workfront にログインする必要があります。
note note NOTE - Workfrontは、ほとんどの web ベースの統合で、ユーザーの認証と承認に使用される標準である OAuth 2.0 を使用した Jira に接続します。
- Workfront アカウントのドメインの入力を求められたら、次の形式で入力します。yourCompany'sDomain.my.workfront.com 会社のドメインは通常、会社の名前です。
- 拡張認証は、Workfront 管理者が拡張認証をこの統合に対して有効にするまで使用できません。
-
Jira で、「トリガー」タブを選択して、Workfront アイテムが新規に作成されるときに Jira アイテムが自動的に作成されるように設定します。
ワークフロントから Jira へのトリガーの設定について詳しくは、 Jira と Workfront の間で項目を自動的にリンクするためのトリガーを設定を参照してください。
-
「設定」タブを選択して、リンクされた Jira 項目と Workfront 項目の間のフィールドの同期を設定します。
Jira と Workfront の間のフィールドの同期の設定について詳しくは、 Jira 項目と Workfront 項目の間のフィールド同期を設定を参照してください。
note note NOTE トリガーと 2 つのアプリケーション間のフィールドの同期を定義した後は、タスクまたはイシューを作成できる Workfront ユーザーが Jira での項目の作成をトリガーする可能性があります。ユーザーは、作成する項目の条件が Jira のトリガーと一致する場合、ユーザーは、Jira ライセンスがない場合でも項目を作成できます。また、Jira ユーザーはすぐに Jira 項目の作業を開始し、Workfront ライセンスがなくても Workfront で更新を確認できます。Workfront での更新は、Jira にも表示されます。 -
(オプション)「アクティビティログ」タブを選択して、統合中に発生した可能性のあるエラーを確認します。
アクティビティログについて詳しくは、 Jira アクティビティログを表示を参照してください。
Jira と Workfront の間で項目を自動的にリンクするためのトリガーを設定
Jira のシステム管理者は、Workfront の項目が特定の条件を満たしたときに Jira にイシューを自動的に作成するトリガーを定義できます。
Workfront 項目が作成されたときに、Jira 項目の作成をトリガーするように設定する場合は、以下を考慮してください。
- 統合は単方向です。Workfront で作成した項目のみが Jira で自動的に作成されるようにトリガーできます。Jira で作成した項目を Workfront で自動的に作成するようにトリガーすることはできません。
- 使用できるトリガー数に制限はありません。
- Workfront で作成した項目が複数のトリガーに一致する場合、Jira には 1 つの項目だけが作成されます。項目は、最初のトリガーに従って(Jira で定義された順序で)Jira に作成されます。その他のすべてのトリガーは無視されます。
- Workfront の中の 1 つの項目のみが、Jira 内の 1 つの項目にリンクできます。1 つの Workfront 項目を複数の Jira イシューにリンクしたり、1 つの Jira イシューを複数の Workfront 項目にリンクしたりすることはできません。
Jira で項目を自動的に作成するためのトリガーを構成するには、以下のように行います。
-
システム管理者として Jira にログインします。
-
メイン Jira メニューで「設定」をクリックします。
-
「アドオン」、「アドオンを管理」の順にクリックします。
-
Workfront アドオンを展開します。
-
「設定」をクリックします。
-
システム管理者として Workfront にログインします。
Jira では「トリガー」タブがデフォルトで選択されています。
-
「トリガーを追加」をクリックして、新しいトリガーを追加します。
-
「Workfront チーム/ユーザー/役割」フィールドで、Workfront チーム、ユーザー、または担当業務の名前を指定し、リストに表示されたらクリックして選択します。
note note NOTE 同じチーム、ユーザー、役割に複数のトリガーを設定することはできません。 ユーザーがタスクまたはイシューを作成し、これらのエンティティのいずれかに割り当てると、イシューが Jira に自動的に作成されます。
-
「Jiraプロジェクト」フィールドで、Jira プロジェクトの名前を入力し、リストに表示されたらクリックして選択します。
Jira イシューが作成されると、ここで指定したプロジェクトに配置されます。
-
ドロップダウンメニューから「イシュータイプ」を選択します。
これは、Jira の特定のプロジェクトの設定に基づいて、このトリガーの条件が満たされたときに、Jira で作成されるイシュータイプを示します。
-
「保存」をクリックします。
この設定を使用すると、Workfront ユーザーが指定されたトリガーに一致する項目を作成するたびに、新しいイシューが Jira に作成されます。
Jira 項目と Workfront 項目間のフィールド同期を設定
Jira 管理者は、Workfront と Jira の間でリンクされているアイテムで、自動的に同期するフィールドを定義できます。特定のフィールドは Workfront 項目から Jira 項目に同期でき、その他のフィールドは Jira から Workfront に同期します。
2 つのアプリケーション間でリンクされた項目でどのフィールドを自動的に同期するかを定義するには、以下のように行います。
-
Jira に Jira 管理者としてログインします。
-
メイン Jira メニューで「設定」をクリックします。
-
「アドオン」、「アドオンを管理」の順にクリックします。
-
Workfront アドオンを展開します。
-
「設定」をクリックします。
-
Workfront 管理者として Workfront にログインします。
-
Jira で、「設定」タブをクリックします。
-
「Jira から Workfront に同期」セクションで、Workfront で更新された際に Jira で更新するフィールドを選択します。
-
フィールドの同期頻度として、次のいずれかを選択します。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header On Creation Workfront で項目を作成された場合、指定したフィールドは、リンクされた Workfront と Jira 項目の間で同期されます。 Always 指定したフィールドは、Workfront でフィールドが更新されると、リンクされた Workfront と Jira 項目の間で同期されます。 Never 指定したフィールドは、リンクされた Workfront および Jira 項目の間で同期されることはありません。Jira には、Workfront でフィールドが更新されたことを示すものはありません。 -
Workfront から Jira にフィールドを同期するには、次のいずれかを選択します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Name Workfront のタスクまたはイシューの名前は、Jira でリンク先のイシューの名前になります。
メモ:新しい項目が Jira で自動的に作成される場合、このフィールドがここで有効にされているかどうかに関係なく、Workfront 名は常に Jira 項目で更新されます。Jira 項目が手動で Workfront 項目にリンクされている場合、「常に」このフィールドを同期するように選択すると、Workfront 項目の名前のみが Jira で更新されます。項目を手動または自動でリンクする方法について詳しくは、Adobe Workfront および Jira の間の項目をリンクするを参照してください。
Description Workfront でのタスクまたはイシューの説明は、Jira でリンク先のイシューの説明になります。 ドキュメント Workfront でタスクまたはイシューに添付されたドキュメントは、Jira でリンクされているイシューにも添付されています。Workfront からの新しいドキュメントバージョンは、別のドキュメントとして Jira に追加され、_v<version number> が付加され、Workfront で番号付きバージョンを示します。
例えば、Workfront でドキュメントの名前が Main Ad で、新しいバージョンを Workfront で追加する場合、新しいバージョンは、Main Ad_v2 という名前の新しいドキュメントとして、Jira に転送されます。
重要:
ドキュメントを同期する場合、次の点を考慮してください。
-
5MB を超えるドキュメントは同期されません。ドキュメントが大きすぎてドキュメントの同期に失敗した場合は、アクティビティログにエラーが記録されます。
アクティビティログについて詳しくは、Jira アクティビティログの表示を参照してください。
-
外部サーバーからのタスクやイシューにリンクされたドキュメントは、Jira 項目に転送されません。Workfront でタスクまたはイシューに直接アップロードされたドキュメントのみが Jira でリンクされたイシューに転送されます。
-
ドキュメントからプルーフを作成するには、Workfront でプルーフを生成する必要があります。
プルーフの生成について詳しくは、ドキュメントのプルーフの作成の既存のドキュメントのプルーフの作成を参照してください。
Planned Completion Date Workfront でタスクまたはイシューのPlanned Completion Dateは、Jira でリンクされているイシューのDue Dateになります。
メモ:この値を同期するには、Jira イシューの Due Date を確実に表示します。
-
-
-
「Jira からWorkfront に同期」セクションで、Jira で更新された場合に Workfront で更新するフィールドを選択します。
-
フィールドの同期頻度として、次のいずれかを選択します。
table 0-row-2 1-row-2 layout-auto html-authored no-header Always 指定したフィールドは、Jira でフィールドが更新された場合、リンクされた Workfront 項目および Jira 項目の間で常に同期されます。 Never 指定したフィールドは、リンクされた Workfront 項目および Jira 項目の間で同期されることはありません。Workfront には、Jira でフィールドが更新されたことを示すものはありません。
メモ:「実行しない」を選択した場合、Jira イシューの左 Workfront パネルで Workfront フィールドは Jira から手動で更新できます。これらの更新は、Jira および Workfront で、Jira 項目ではなく、Workfront 項目にのみ表示されます。
-
Jira から Workfront の次のフィールドのいずれかを選択して同期します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Status Jira のイシューの Status は、Workfront でリンクされているタスクまたはイシューの Status になります。
Workfront ステータスについて詳しくは、ステータスの作成または編集を参照してください。Assignee Jira のイシューの Assignee は、Workfront でリンクされているタスクまたはイシューの Assignee になります。
重要:Jira で Workfront アカウントを持たないユーザーに対してアイテムを割り当てる際に、「Jira ユーザーが Workfront アカウントを持っていない場合 Workfront でユーザーを自動的に作成する」が「Always」に設定されている場合のみ、統合により、Workfront で新しいアクティブユーザーが作成されます。このユーザーは Workfront ライセンスを所有しません。アクティブユーザーは、Workfront で作業アイテムに割り当てることができますが、更新に含めることはできません。
Attachments Jira のイシューの添付ファイルは、Workfront でリンクされているタスクまたはイシューにも添付されます。 Comments Jira イシューに対するコメントは、Updates エリアのリンクされた Workfront 項目にも投稿されます。逆に、Workfront のタスクまたはイシューに関して Updates エリアに投稿されたコメントは、リンクされたイシューに対する Jira のネイティブのコメントストリームに同期されます。
デフォルトでは、Always に設定されています。ここで Never を選択した場合でも、Workfront または Jira でリンクされたアイテムに手動でコメントを投稿できます。
-
-
「その他」セクションで、リンクされたアイテム間で更新するその他のフィールドを選択します。
-
指定したフィールドが更新されたとき、Jira または Workfront で 常に 更新するのか、決して 更新しないのかを決定するオプションを選択します。
-
次のフィールドと更新から選択します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Copy Workfront Custom Data in the right panel in Jira Workfront の右パネルにアイテムの Workfront カスタムデータが表示されます。
メモ:カスタムフォームセクションは、Workfront システム管理者のアクセスレベルで Workfront の右パネルに表示されます。
Copy Workfront Priority in the right panel in Jira Workfront の右パネルにアイテムの Workfront 優先度が表示されます。 Add an update in the Workfront Updates tab about Due Date changes in Jira リンクされた Jira アイテムで Due Date が変更された場合、Workfront アイテムの Update タブにコメントを追加します。 Automatically create a user in Workfront if the Jira user does not have a Workfront account 次のシナリオが存在します。
-
「Always」を選択すると、Workfront アカウントを持たない Jira ユーザーが、リンクされた Jira イシューで以下のアクションを実行するたびに、統合によって新しい Workfront ユーザーが作成されます。
-
Jira イシューに割り当てられている
-
Jira イシューに時間を記録する
この新しいユーザーは Workfront ライセンスを所有していません。デフォルト設定は「常に」です。Workfront でこのように作成されたユーザーには、名前に Jira が追加されます。
-
-
「Never」を選択すると、次のようになります。
- Workfront アイテムに対する Jira 割り当ては表示されなくなります。この場合、Workfront で行われた割り当てのみが Workfront アイテムに表示されます。
- Workfront アカウントを持たないユーザーが、リンクされた Jira イシューに記録した時間は、リンクされた Workfront アイテムには自動的に転送されません。Jira イシューの右パネルにある Workfront アイテムには引き続き時間を記録できます。
-
-
-
「保存」をクリックします。
この設定で指定されたフィールドを Jira または Workfront のアイテムで更新するたびに、他のアプリケーションでリンクされたアイテムも更新されようになります。
トラブルシューティング
トリガーフィールドに「見つかりませんでした」とマークされているため、Jira ではアイテムを作成できません
問題
Workfront for Jira アプリケーションでエラーが発生すると、Workfront はさらなる複雑化を防ぐためにトリガーを無効にします。これらのトリガーが無効になっている場合、「見つかりませんでした」と表示されます。
ソリューション
トリガーを無効にしたエラーを見つけます。エラーは Workfront for Jira のアクティビティログで確認できます。
この動作の最も一般的な原因は、「フィールド 'duedate' を設定できません適切な画面に表示されていないか、不明です。」というエラーです。
このエラーは、「予定完了日」を Workfront から Jira に同期しようとしていることを意味します。これを行うには、Jira オブジェクトに「期限」というフィールドがあることを確認する必要があります。このフィールドがない場合、Workfront は Workfront から予定完了日を同期できず、トリガーが無効になります。
このエラーを解決するには、次のいずれかを試してください。
- Jira 管理者に、影響を受ける Jira オブジェクトを更新して、期限フィールドが確実に存在するように依頼してください。
- Workfront の設定ページで、Workfront の完了予定日の同期を無効にします。