この強力な双方向インテグレーションを使って、AirFocusのプロダクト戦略とAzure DevOpsの開発実行を結びつけましょう。 作業項目を airfocus にインポートし、airfocus 項目 (エピックや機能を含む) を Azure DevOps にプッシュすることで、シームレスなデータ同期を通じてプロダクト管理業務フロー、優先順位付けフレームワーク、ロードマップを日々の開発に接続しながら、airfocus からそれらの状態を追跡できるようになります。 このインテグレーションの設定方法を読み進めてください。
Azure DevOps インテグレーションを使用する利点
- Azure DevOps 作業項目を airfocus にインポートします。
- AirFocusのアイテムをAzure DevOps(どの作業項目タイプと同様に)にプッシュしてください。
- Flexible フィルター(Azure DevOps Issue Search経由)。
- システムおよびカスタムフィールドの柔軟なマッピングと、フィールドごとに同期方向を設定できます。
- Azure DevOpsの説明を直接AirFocusの説明にマッピングしてください。
- ビジネス価値や優先事項に関する文脈を得るために、反復(スプリント)をAirFocusで表示してください。
インテグレーションを設置しろ
AirFocusのインテグレーションは常に特定のAirfocusワークスペースに接続します。 複数のAzure DevOps インテグレーションを、あるワークスペースに追加できます(例えば、異なるAzure DevOpsプロジェクトや異なる作業項目タイプに対して)。
注: インテグレーションを設定するAzure DevOpsアカウントがProject Collection Administrator権限グループに割り当てられているか確認し、同期したい組織に対してアカウント管理者レベルのアクセス権を持っていることを確認してください。
Azure DevOps インテグレーションを設定するには、以下のステップをフォローしてください:
- AirFocusに登録するか、既存のアカウント にログイン してください 。
- AirFocusで新しいワークスペースを作成するか、Azure DevOpsを統合したいワークスペースを選択してください。
- ページ右上から 拡張機能 をクリックしてください。
-
「管理インテグレーション」を選択します。
- 「Azure DevOps」タイルから 「接続 」をクリックしてください。
ここからは、インスタンスの種類によって手順が異なります。各ステップについては以下のセクションをお読みください。
Azure DevOps Cloudアカウントに接続
Azure DevOps Cloudアカウントのインテグレーションの設定を続けるには、以下のステップをフォローしてください:
- インスタンスタイプセレクターで Azure Cloud を選択します。
- 「 進む」をクリックしてください。
アクセス権限の認証のためにAzure DevOpsにリダイレクトされ、アカウントにログインするとワークスペースのairfocus インテグレーションページにリダイレクトされます。
Azure DevOpsの組織ポリシー画面で「Third-party application access via OAuth」の設定をオンにしておき、成功させるインテグレーションを確実にしてください。
Azure DevOps Server(オンプレミス)アカウントに接続してください
Azure DevOps Cloudアカウントのインテグレーションの設定を続けるには、以下のステップをフォローしてください:
- instance type selectorで Azure On-Premise を選択してください。
- 「 進む」をクリックしてください。
- Azure DevOps Serverインスタンスに接続するための詳細を入力してください。
- ベースURL:Azure DevOps Server URLの最初の部分(ドメインやIPアドレスの終わりまでのすべての部分、そして最初のバックスラッシュの前)を入力してください。例えば:https://198.254.533.325。URLは当社のサーバーでアクセス可能である必要があるため、ここではローカルホストのURLを使うことはできません。
- 個人用アクセス トークン: Azure DevOps ユーザーのセキュリティ設定の個人用アクセス トークンのセクションに移動して、個人用アクセス トークンを取得します。詳細については、以下の「個人アクセス トークンの取得」セクションを参照してください。
- 組織名:AirFocusと同期したいAzure DevOps組織の正確な名前を入力してください。
- 「 進む」 をクリックして、airfocus チームをAzure DevOps組織に接続してください。
個人アクセストークンを取得してください
Azure DevOpsで個人アクセストークンを取得するには、以下のステップをフォローしてください:
- ADO セキュリティ設定を開きます。
- ページ左側のナビゲーションメニューから パーソナルアクセストークン を選択します。
- ページ上部から+新しいトークンをクリックしてください。
- 少なくとも次の権限を持つ新しいトークンを作成します。
- 作業項目（読み取りと書き込み）
- プロジェクトとチーム(読みます)
- パーソナルアクセストークンは最大1年間有効に設定可能です。トークンの有効性を常に最新の状態に保ち、airfocusインテグレーションが中断なく動作するようにしましょう。
- 「作成」をクリックします。
- トークンをコピーして、エアフォーカスのインテグレーション設定に貼り付けます。
統合フィルターを構成する
インテグレーションフィルターの設定方法:
- 統合したいAzure DevOpsプロジェクトを選択してください。AirFocusがデータをどこに送るべきか分かるように、以下の情報を追加してください:
- 組織
- プロジェクト
- エリア
- 選択されたエリアのすべてのサブエリアの作業項目を含めることで、「選択されたエリアのすべてのサブエリアの作業項目を含める」のボックスにチェックを入れることも可能です。
Azure DevOps Issue Searchのインテグレーション設定欄で同期したい作業項目をさらに指定できます。 すべてのプロジェクト上の作業項目を高速かつ柔軟に検索できます(例:t:epic AND s:new).
一般的なフィルター
- To filter by the Azure DevOps work item type:
- T:エピック
- t:feature(特徴的)です
- t:ストーリー
- t:タスク
特定のAzure DevOpsタグを持つアイテムをプルするには
- タグ:タグabc
特定のAzure DevOpsイテレーションでアイテムを取り込むために。
- 反復:反復abc
高度な検索については こちらをご覧ください。
フィールドマッピングの設定をしてください
マッピングを使って、Azure DevOpsの情報をAirFocusにどのようにマッピングするか(またはその逆)を定義しましょう。アイテム名(必須)とアイテム説明(任意)は、新しいインテグレーションを設定する際にデフォルトで必ずマッピングされます。
マッピング方向の設定方法
Azure DevOpsとairfocusのフィールド間で、各フィールドごとに一方同期か双方向同期かを定義してください。
「Set direction」ドロップダウンですべてのフィールドのマッピング方向を一度に設定できます。
デフォルトでは、マッピング方向は Azure DevOps から airfocus のみに設定されており、ユーザーはマッピングに使用可能な任意の方向に変更できます。
新しいフィールドマッピングの追加方法
ドロップダウンでフィールドを選択すると、反対側のドロップダウンにはそのフィールドタイプに合致するフィールドだけが表示されます。
マッピングしたいフィールドを2つ選んだら、フィールドのオプションとマッピング方法を選択できます:
自動写像フィールド
多くのオプションを持つフィールドをマッピングする際は、「フィールドオプションの自動マッピング」をオンにして時間を節約しましょう。これにより、airfocusとAzure DevOpsの両方で同じ値のフィールドが自動的にマッピングされます。
フィールド値生成の自動生成
「Auto-create field options」をオンに切り替えると、Azure DevOpsで作成した新しいフィールドがアイテムに追加された際に自動的にairfocusに追加されます。
注:自動生成フィールドジェネレーターは大文字を区別しません。
現在利用可能なすべてのフィールドマッピングオプションの概要
| Azure DevOps | airfocus | 空中フォーカス→ADO | エアフォーカス→ADO |
| 号名 | アイテム名 | ✅ | ✅ |
| 問題の説明 | アイテム説明 | ✅ | ✅ ⚠️ 注:1 |
| 発行状況 | ステータス/カスタムシングルセレクトフィールド | ✅ | ✅ |
| イシュータグ(旧レーベル) | カスタムマルチセレクトフィールド | ✅ | ✅ |
| ブール体 | カスタムブールフィールド | ✅ | ✅ 注: 2 |
| テキストフィールド(単線) | カスタムテキストフィールド | ✅ | ✅ 注: 2 |
| 数体(整数、二重)注:3 | カスタムナンバーフィールド | ✅ | ✅ 注: 2 |
| 優先度フィールド | カスタムナンバーフィールド | ✅ | ✅ 注: 2 |
| エフォートフィールド | カスタムナンバーフィールド | ✅ | ✅ 注: 2 |
| 許可されたカスタム値付きのテキストピックリストフィールド 注:4 |
カスタムテキストフィールド | ✅ | ✅ 注: 2 |
| 許可されたカスタム値を含む番号ピックリストフィールド 注:4 |
カスタムナンバーフィールド | ✅ | ✅ 注: 2 |
| 無効化されたカスタム値を持つ他のピックリスト 注:4 |
カスタムシングルセレクトフィールド | ✅ | ✅ 注: 2 |
| 日付-時刻フィールド 注:5 |
カスタム日付フィールド | ✅ |
✅ ⚠️ |
| 日付-時刻フィールドのペア 注:7 |
カスタム日付範囲フィールド | ✅ | ✅ 注: 2 |
| イテレーション/スプリントの開始日 + 終了日 | カスタム日付範囲フィールド | ✅ | ❌ |
| 反復/スプリント名 | カスタムシングルセレクトフィールド | ✅ | ✅ |
| ストーリーポイント(番号) | カスタムナンバーフィールド | ✅ | ✅ |
| バックログ優先度(番号) | カスタムナンバーフィールド | ✅ | ✅ |
| スタックランク（数値） | カスタムナンバーフィールド | ✅ | ✅ 注: 8 |
| 依存関係 | 依存関係 | ❌ | ❌ |
| 問題ID | アイテムID | ❌ | ❌ |
| 受理基準 | ❌ | ❌ | ❌ |
| 添付ファイル | 添付ファイル | ❌ | ❌ |
メモ
- ⚠️ 説明が双方向で同期されている場合、airfocus によって Azure DevOps の説明の内容と書式がわずかに変更される可能性があります。これは、すべての Azure DevOps スタイルがまだ airfocus でネイティブにサポートされているわけではないためです。
- ADO のターゲット フィールドが読み取り専用として構成されている場合、この方向のマッピングはサポートされません。
- これにはADOのカスタム数値フィールドのみが含まれます。一方で、システム内の数値フィールド(例えば優先度や努力)は別々に実装する必要があります。したがって、このテーブルにシステム数値フィールドが明示的に記載されていない場合、それはまだサポートされていないことを意味します。
- 許可されたカスタム値を持つピックリストは、エアフォーカスセレクトフィールドへのマッピングには適していません。なぜなら、この場合のセレクトオプションの数は動的で時間とともに頻繁に変化するため、新しい値がピッキングリストに現れるたびにインテグレーションのマッピングを再構成する必要があるからです。 そのため、エアフォーカスではそのようなピックリストを通常のテキストや数字フィールドにマッピングし、ADO側の新しい値は自動的にエアフォーカス側に同期されます。
- これにはカスタムの日付・時刻フィールドや、システムフィールドのスタート日、目標日、期限日、解決日、状態変更日が含まれます。
- ⚠️ 現時点では、airfocus は日時フィールド (時間部分を含む) をサポートしておらず、日付フィールドのみをサポートしています。したがって、ADO の日付/時刻フィールドを airfocus の日付フィールドに両方向にマッピングすると、ADO 側の時刻部分が失われ、時刻は airfocus によって 00:00:00 にリセットされます。
- 現時点でADOには組み込みの日付範囲フィールドはありません。しかし、サポートされている任意のADO日付・時刻フィールドのペアを日付範囲のエアフォーカスフィールドにマッピングすることは可能です。
- airfocusのスタックランクフィールドをMicrosoft Azure DevOpsにマッピングすると、予期しない動作が発生する可能性があります。 Microsoft ドキュメント化では、このフィールドを手動で更新することは推奨していません。Microsoft Microsoft Azure DevOps は、バックログの優先順位を維持するために、バックグラウンドでスタックのランキングを動的に計算するためです。 これは、ADOからairfocusへの一方向同期として使用するのが最適です。
階層同期
Azure DevOpsのHierarchy Syncは、Azure DevOpsプロジェクトからAirfocusへの親子関係を自動的に同期させることができます(現時点では一方通行です)。これにより、AirFocusとAzure DevOpsを切り替えることなく、最新のAzure DevOps階層を確認しながらAirFocusでToDo作業を進めることができます。
Azure DevOpsの階層同期を設定・有効化するには、以下の条件が必要です:
- エアフォーカス階層が有効である2つ以上のワークスペース、または同じワークスペース内で階層関係が可能なワークスペースが必要です。
- 2つ以上のAzure DevOps作業項目タイプをairfocusに同期させてください。
- もし2つのワークスペースに2つのインテグレーションがあるなら、それぞれのワークスペースごとに1つのアイテムタイプを同期してください。
- もし1つのワークスペースに2つのインテグレーションがあるなら、そのワークスペース内のそれぞれのインテグレーションに対して1つのアイテムタイプを同期させます。
ユーザーがインテグレーションの設定を変更するには、ワークスペースへの完全なアクセス権が必要です。
階層同期を設定するには、以下のステップをフォローしてください:
- airfocusのワークスペース設定で、airfocus製品階層が他のワークスペースや現在のワークスペース内で有効になっていることを確認してください。
- Azure DevOpsの設定ページ下部にあるインテグレーションの「自動アイテムリンク」ウィジェットを切り替えてください。
- 階層を維持するために、ワークスペースが以下の条件を満たしていることを確認しましょう。
- もう一つのワークスペースは同じAzure DevOps組織へのインテグレーションを持っています。
- ユーザーは他のワークスペースに完全にアクセスできます。
- もう一つのワークスペースは同じairfocus teamにあります。
Hierarchy syncを有効にすると、Airfocusで親子関連を直接確認できます。
Azure DevOpsでHierarchy syncを有効にする際、以下の点にご注意ください。
- インテグレーションは同期したアイテム間の関係だけを追加し、追加アイテム は追加しません 。 つまり、階層リンクが同期される前に、それぞれのインテグレーションでアイテムが同期されている必要があります。
- 同じ airfocus ワークスペースに複数の Azure DevOps 作業項目タイプを同期させ(単一のインテグレーションを通じて)、ワークスペース設定の Hierarchy タブ内の「Allow hierarchy relations in this workspaces」を有効にしている場合、同じワークスペース内で階層同期も設定可能です。
ユーザーはAzure DevOpsの階層同期を有効にするために、接続されたAzure DevOpsプロジェクトへの少なくとも読み取りアクセスが必要です。
追加設定
- 「archive unknown issues」が有効になると、以前インポートされたアイテムはAzure DevOpsに存在しなくなったり、インテグレーションのフィルターセットに含まれなくなった場合、airfocusでアーカイブされます。
- 「自動同期」を有効にすると、インテグレーションは10分ごとと、そしてワークスペースにアクセスするたびに自動的に同期されます。
-
ビュー ログをクリックして、Azure DevOps インテグレーション アクティビティログをビューし、最後の同期前にどんな変更があったか確認してください。
設定を保存し、アイテムをAirFocusにインポートするには、「 更新」をクリックして同期してください。
Static IP addresses to white-list for your Azure DevOps インテグレーション
https://app.airfocus.com か https://app.us.airfocus.com のチーム 以下のIPアドレスを使用します:
- 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
重要情報
- Azure DevOpsで新しいインテグレーションを作成・認証するには、使用するAzure DevOpsアカウントがアカウント管理者-レベルアクセス権を持っている必要があります。
- airfocusで既存のインテグレーションを修正するには、ユーザーがそのワークスペースに対して 完全な 権限を持つだけで済みます。
- たとえairfocusユーザーが初期設定に使ったAzure DevOpsアカウントにアクセスできなくても、Azure DevOpsアカウントはインテグレーションが常に動作するように同じ権限を保持しなければなりません。
- もし以前に双方向同期が有効になっていれば、可能な限りすべてのマッピングに適用されます。そうでなければ、Azure DevOpsからAirFocusへの一方向設定になります。
- 「Azure DevOps 説明を表示する」が有効になっていれば、インテグレーションは2023年3月31日までは特別な読み取り専用フィールドに説明を同期するだけです。 ユーザーはインテグレーションのフィールドマッピングセクションで新しい説明フィールドマッピングに手動移行する必要があります。 2023年4月1日より、特別説明欄(およびそのトグル)は利用できなくなりました。
この記事へのフィードバックをお寄せください
この記事に関するフィードバックはありますか？体験の内容についてこちらから教えてください。