이 강력한 양방향 통합을 사용하여 airfocus 의 제품 전략과 Azure DevOps의 개발 실행을 연결하세요. 작업 항목을 airfocus 으로 가져오고 에픽 및 기능을 포함한 airfocus 항목을 Azure DevOps로 푸시하여 원활한 데이터 동기화를 통해 제품 관리 워크플로, 우선 순위 지정 프레임워크 및 로드맵을 일상적인 개발과 연결하면서 airfocus 에서 해당 상태를 추적할 수 있습니다. 이 통합을 설정하고 구성하는 방법을 알아보려면 계속 읽어보세요.
Azure DevOps 통합 사용의 이점
- Azure DevOps 작업 항목을 airfocus 으로 가져옵니다.
- airfocus 항목을 Azure DevOps에 푸시합니다(모든 작업 항목 유형으로).
- 유연한 필터링(Azure DevOps 이슈 검색을 통해).
- 필드별로 동기화 방향을 구성할 수 있는 시스템 및 사용자 지정 필드에 대한 유연한 매핑.
- Azure DevOps 설명을 airfocus 설명에 직접 매핑하세요.
- 비즈니스 가치와 우선순위에 대한 컨텍스트를 위해 반복(스프린트)을 airfocus 에 표시하세요.
통합 설정
airfocus 의 통합은 항상 하나의 특정 airfocus 워크스페이스에 연결됩니다. 주어진 작업 공간에 여러 Azure DevOps 통합을 추가할 수 있습니다(예: 다른 Azure DevOps 프로젝트 또는 다른 작업 항목 유형에 대해).
참고: 동기화하려는 조직에 대한 관리자 수준의 액세스 권한이 있는지 확인하려면 통합을 설정하려는 Azure DevOps 계정이 프로젝트 컬렉션 관리자 권한 그룹에 할당되어 있는지 확인하세요.
Azure DevOps 통합을 설정하려면 다음 단계를 따르세요:
- airfocus 에 가입하거나 기존 계정에 로그인하세요.
- airfocus 에서 새 작업 영역을 만들거나 Azure DevOps를 통합할 작업 영역을 선택하세요.
- 페이지 오른쪽 상단에서 확장 프로그램을 클릭합니다.
-
통합 관리를 선택합니다.
- "Azure DevOps" 타일에서 연결을 클릭합니다.
여기서부터 인스턴스 유형에 따라 단계가 달라집니다. 각 단계에 대한 자세한 내용은 아래 섹션을 참조하세요.
Azure DevOps Cloud 계정에 연결
Azure DevOps Cloud 계정에 대한 통합을 계속 설정하려면 다음 단계를 따르세요:
- 인스턴스 유형 선택기에서 Azure Cloud를 선택합니다.
- 계속을 클릭합니다.
액세스 권한을 인증하기 위해 Azure DevOps로 리디렉션되며, 계정에 로그인하면 작업 공간의 airfocus 통합 페이지로 리디렉션됩니다.
성공적인 통합을 위해 Azure DevOps의 조직 정책 화면에서 "OAuth를 통한 타사 애플리케이션 액세스" 설정이 켜져 있는지 확인하세요.
Azure DevOps Server(온-프레미스) 계정에 연결하기
Azure DevOps Cloud 계정에 대한 통합을 계속 설정하려면 다음 단계를 따르세요:
- 인스턴스 유형 선택기에서 Azure 온-프레미스를 선택합니다.
- 계속을 클릭합니다.
- Azure DevOps Server 인스턴스에 연결하려면 세부 정보를 입력합니다.
- 기본 URL: Azure DevOps Server URL의 첫 번째 부분(도메인/IP 주소의 끝 부분과 첫 번째 백슬래시 앞까지의 모든 부분)을 입력합니다. 예: https://198.254.533.325. URL은 당사 서버에서 액세스할 수 있어야 하므로 로컬로 호스팅된 URL은 사용할 수 없습니다.
- 개인 액세스 토큰: 개인 액세스 토큰: Azure DevOps 사용자 보안 설정의 개인 액세스 토큰 섹션으로 이동하여 개인 액세스 토큰을 받습니다. 자세한 내용은 아래의 "개인 액세스 토큰 얻기" 섹션을 참조하세요.
- 조직 이름: 동기화하려는 Azure DevOps 조직의 정확한 이름을 입력하세요 airfocus.
- 계속을 클릭하여 airfocus 팀을 Azure DevOps 조직에 연결합니다.
개인 액세스 토큰 얻기
Azure DevOps에서 개인 액세스 토큰을 얻으려면 다음 단계를 따르세요:
- ADO 보안 설정을 엽니다.
- 페이지 왼쪽의 탐색 메뉴에서 개인 액세스 토큰을 선택합니다.
- 페이지 상단에서 + 새 토큰을 클릭합니다 .
- 최소한 다음 권한이 있는 새 토큰을 만듭니다:
- 작업 항목(읽기 및 쓰기)
- 프로젝트 및 팀(읽기)
- 개인 액세스 토큰은 최대 1년 동안 유효하도록 구성할 수 있습니다. airfocus 연동이 중단 없이 작동할 수 있도록 토큰의 유효기간을 최신 상태로 유지하는 것을 잊지 마세요.
- 만들기를 클릭합니다.
- 토큰을 복사하여 airfocus 의 연동 설정에 붙여넣습니다.
통합 필터 구성
통합 필터를 구성하려면 다음과 같이 하세요:
- 통합하려는 Azure DevOps 프로젝트를 선택합니다. airfocus 에서 데이터를 푸시할 위치를 알 수 있도록 다음 정보를 추가합니다:
- 정리
- 프로젝트
- 영역
- 선택 사항으로 선택한 영역의 모든 하위 영역의 작업 항목을 포함하려면 "선택한 영역의 모든 하위 영역의 작업 항목 포함" 옆의 확인란을 선택합니다.
통합 설정의 Azure DevOps 이슈 검색 필드를 사용하여 동기화할 작업 항목을 추가로 지정할 수 있습니다. 모든 프로젝트의 모든 작업 항목에 대해 빠르고 유연한 검색 기능을 제공합니다(예 t:epic AND s:new).
공통 필터
- Azure DevOps 작업 항목 유형별로 필터링하려면 다음과 같이 하세요:
- 티:에픽
- t:기능
- t:story
- t:task
특정 Azure DevOps 태그가 있는 항목을 가져오려면 다음과 같이 하세요.
- 태그:태그 ABC
특정 Azure DevOps 반복이 있는 항목을 가져오는 방법.
- 반복:반복 ABC
여기에서 고급 검색에 대해 자세히 알아보세요.
필드 매핑 구성
매핑을 사용하여 Azure DevOps의 정보를 airfocus (또는 그 반대로)에 매핑하는 방법을 정의하세요. 새 연동 서비스를 설정할 때 항목 이름(필수)과 항목 설명(선택)은 항상 기본적으로 매핑됩니다.
매핑 방향을 설정하는 방법
각 필드에 대해 Azure DevOps의 필드와 airfocus 사이의 단방향 동기화를 원하는지 또는 양방향 동기화를 원하는지 정의합니다.
'방향 설정' 드롭다운을 사용하여 모든 필드에 대한 매핑 방향을 한 번에 설정합니다.
기본적으로 매핑 방향은 Azure DevOps에서 airfocus 로만 설정되어 있으며 사용자가 매핑에 사용할 수 있는 모든 것으로 변경할 수 있습니다.
새 필드 매핑을 추가하는 방법
드롭다운에서 필드를 선택하면 필드 유형과 일치하는 필드만 다른 쪽의 드롭다운에 표시됩니다.
매핑하려는 두 필드를 선택한 후 필드 옵션과 매핑 방법을 선택할 수 있습니다:
필드 자동 매핑
옵션이 많은 필드를 매핑할 때는 "필드 자동 매핑 옵션(" )을 켜면 시간을 절약할 수 있습니다. 이렇게 하면 airfocus 및 Azure DevOps 모두에서 동일한 값을 가진 필드가 자동으로 매핑됩니다.
필드 값 자동 생성
"필드 자동 만들기 옵션(" )을 켜면 Azure DevOps에서 만든 새 필드가 항목에 추가될 때 airfocus 에 자동으로 추가됩니다.
참고: 자동 생성 필드 생성기는 대소문자를 구분하지 않습니다.
현재 사용 가능한 모든 필드 매핑 옵션 개요
| Azure DevOps | 에어포커스 | ADO → airfocus | airfocus → ADO |
| 이슈 이름 | 항목 이름 | ✅ | ✅ |
| 문제 설명 | 항목 설명 | ✅ | ✅ ⚠️ 참고: 1 |
| 이슈 상태 | 상태 / 사용자 지정 단일 선택 필드 | ✅ | ✅ |
| 이슈 태그(이전 레이블) | 사용자 지정 다중 선택 필드 | ✅ | ✅ |
| 부울 필드 | 사용자 지정 부울 필드 | ✅ | ✅ 참고: 2 |
| 텍스트 필드(한 줄) | 사용자 지정 텍스트 필드 | ✅ | ✅ 참고: 2 |
| 숫자 필드(정수, 이중) 참고: 3 | 사용자 지정 번호 필드 | ✅ | ✅ 참고: 2 |
| 우선순위 필드 | 사용자 지정 번호 필드 | ✅ | ✅ 참고: 2 |
| 노력 필드 | 사용자 지정 번호 필드 | ✅ | ✅ 참고: 2 |
| 허용된 사용자 지정 값이 있는 텍스트 선택 목록 필드 참고: 4 |
사용자 지정 텍스트 필드 | ✅ | ✅ 참고: 2 |
| 허용된 사용자 지정 값이 있는 숫자 선택 목록 필드 참고: 4 |
사용자 지정 번호 필드 | ✅ | ✅ 참고: 2 |
| 사용자 지정 값이 비활성화된 다른 모든 선택 목록 참고: 4 |
사용자 지정 단일 선택 필드 | ✅ | ✅ 참고: 2 |
| 날짜/시간 필드 참고: 5 |
사용자 지정 날짜 필드 | ✅ |
✅ ⚠️ |
| 날짜-시간 필드 쌍 참고: 7 |
사용자 지정 날짜 범위 필드 | ✅ | ✅ 참고: 2 |
| 반복/스프린트 시작 + 종료 날짜 | 사용자 지정 날짜 범위 필드 | ✅ | ❌ |
| 반복/인쇄 이름 | 사용자 지정 단일 선택 필드 | ✅ | ✅ |
| 스토리 포인트(숫자) | 사용자 지정 번호 필드 | ✅ | ✅ |
| 백로그 우선순위(숫자) | 사용자 지정 번호 필드 | ✅ | ✅ |
| 스택 순위(숫자) | 사용자 지정 번호 필드 | ✅ | ✅ 참고: 8 |
| 종속성 | 종속성 | ❌ | ❌ |
| 발급 ID | 항목 ID | ❌ | ❌ |
| 승인 기준 | ❌ | ❌ | ❌ |
| 첨부 파일 | 첨부 파일 | ❌ | ❌ |
메모
- ⚠️ 설명이 양방향으로 동기화되는 경우, 이로 인해 airfocus Azure DevOps 설명의 콘텐츠 및 형식이 약간 변경될 수 있습니다. 이는 아직 airfocus 에서 모든 Azure DevOps 스타일이 기본적으로 지원되는 것은 아니기 때문입니다.
- ADO의 대상 필드가 읽기 전용으로 구성된 경우 이 방향의 매핑은 지원되지 않습니다.
- 여기에는 ADO의 사용자 지정 숫자 필드만 포함됩니다. 시스템 숫자 필드는 별도로 구현해야 하지만(예: 우선순위 또는 노력), 시스템 숫자 필드는 별도로 구현해야 합니다. 따라서 이 표에 시스템 숫자 필드가 명시적으로 언급되지 않은 경우 아직 지원되지 않는다는 의미입니다.
- 허용된 사용자 지정 값이 있는 선택 목록은 airfocus 선택 필드에 매핑하는 데 적합하지 않습니다. 이 경우 선택 옵션의 양은 동적이며 시간이 지남에 따라 자주 변경될 수 있으므로 선택 목록에 새 값이 나타날 때마다 통합 매핑을 다시 구성해야 하기 때문입니다. 따라서 이러한 선택 목록을 airfocus 의 일반 텍스트 또는 숫자 필드에 매핑하여 ADO 측의 모든 새 값이 항상 airfocus 측에 자동으로 동기화되도록 합니다.
- 여기에는 사용자 지정 날짜/시간 필드와 시스템 필드인 시작 날짜, 목표 날짜, 마감 날짜, 해결 날짜 및 상태 변경 날짜가 포함됩니다.
- ⚠️ 현재 airfocus 은 날짜-시간 필드(시간 부분 포함)는 지원하지 않고 날짜 필드만 지원합니다. 따라서 ADO 날짜-시간 필드를 airfocus 날짜 필드에 양방향으로 매핑하면 ADO 측의 시간 부분이 손실되어 airfocus 시간이 00:00:00로 재설정됩니다.
- 현재 ADO에는 날짜 범위 필드가 내장되어 있지 않습니다. 그러나 지원되는 모든 ADO 날짜-시간 필드 쌍을 날짜 범위 airfocus 필드에 매핑할 수 있습니다.
- 스택 순위 필드를 airfocus 에서 Azure DevOps로 다시 매핑하면 예기치 않은 동작이 발생할 수 있습니다. Azure DevOps는 백로그 우선 순위를 유지하기 위해 백그라운드에서 스택 순위를 동적으로 계산하므로 Microsoft 설명서에서는 이 필드를 수동으로 업데이트하지 말 것을 권장합니다. ADO에서 airfocus 로의 단방향 동기화로 사용하는 것이 가장 좋습니다.
계층 구조 동기화
Azure DevOps용 계층 동기화를 사용하면 Azure DevOps 프로젝트에서 airfocus (현재는 단방향)으로 부모-자식 관계를 자동으로 동기화할 수 있습니다. 이렇게 하면 airfocus 에서 제품 관리 작업을 수행하면서 airfocus 과 Azure DevOps 사이를 전환할 필요 없이 최신 Azure DevOps 계층 구조를 볼 수 있습니다.
Azure DevOps용 계층 동기화를 설정/사용하려면 다음이 필요합니다:
- 두 개 이상의 워크스페이스 사이에 airfocus 계층구조가 활성화된 워크스페이스 또는 동일한 워크스페이스 내에서 계층구조 관계를 허용하는 워크스페이스입니다.
- airfocus 에 동기화된 두 개 이상의 Azure DevOps 작업 항목 유형.
- 두 개의 워크스페이스에 두 개의 통합이 있는 경우 각 워크스페이스에 대해 단일 항목 유형을 동기화합니다.
- 하나의 작업 공간에 두 개의 통합이 있는 경우 해당 작업 공간의 각 통합에 대해 단일 항목 유형을 동기화합니다.
통합 설정에서 변경하려면 사용자가 워크스페이스에 대한 전체 액세스 권한이 있어야 합니다.
계층 동기화를 설정하려면 다음 단계를 따르세요:
- airfocus 의 워크스페이스 설정에서 airfocus 제품 계층 구조가 다른 워크스페이스 또는 현재 워크스페이스 내에서 활성화되어 있는지 확인합니다.
- Azure DevOps 통합 설정 페이지 하단에서 '자동 항목 연결' 위젯을 전환합니다.
- 계층 구조가 유지되도록 하려면 워크스페이스가 다음 사항을 충족하는지 확인하세요:
- 다른 작업 공간은 동일한 Azure DevOps 조직에 통합되어 있습니다.
- 사용자는 다른 작업 공간에 대한 전체 액세스 권한이 있습니다.
- 다른 워크스페이스는 같은 airfocus 팀에 있습니다.
계층 구조 동기화를 활성화하면 airfocus 에서 부모-자식 관계를 직접 확인할 수 있습니다.
Azure DevOps에서 계층 구조 동기화를 사용하도록 설정할 때 다음 사항에 유의하세요:
- 통합은 동기화된 항목 간의 관계만 추가할 뿐 추가 항목은 추가하지 않습니다. 즉, 계층 구조 링크가 동기화되기 전에 이미 각각의 통합에 의해 항목이 동기화되어야 합니다.
- 여러 Azure DevOps 작업 항목 유형이 동일한 airfocus 작업 공간에 동기화되고(단일 또는 여러 통합을 통해) 작업 공간 설정의 계층 탭에서 '이 작업 공간 내에서 계층 관계 허용'을 사용 설정한 경우 동일한 작업 공간 내에서 Azure DevOps의 계층 동기화를 구성할 수도 있습니다.
Azure DevOps의 계층 동기화를 사용하려면 연결된 Azure DevOps 프로젝트에 대한 읽기 권한 이상이 필요합니다.
추가 설정
- "알 수 없는 문제 보관" 을 사용하도록 설정하면 이전에 가져온 항목이 더 이상 Azure DevOps에 없거나 통합을 위해 설정된 필터에 더 이상 해당하지 않는 경우 airfocus 에 보관됩니다.
- "자동 동기화" 를 사용 설정하면 10분마다 그리고 워크스페이스에 액세스할 때마다 통합이 자동으로 동기화됩니다.
-
로그 보기를 클릭하여 Azure DevOps 통합 활동 로그를 보고 마지막 동기화 전에 어떤 변경 사항이 있었는지 확인합니다.
설정을 저장하고 airfocus 로 항목을 가져오려면 업데이트 및 동기화를 클릭합니다.
Azure DevOps 통합을 위해 화이트리스트에 추가할 정적 IP 주소
팀 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일부터 특별 설명 필드(및 해당 토글)는 더 이상 사용할 수 없습니다.
이 문서에 관한 피드백 공유
이 문서와 관련해 공유하고 싶은 피드백이 있으신가요? 여기에서 사용 경험을 말씀해 주세요.