Dzięki tej potężnej dwukierunkowej integracji połącz strategię produktową w Airfocus z wykonywaniem programistów w usłudze Azure DevOps. Elementy robocze można importować do airfocus i wpychać elementy airfocus — w tym eposy i funkcje — do platformy Azure DevOps, umożliwiając śledzenie ich stanu z poziomu airfocus, jednocześnie łącząc przepływy pracy zarządzania produktami, ramy ustalania priorytetów i mapy drogowe z codziennym rozwojem poprzez płynną synchronizację danych. Czytaj dalej, aby dowiedzieć się, jak skonfigurować i skonfigurować tę integrację.
Korzyści z integracji Azure DevOps
- Importuj elementy robocze usługi Azure DevOps do programu airfocus.
- Wciśnij elementy airfocus do usługi Azure DevOps (jak każdy typ elementu roboczego).
- Elastyczne filtrowanie (za pomocą usługi Azure DevOps Issue Search).
- Elastyczne mapowanie pól systemowych i niestandardowych z konfigurowalnymi kierunkami synchronizacji dla każdego pola.
- Bezpośrednio mapowaj opisy Azure DevOps na opisy airfocus.
- Wyświetlaj swoje iteracje (sprinty) w airfocus w kontekście dotyczącym wartości biznesowej i priorytetów.
Konfigurowanie integracji
Integracja w airfocus zawsze łączy się z jednym określonym obszarem roboczym airfocus. Do danego obszaru roboczego można dodać wiele integracji platformy Azure DevOps (na przykład z różnych projektów Azure DevOps lub dla różnych typów elementów roboczych).
Uwaga: U pewnij się, że konto Azure DevOps, z którym konfigurujesz integrację, jest przypisane do grupy uprawnień administratora kolekcji projektów, aby upewnić się, że masz dostęp na poziomie administratora do organizacji, którą chcesz zsynchronizować.
Aby skonfigurować integrację usługi Azure DevOps, wykonaj następujące kroki:
- Zarejestruj się w Airfocus lub zaloguj się na swoje istniejące konto.
- /utworz/ nowy obszar roboczy w airfocus lub wybierz ten, z którym chcesz zintegrować Azure DevOps.
- Kliknij opcję Rozszerzenia w prawym górnym rogu strony.
- Wybierz opcję Zarządzaj integracjami.
- Kliknij przycisk Połącz z kafelka " Azure DevOps ".
Od tego momentu kroki różnią się w zależności od typu instancji. Przeczytaj poniższe sekcje, aby zapoznać się z krokami dotyczącymi każdego z nich.
Połączenie z kontem usługi Azure DevOps Cloud
Aby kontynuować konfigurowanie integracji dla konta usługi Azure DevOps Cloud, wykonaj następujące kroki:
- Wybierz usługę Azure Cloud w selektorze typu instancji.
- Kliknij przycisk Kontynu uj.
Zostaniesz przekierowany do usługi Azure DevOps w celu uwierzytelnienia uprawnień dostępu, a po zalogowaniu się na konto zostaniesz przekierowany na stronę integracji airfocus w obszarze roboczym.
Upewnij się, że ustawienie " Dostęp do aplikacji innych firm za pośrednictwem OAuth " jest włączone na ekranie zasad organizacji w usłudze Azure DevOps, aby zapewnić pomyślną integrację.
Połączenie z kontem usługi Azure DevOps Server (on-premises)
Aby kontynuować konfigurowanie integracji dla konta usługi Azure DevOps Cloud, wykonaj następujące kroki:
- Wybierz opcję Azure On-Premise w selektorze typu instancji.
- Kliknij przycisk Kontynu uj.
- Wprowadź szczegóły, aby połączyć się z instancją usługi Azure DevOps Server.
- Podstawowy adres URL: Wprowadź pierwszą część adresu URL serwera Azure DevOps Server (wszystko przed końcem domeny/adresu IP i przed pierwszym ukośnikiem). Na przykład: https://198.254.533.325. Adres URL musi być dostępny przez nasze serwery, więc nie możesz tutaj używać lokalnie hostowanych adresów URL.
- O@@ sobisty token dostępu: Uzyskaj osobisty token dostępu, przechodząc do sekcji osobistych tokenów dostępu w ustawieniach zabezpieczeń użytkowników platformy Azure DevOps. Aby uzyskać więcej informacji, zobacz sekcję " Uzyskaj osobisty token dostępu " poniżej.
- Nazwa organizacji: Wprowadź dokładną nazwę organizacji Azure DevOps, którą chcesz zsynchronizować z airfocus.
- Kliknij Kontynuuj , aby połączyć zespół airfocus z organizacją Azure DevOps.
Uzyskaj osobisty token dostępu
Aby uzyskać osobisty token dostępu w usłudze Azure DevOps, wykonaj następujące kroki:
- Otwórz ustawienia ADO Security.
- Wybierz Osobiste tokeny dostępu z menu nawigacyjnego po lewej stronie strony.
- Kliknij + Nowy token u góry strony.
- /utworz/ nowy token z co najmniej następującymi uprawnieniami:
- Elementy pracy (czytanie i pisanie)
- Projekt i Zespół (przeczytaj)
- Osobiste tokeny dostępu można skonfigurować tak, aby były ważne przez maksymalny okres 1 roku. Pamiętaj, aby aktualizować ważność tokena, aby upewnić się, że integracja airfocus może działać bez żadnych przerw.
- Kliknij /utworz/.
- Skopiuj token i wklej go do ustawień integracji w airfocus.
Skonfiguruj filtry integracyjne
Aby skonfigurować filtry integracyjne:
- Wybierz projekt Azure DevOps, z którym chcesz zintegrować. Dodaj następujące informacje, aby airfocus wiedział, gdzie przenieść dane:
- Organizacja
- Projekt
- Obszar
- Opcjonalnie należy dołączyć elementy robocze wszystkich podobszarów wybranego obszaru, zaznaczając pole obok opcji " Dołącz elementy robocze wszystkich podobszarów wybranego obszaru ".
Możesz dodatkowo określić, które elementy robocze chcesz zsynchronizować za pomocą pola Wyszukiwarka problemów platformy Azure DevOps w ustawieniach integracji. Zapewnia szybkie i elastyczne wyszukiwanie wszystkich elementów pracy we wszystkich projektach (np. t: epicki I s:nowy).
Wspólne filtry
- Aby filtrować według typu elementu roboczego usługi Azure DevOps:
- t:epicki
- t: funkcja
- t:historia
- t:zadanie
Aby pobierać elementy z określonym tagiem Azure DevOps
- tagi:tag abc
Aby pobierać elementy z określoną iteracją usługi Azure DevOps.
- iteracja:iteracja abc
Przeczytaj więcej o wyszukiwaniu zaawansow anym tutaj.
Konfigurowanie mapowania pól
Użyj mapowania, aby określić, w jaki sposób informacje w usłudze Azure DevOps powinny być mapowane do airfocus (i odwrotnie). Nazwy elementów (wymagane) i opisy elementów (opcjonalnie) są zawsze domyślnie mapowane podczas konfigurowania nowej integracji.
Jak ustawić kierunki mapowania
Określ dla każdego z pól, czy chcesz synchronizować jednokierunkową, czy dwukierunkową synchronizację między polem w usłudze Azure DevOps a airfocus.
Ustaw kierunki mapowania dla wszystkich pól jednocześnie za pomocą menu rozwijanego „Ustaw kierunek”.
Domyślnie kierunek mapowania jest ustawiony z usługi Azure DevOps na tylko airfocus i może być zmieniany przez użytkownika na dowolny dostępny do mapowania.
Jak dodać nowe mapowanie pól
Po wybraniu pola z menu rozwijanego, tylko pola odpowiadające typowi pola są wyświetlane w rozwijanym menu na drugim końcu.
Po wybraniu dwóch pól, które chcesz zmapować, możesz wybrać opcje pól i sposób ich mapowania:
Automatyczne mapowanie pól
Podczas mapowania pól z wieloma opcjami włącz " Opcje pól automatycznej mapowania ", aby zaoszczędzić czas. Spowoduje to automatyczne mapowanie pól o tych samych wartościach zarówno w airfocus, jak i Azure DevOps.
Automatyczne generowanie wartości pola
Włącz opcję „Automatyczne opcje pól /utworz/”, aby automatycznie dodawać nowe pola /utworz/ w usłudze Azure DevOps do usługi AirFocus po ich dodaniu do elementu.
Uwaga: generator pól auto-/utworz/ nie rozróżnia wielkości liter.
Przegląd wszystkich dostępnych obecnie opcji mapowania pól
| Azure DevOps | airfocus | ADO → airfocus | airfocus → ADO |
| Nazwa wydania | Nazwa przedmiotu | ✅ | ✅ |
| Opis problemu | Opis przedmiotu | ✅ | ✅ ⚠️ Uwaga: 1 |
| Status problemu | Status/niestandardowe pole wyboru pojedynczego | ✅ | ✅ |
| Znaczniki wydania (dawne etykiety) | Niestandardowe pole wielokrotnego wyboru | ✅ | ✅ |
| Pole logiczne | Niestandardowe pole logiczne | ✅ | ✅ Uwaga: 2 |
| Pole tekstowe (pojedyncza linia) | Niestandardowe pole tekstowe | ✅ | ✅ Uwaga: 2 |
| Pole liczbowe (liczba całkowita, podwójna) Uwaga: 3 | Pole numerów niestandardowych | ✅ | ✅ Uwaga: 2 |
| Pole priorytetowe | Pole numerów niestandardowych | ✅ | ✅ Uwaga: 2 |
| Pole wysiłku | Pole numerów niestandardowych | ✅ | ✅ Uwaga: 2 |
| Pole listy wyboru tekstu z dozwolonymi wartościami niestandardowymi Uwaga: 4 |
Niestandardowe pole tekstowe | ✅ | ✅ Uwaga: 2 |
| Pole listy liczb z dozwolonymi wartościami niestandardowymi Uwaga: 4 |
Pole numerów niestandardowych | ✅ | ✅ Uwaga: 2 |
| Dowolna inna lista wyboru z wyłączonymi wartościami niestandardowymi Uwaga: 4 |
Niestandardowe pole wyboru pojedynczego | ✅ | ✅ Uwaga: 2 |
| Pole data-godzina Uwaga: 5 |
Niestandardowe pole daty | ✅ |
✅ ⚠️ |
| Pary pól data-godzina Uwaga: 7 |
Niestandardowe pole zakresu dat | ✅ | ✅ Uwaga: 2 |
| Iteracja/Sprint Start + Daty zakończenia | Niestandardowe pole zakresu dat | ✅ | ❌ |
| Nazwa iteracji/sprintu | Niestandardowe pole wyboru pojedynczego | ✅ | ✅ |
| Punkty fabularne (liczba) | Pole numerów niestandardowych | ✅ | ✅ |
| Priorytet zaległości (liczba) | Pole numerów niestandardowych | ✅ | ✅ |
| Ranking stosu (liczba) | Pole numerów niestandardowych | ✅ | ✅ Uwaga: 8 |
| Zależności | Zależności | ❌ | ❌ |
| Identyfikator problemu | Identyfikator przedmiotu | ❌ | ❌ |
| Kryteria akceptacji | ❌ | ❌ | ❌ |
| Załączniki | Załączniki | ❌ | ❌ |
Uwagi
- ⚠️ Jeśli opis jest zsynchronizowany w obu kierunkach, może to spowodować, że airfocus wprowadzi niewielkie zmiany w zawartości i formatowaniu opisów platformy Azure DevOps. Wynika to z faktu, że nie wszystkie style Azure DevOps są jeszcze natywnie obsługiwane w airfocus.
- Mapowanie w tym kierunku nie może być obsługiwane, jeśli pole docelowe w ADO jest skonfigurowane jako tylko do odczytu.
- Obejmuje to tylko niestandardowe pola numeryczne z ADO. Podczas gdy wszystkie pola numeryczne systemu muszą być zaimplementowane oddzielnie (na przykład Priorytet lub Wysiłek). Jeśli zatem jakieś pole numeryczne systemu nie jest jawnie wzmiankowane w tej tabeli - oznacza to, że nie jest jeszcze obsługiwane.
- Listy wyboru z dozwolonymi wartościami niestandardowymi nie nadają się do mapowania do pól wyboru airfocus, ponieważ liczba opcji wyboru jest w tym przypadku dynamiczna i może często zmieniać się w czasie, co wymagałoby ponownej konfiguracji mapowania integracji za każdym razem, gdy nowa wartość pojawi się na liście wyboru. Dlatego mapujemy takie listy wyboru na zwykłe pola tekstowe lub liczbowe w airfocus, więc wszelkie nowe wartości po stronie ADO są zawsze automatycznie synchronizowane ze stroną airfocus.
- Obejmuje to niestandardowe pola data-godzina, a także pola systemowe Data rozpoczęcia, Data docelowa, Data wykonania, Data rozwiązania i Data zmiany stanu.
- ⚠️ W tej chwili airfocus nie obsługuje pól daty i godziny (z częścią czasu), ale tylko pola daty. Dlatego mapowanie pól daty i godziny ADO na pola daty airfocus w obu kierunkach powoduje utratę części czasowej po stronie ADO - czas zostanie zresetowany przez airfocus do 00:00:00.
- W tej chwili ADO nie ma żadnych wbudowanych pól zakresu dat. Możliwe jest jednak zmapowanie pary dowolnych obsługiwanych pól daty i godziny ADO w polu ostrości z zakresu dat.
- Mapowanie pola Ranga stosu z airfocus z powrotem do usługi Azure DevOps może prowadzić do nieoczekiwanych zachowań. Dokumentacja firmy Microsoft zaleca, aby nie aktualizować tego pola ręcznie, ponieważ usługa Azure DevOps dynamicznie oblicza ranking stosów za kulisami, aby zachować priorytety zaległości. Najlepiej używać go jako synchronizacji jednokierunkowej z ADO do airfocus.
Synchronizacja hierarchii
Synchronizacja hierarchii dla usługi Azure DevOps umożliwia automatyczną synchronizację relacji rodzic-dziecko z projektu Azure DevOps do airfocus (na razie jednokierunkowa). Pozwala to na zarządzanie produktem w trybie airfocus, mając w zasięgu wzroku najnowszą hierarchię Azure DevOps bez konieczności przełączania się między airfocus a platformą Azure DevOps.
Aby skonfigurować/włączyć synchronizację hierarchii dla usługi Azure DevOps, potrzebujesz:
- Dwa lub więcej obszarów roboczych z włączoną hierarchią ostrości powietrznej lub obszar roboczy umożliwiający relacje hierarchii w tym samym obszarze roboczym.
- Dwa lub więcej typów elementów roboczych platformy Azure DevOps synchronizowanych z airfocus.
- Jeśli masz dwie integracje w dwóch obszarach roboczych, zsynchronizuj pojedynczy typ elementu dla każdego obszaru roboczego.
- Jeśli masz dwie integracje w jednym obszarze roboczym, zsynchronizuj pojedynczy typ elementu dla każdej z integracji w tym jednym obszarze roboczym.
Użytkownik potrzebuje pełnego dostępu do obszaru roboczego, aby zmienić cokolwiek w ustawieniach integracji.
Aby skonfigurować synchronizację hierarchii, wykonaj następujące kroki:
- W ustawieniach obszaru roboczego w Airfocus upewnij się, że hierarchia produktu airfocus jest włączona w innym lub w bieżącym obszarze roboczym.
- Na dole strony ustawień integracji Azure DevOps włącz widżet „Automatyczne łączenie elementów”.
- Aby zapewnić zachowanie hierarchii, upewnij się, że obszary robocze spełniają następujące warunki:
- Drugi obszar roboczy jest zintegrowany z tą samą organizacją Azure DevOps.
- Użytkownik ma pełny dostęp do drugiego obszaru roboczego.
- Drugie miejsce pracy znajduje się w tym samym Zespole Airfocus.
Po włączeniu synchronizacji hierarchii możesz zobaczyć relacje rodzic-dziecko bezpośrednio w airfocus.
Po włączeniu synchronizacji hierarchii w usłudze Azure DevOps należy zwrócić uwagę na następujące kwestie:
- Integracja dodaje tylko relacje między zsynchronizowanymi elementami, a nie dodatkowe elementy. Oznacza to, że elementy muszą zostać zsynchronizowane poprzez odpowiednią integrację przed synchronizacją łącza hierarchicznego.
- Synchronizację hierarchii dla usługi Azure DevOps można również skonfigurować w tym samym obszarze roboczym, jeśli wiele typów elementów roboczych platformy Azure DevOps jest synchronizowanych z tym samym obszarem roboczym airfocus (za pomocą pojedynczej lub wielu integracji) i włączono opcję „Zezwalaj na relacje hierarchii w tym obszarze roboczym” na karcie Hierarchia w ustawieniach obszaru roboczego.
Aby umożliwić synchronizację hierarchii dla usługi Azure DevOps, użytkownik wymagałby przynajmniej dostępu do odczytu do podłączonego projektu Azure DevOps.
Dodatkowe ustawienia
- Gdy włączona jest opcja " Archiwizuj nieznane problemy ", wcześniej zaimportowane elementy są archiwizowane w airfocus, jeśli nie są już obecne w usłudze Azure DevOps lub nie należą już do filtrów ustawionych do integracji.
- Gdy włączona jest funkcja " Automatyczna synchronizacja ", integracja synchronizuje się automatycznie co 10 minut i za każdym razem, gdy uzyskasz dostęp do obszaru roboczego.
- Kliknij opcję Wyświetl dzienniki , aby wyświetlić dzienniki panelu integracji Azure DevOps i sprawdzić, jakie zmiany wprowadzono przed ostatnią synchronizacją.
Aby zapisać ustawienia i zaimportować elementy do airfocus, kliknij Aktualizuj i synchronizuj.
Statyczne adresy IP do białej listy dla integracji z usługą Azure DevOps
Zespołu na https://app.airfocus.com lub https://app.us.airfocus.com Użyj następujących adresów IP:
- 46.101.71.101
- 46.101.69.142
Zespół na https://airfocus.app, Użyj następujących adresów 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
Ważne informacje
- Aby uwierzytelnić nową integrację z usługą Azure DevOps, używane konto Azure DevOps musi mieć dostęp na poziomie administratora.
- Modyfikowanie istniejącej integracji w airfocus wymaga jedynie posiadania peł nych uprawnień do obszaru roboczego.
- Nawet jeśli użytkownik airfocus nie ma dostępu do konta Azure DevOps użytego do wstępnej konfiguracji, konto Azure DevOps musi zachować te same uprawnienia, aby zapewnić, że integracja działa przez cały czas.
- Jeśli synchronizacja dwukierunkowa była wcześniej aktywowana, zostanie ona zastosowana do wszystkich mapowań, jeśli to możliwe. W przeciwnym razie zostanie ustawiony jako jeden sposób z Azure DevOps do airfocus.
- Jeśli włączono opcję " Pokaż opis Azure DevOps ", integracja zsynchronizuje opis ze specjalnym polem tylko do odczytu do 31 marca 2023 r. Użytkownicy muszą ręcznie przeprowadzić migrację do nowego mapowania pól opisu w sekcji mapowania pól swoich integracji. Od 1 kwietnia 2023 r. pole opisu specjalnego (i jego przełącznik) nie będzie już dostępne.
Przekaż opinię na temat tego artykułu
Masz opinię na temat tego artykułu? Opowiedz nam o swoich doświadcz eniach tutaj.