Jiraとエアフォーカスの統合

参加するメリット

プロダクトマネジメント 業務フロー、優先順位付けフレームワーク、ロードマップを日々の開発と連携させ、AirfocusとJira間でデータをシームレスに同期させましょう。 インテグレーションはJira Cloud、Jira Server、Jira Data Centerに対応しています。

• Jira発行件(アイテムとして)AirFocusにインポートします。
• エアフォーカスアイテムをJiraに(どの問題タイプでも)送りましょう。
• 双方向同期と柔軟なフィルター(カスタムJQL)。
• 柔軟なフィールドマッピング。
• JiraでAirFocusの優先度スコアを表示し、ビジネス価値や優先順位に関する文脈を把握してください。
• エアフォーカスで親子を直接確認できる能力。

要件

• airfocusについて:ユーザーはJiraインテグレーションを設定したいワークスペースに対して「フル」権限を持つ必要があります。
• Jiraについて:「管理者」権限は、Jiraインスタンスとairfocus チーム間のアプリケーションリンクを確立するために必要です。
• もしJiraインスタンスとairfocus チームの間にアプリケーションリンクがすでに確立されていれば、プロジェクトに対して少なくとも「Create_Issue」権限を持つJiraユーザーであれば、そのインスタンスに新しいインテグレーションを設定できます。
• 私たちのJira インテグレーションはJira Cloud、Jira Server、Jira Data Centerに対応しています。 Atlassian サポート終了ポリシーに記載されているすべてのJiraサーバーバージョンをサポートしています。そこに記載されているバージョンより前のバージョンはエンドサービス(EOL)に達しており、動作は可能だがサポートされていません。

ジラインテグレーションを設立する

1. AirFocusに登録するか、既存のアカウント にログイン してください 。
2. AirFocusで新しいワークスペースを作成するか、Jiraと統合したいワークスペースを選択してください。
   • Jiraインスタンスはエアフォーカスチームごとに一度だけ承認すればいい。
   • 複数のJiraインテグレーションを、あるワークスペースに(例えば異なるJiraプロジェクトやインスタンスから)追加できます。
3. ワークスペースの右上から 拡張機能 をクリックしてください。
4. 「管理インテグレーション」を選択します。
5. 「Jira」タイルの 「Connect 」をクリックしてください。
6. ドロップダウンから「 新しいJiraインスタンスを接続する 」を選択します。
7. JiraのインスタンスベースURLを入力します(例:https://airfocustest.atlassian.net/ または https://jira.mycompany.com)。
8. 「 進む」をクリックしてください。
9. 「アプリケーションのURL」をコピーします。 Jiraでの次のステップにはこれが必要です。
10. [Jira アプリケーション リンク センター]をクリックして、Jira アプリケーション リンク センターを開きます。
    • このページにアクセスするには、Jiraの管理者権限が必要です。

次の手順は、Jira CloudとJira Server/Data Centerで異なります。インスタンスを続行するには、以下のセクションをご確認ください。

Jira Cloudでアプリケーションリンクを作成する

1. Jira Cloudでは、右上隅にある設定アイコンをクリックします。
2. Jiraアプリを選択してください。
3. 左側の「統合」セクションで、 「アプリケーションリンク」をクリックします。
4. ページ右上の「リンクを作成」ボタンをクリックしてください。
5. 「アプリケーションへの直接リンク」オプションを選択します。
6. airfocusのURLを「アプリケーションURL」として貼り付けてください。
7. [次へ] をクリックします。
8. アプリケーションの名前を入力し、アプリケーションの種類が「汎用アプリケーション」として設定されていることを確認します。
9. airfocusで提供される情報を使用して、サービスプロバイダー名、コンシューマーキー、共有シークレット、リクエストトークンURL、アクセストークンURL、および認証URLをコピーしてJiraに貼り付けます。
10. 「受信リンクを作成する」の横にあるチェックボックスをオンにします。
11. 「 続ける」をクリックしてください。
12. airfocusで提供される情報を使用して、コンシューマーキー、コンシューマー名、および公開キーをコピーしてJiraに貼り付けてください。
13. 「 続ける」をクリックしてください。
14. AirFocusに戻って 「セットアップ完了」をクリックします。

OAuth認証ステップへリダイレクトします。これにより、AirfocusがJiraユーザーを使って両者間のアイテムを同期できます。 AirFocusをアカウントと同期させるために「 許可 」をクリックしてください。

JiraサーバーまたはJiraデータセンターでアプリケーションリンクを作成する

1. 右上の「リンクを作成」をクリックします。
2. アトラシアン製品を選択。
3. airfocusのURLを「アプリケーションURL」として貼り付けてください。
4. 「 続く 」をクリックして確認してください。
   
5. エアフォーカスインターフェースで提供された値を入力してください。
6. 「 続ける」をクリックしてください。
7. ステップ3の値をコピーします。
8. ［続行］をクリックします。
   • ジラで確認が見られるはずです。
9. AirFocusに戻って 「セットアップ完了」をクリックします。

OAuth認証ステップへリダイレクトします。これにより、AirfocusがJiraユーザーを使って両者間のアイテムを同期できます。 AirFocusをアカウントと同期させるために「 許可 」をクリックしてください。

インテグレーションフィルターの構成

1. 同期したいプロジェクトを選択してください。プロジェクト一覧をフィルターで入力できます。
   • CREATE_ISSUES権限がないプロジェクトはそのようにマークされます(Jira Cloud専用)。
   • インテグレーションの名前はプロジェクトに基づいて自動的に作成されます。 後で変更することもできます。
2. 同期したい問題タイプを選択してください。
   • フィールドはイシュータイプによって異なることがあり(Jiraのバージョンやプロジェクトの種類(チーム管理か会社管理か)、このフィルターを下に設定して、選択したイシュータイプで実際に利用可能なフィールドにマッピングできます。
   • 複数の課題タイプを同期する場合は、同じワークスペースまたは複数のワークスペースにまたがって、それぞれ 1 つの統合をセットアップすることをお勧めします。 airfocus 階層を介して他のワークスペース (Epic やサブタスクなど) から統合に接続できます。
   • また、issue フィルターにJQL クエリを付けることで、同期された号をさらにフィルター化することも可能です(JQLの詳細はこちらをご覧ください)。

マップ空中フォーカスおよびジラフィールド

マッピングを使用して、Jira の情報と airfocus の情報をどのようにマッピングするかを定義します。一方のシステムで問題または項目を変更すると、他のシステムもそれに応じて調整されます。

例えば、Jiraの状態をエアフォーカスのシングルセレクトフィールドにマッピングするか、またはJiraラベルをエアフォーカスのマルチセレクトフィールドにマッピングする方法を定義できます。

また、Jiraのカスタムやシステムフィールドをエアフォーカスフィールドにマッピングするオプションも多数あります。

フィールドマッピングのオプションを見ると、デフォルトで常に2つのフィールドがマッピングされていることがわかります:アイテム名とアイテム説明です。

各フィールドごとに、JiraとAirFocusのフィールド間でワンウェイ同期か双方向同期かを定義できます。

「Set direction」ボタンで、すべてのフィールドのマッピング方向を一度に設定できます(技術的に可能な限り)。

デフォルトでは、Jiraからエアフォーカスのみに設定され、ユーザーがマッピング可能な方向に変更できます。

フィールドの新しいマッピングを設定すると、Jiraフィールドをエアフォーカスフィールドにマッピングできるのは、両端が同じフィールドタイプである場合だけです。

ドロップダウンでフィールドを選択すると、フィールド タイプに一致するフィールドだけが、反対側のドロップダウンに表示されます。

マップする 2 つのフィールドを選択した後、フィールド オプションとマップ方法を選択できます。

すべてのマッピング可能なフィールドの種類の概要

マッピング可能なJiraシステムのフィールド:

⚠️ 説明欄の双方向同期に関する警告:双方向同期の処理により、Jiraの説明文の内容やフォーマットにわずかな変更が生じる可能性があります。 これは、Jiraのすべてのスタイリングがエアフォーカスでネイティブサポートされていないためです。

⚠️ 人物フィールドマッピングに関する警告:マッピングロジックは表示名に基づいています。したがって、Jiraの「Kirsten」はAirFocusの「Kirst」とは一致しません。両アカウントは同じメールアドレスを使っていてもです。

Jiraが1つの人員フィールドで1つの値しか許可できない場合(例えば、割り当て手は1人しかいない)、エアフォーカスへの同期はマッピングされたエアフォーカス人員フィールドの最初の値を優先します。例えば、Jiraで「Julian」に割り当てられたチケットは、「JulianとNikita」に割り当てられた項目をAirFocusで上書きします。ニキータは外され、ジュリアンだけが引き続き配属されます。

マッピング可能な Jira カスタムフィールド:

トラブルシューティング:日付範囲欄を見つける

AirFocusの日付範囲フィールドにマッピングするためには、修正バージョン以外で少なくとも2つの日付フィールドが必要です。

私たちのインテグレーションは、同期されたイシュータイプ(画面)に表示されている場合にのみ日付フィールドを検出できます。 Jiraのissueタイプ(画面)に少なくとも2つの日付フィールドがあり、airfocusワークスペースでマッピング可能な日付範囲フィールドが少なくとも1つ用意されている必要があります。

ジラでのその様子:

• Jira Cloudのチーム管理の場合は、プロジェクト設定>課題タイプに行き、右側のサイドバーから中央のフィールドリストにフィールドをドラッグしてください。
• Jira Cloud 会社管理 (および Jira Server) の場合、プロジェクト設定 > 課題 > 画面に移動し、同期する課題タイプの画面を編集します。下部に日付フィールドを追加できます。

自動写像フィールド

多くのオプションを持つフィールドをマッピングする際は、「フィールドオプションの自動マッピング」をオンにして時間を節約しましょう。これにより、airfocusとJiraの両方で同じ値のフィールドが自動的にマッピングされます。

フィールド値生成の自動生成

「フィールドのオプションの自動作成」をオンにすると、Jira で作成された新しいフィールドがアイテムに追加されるときに、airfocus に自動的に追加されます。

注:自動生成フィールドジェネレーターは大文字大文字を区別しません。

Jiraでフォーカススコアをマッピングする方法

airfocusのJira インテグレーションでは、Airfocusで優先順位付けやロードマップ作成に使え、開発者(および他の方々)は日々の開発計画にJiraを使います。

デフォルトでは、Jiraでは優先度スコア、レーン、タイムラインなどのAirFocusデータを表示します。このヘルプ記事では、Jiraカスタムフィールド(Jiraでフィルターも使えます)でAirFocusフォーカススコアをマッピングする方法を説明しています。

AirfocusのフォーカススコアをJiraプロジェクトとマッピングすることで、人々が働く場所、つまり同期されたJira発行カードや発行カードの表紙に、最優先指標を正確に示すことができます。こうすることで、チーム全体が重要なタスクに集中し、連携を整えることができます。

Jiraでエアフォーカススコアを表示するには、Jiraのカスタムフィールドでマッピングする必要があります。カスタムフィールドは「Number field」というフィールドタイプでなければなりません。セットアップには約3分かかります。

方法は次のとおりです。

1. Jiraの中で右上の歯車アイコンをクリックすると設定が開きます。
2. 「問題」をクリックします。
3. 左側のナビゲーションメニューから カスタムフィールド を選択します。
4. 右上から 「カスタムフィールドを作成 」をクリックします。
5. フィールドタイプとして 「数字フィールド 」を選択してください。
6. 名前と説明文(任意)を入力してください。
7. 「作成」をクリックします。
8. 新しいカスタムフィールドを同期したプロジェクトのスクリーンに関連付けてください。
   
9. AirfocusのJiraインテグレーション設定に戻り、ドロップダウンから新しく作成したカスタムフィールドを選択してください
   

AirFocusのフォーカススコアはJiraの問題で表示されます
 

カードカバーにもフォーカススコアを表示したい場合は、以下のステップをフォローしてください:

1. ホワイトボードの右上隅にある三点アイコンをクリックします。
2. ホワイトボード設定を選択します。
3. 左側のナビゲーションメニューから カードレイアウト をクリックしてください。
4. ドロップダウンからフォーカススコアのカスタムフィールドを選択してください。
5. [追加] をクリックします。
6. ホワイトボードにもフォーカススコアが表示されるようになりました。
   

追加設定の設定

• 「archive unknown issues」を有効にすると、以前にインポートしたアイテムがJiraに存在しなくなった場合(または単にJQLフィルターと一致しなくなった場合)AirFocusでアーカイブになります。
• 「自動同期」を有効にすると、インテグレーションは10分ごとと、ワークスペースにアクセスするたびに自動的に同期されます。
• ビュー ログをクリックして、ジラ インテグレーションアクティビティのログをビューし、最後の同期前にどんな変更があったか確認してください。

地図アイテムリンクタイプ

JiraとAirfocus間で「ブロック」「重複」「関連」などのアイテムリンクタイプを双方向または一方通行の同期で行うことができます。リンクタイプに双方向(双方向)同期を設定すると、一方のプラットフォームでの更新は自動的にもう一方に反映され、手動で重複することなくタイムラインやロードマップへの依存関係を可視化できます。より具体的な業務フローでは、ワンウェイ同期を設定したり、複数のJiraリンクタイプを単一のAirfocusリンクタイプにマッピングしてデータを統合する方法があります。

アイテムリンクタイプをマッピングするには、以下のステップをフォローしてください:

1. 任意のairfocusページの右上から 「Extensions 」をクリックしてください。
2. 「管理インテグレーション」を選択します。
3. 「アクティブインテグレーション」でジ ラを選択してください。
4. 「アイテムリンクタイプマッピング」の中で、 +リンクタイプマッピングを追加をクリックします。
5. ドロップダウンを使って、左側にJira用のリンクタイプ、右側にエアフォーカスのリンクタイプを選択します。
6. 「方向」の矢印アイコンをクリックすると、同期が双方向か一方通行かを切り替えます。
7. オプションで、 +リンクタイプを追加 して、単一のエアフォーカスリンクタイプにマッピングする追加のJiraリンクタイプを追加できます。
   • 追加のリンクタイプを追加すると、AirFocusがJiraに同期すると、プライマリリンクタイプに同期されます。
8. ページ下部から 「更新」をクリックして同期してください 。

Item 関連や依存関係は、設定した設定に従ってJiraとAirFocus間で同期されます。
 

階層同期

Jiraの階層同期機能を使用すると、Jiraプロジェクトからairfocusへ親子関係を自動的に同期できます。これにより、 airfocusと Jira を切り替えることなく、最新の Jira 階層を確認しながらairfocusで ToDo プロダクト管理作業を行うことができます。

JiraのHierarchy同期を設定・有効化するには、以下が必要です:

• 階層が有効 airfocus 2つ以上のワークスペース、または同じワークスペース内で階層関係が可能なワークスペースが必要です。
• 2種類以上のJiraの問題タイプをAirFocusに同期させた場合。
• もし2つのワークスペースに2つのインテグレーションがあるなら、それぞれのワークスペースごとに1つのアイテムタイプを同期してください。
• もし1つのワークスペースに2つのインテグレーションがあるなら、そのワークスペース内のそれぞれのインテグレーションに対して1つのアイテムタイプを同期させます。

ユーザーがインテグレーションの変更を行うには、ワークスペースへの完全なアクセス権が必要です。

階層同期を設定するには、以下のステップをフォローしてください:

1. airfocusのワークスペース設定で、airfocus製品階層が他のワークスペースや現在のワークスペース内で有効になっていることを確認してください。
   
2. Jiraのインテグレーション設定ページの一番下で、「自動アイテムリンク」ウィジェットを切り替えます。
3. 以下を満たす任意のワークスペースを選択できます:
   • もう一方のワークスペースは現在のワークスペースと階層関係があります。
   • もう一つのワークスペースは、同じJiraインスタンスにJira インテグレーションを持っています。
   • ユーザーは他のワークスペースに完全にアクセスできます。
   • もう一つのワークスペースは同じairfocus teamにあります。

Hierarchy syncを有効にすると、Airfocusで親子関連を直接確認できます。

JiraのHierarchy同期を有効にする際、以下の点に注目してください:

• インテグレーションは同期したアイテム間の関係だけを追加し、追加アイテムは追加しません。 つまり、階層リンクが同期される前に、それぞれのインテグレーションによってアイテムが同期されている必要があります。
• Jira APIはEpicの子を表示せず、AirFocusがJira Epicに子の問題があるかどうかを検出できません。airfocusでchild関連を見るためには、epicがすでにairfocusに同期されていなければ、childrenのレベル問題を同期していなければ、すべての関連が正しくAirfocusに反映されません。

Jiraの階層同期も同じワークスペース内で設定可能です。複数のJira課題タイプが同じairfocus ワークスペースに同期され(単一のインテグレーションを通じて)、ワークスペース設定のHierarchy タブ内で「このワークスペース内で階層関係を許可」が有効になっている場合です。

ユーザーは、Jiraの階層同期を有効にするために、接続されたJiraプロジェクトへの少なくとも読み取りアクセスが必要です。

Jira データセンター/オンプレミス ユーザーの階層同期に関する注意:

• AirFocus階層はJiraのオンプレミスイニシアチブと同期しません。エピック、ストーリー、タスク、サブタスクだけが。
• airfocus階層は、イニシアチブ、エピック、ストーリー、タスク、サブタスクを含むすべてのJira Cloud レベルと同期しています。

追加情報

複数のJiraプロジェクトを接続する

同じJiraインスタンスから別のJiraプロジェクトをワークスペースに接続するには、再度認証プロセスを経る必要はありません。これからはインテグレーションのページに別のJiraプロジェクトインテグレーションを追加できます。 セットアップはインスタンスを選択してすぐにマッピングを開始するだけで済みます。

Jira Server 統合用にホワイトリストに登録する静的 IP アドレス

Jira Server などのオンプレミスのデプロイメント システムと統合する場合、IT チームはファイアウォールで airfocus を許可リストに登録して、airfocus がサーバーに接続してレコードを作成できるようにする必要があります。ポート443経由で接続できます。

チームは以下のIPアドレスを使って https://app.airfocus.com または https://app.us.airfocus.com を使用します:

• 46.101.71.101
• 46.101.69.142

チームが https://airfocus.app  以下のIPアドレスを使用します:

• 100.24.176.163
• 34.204.246.112
• 54.227.154.184
• 35.156.253.227
• 18.159.159.136
• 18.199.183.125

トラブルシューティング

• airfocus を Jira に接続しようとしているユーザーの権限が要件と一致していることを確認します。
• フィールドマッピングセクションで警告や欠落したフィールドがないか確認してください。
• インテグレーションの設定の一番下にある「デバッグ」ボタンをクリックしてください。 同期中に複数のAPIエンドポイントが呼び出されます。どちらかが失敗すると、どちらかを見極めるのは難しいです。デバッグダイアログにはすべての呼び出しとその結果が表示され、誤設定を見つけやすくなります。
• インテグレーションを削除して再インストールしてください。 ヒント:AirFocusをJiraに接続するためのアプリのリンク設定はそのままです。
• さらなるサポートが必要な方は、素敵なカスタマーサクセスチームにご連絡ください。

この記事へのフィードバックをお寄せください