Zintegruj airfocus z Jira

Napisane przez:  Morgan T
Ostatnia aktualizacja:  

Połącz swoją strategię produktową w airfocus z realizacją rozwoju w Jira, korzystając z tej potężnej dwukierunkowej integracji. Elementy robocze można importować do airfocus i wpychać elementy airfocus — w tym eposy i funkcje — do Jira, 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

Połącz przepływy pracy zarządzania produktami, ramy ustalania priorytetów i mapy drogowe z codziennym rozwojem, płynnie synchronizując dane między airfocus i Jira. Integracja jest kompatybilna z Jira Cloud, Jira Server i Jira Data Center.

  • Importuj problemy Jira (jako elementy) do airfocus.
  • Wciśnij elementy airfocus do Jira (jak każdy typ problemu).
  • Dwukierunkowa synchronizacja & elastyczne filtrowanie (niestandardowe JQL).
  • Elastyczne mapowanie pól.
  • Wyświetlaj wyniki priorytetów airfocus w Jira, aby uzyskać kontekst związany z wartością biznesową i priorytetami.
  • Umiejętność widzenia relacji rodzic-dziecko bezpośrednio w airfocus.

Wymagania

  • W airfocus: użytkownik musi mieć „pełne” uprawnienia do obszaru roboczego, dla którego chce skonfigurować integrację Jira.
  • W Jira: do nawiązania link aplikacji między instancją Jira a airfocus Zespół wymagane są uprawnienia „Administrator”.
  • Jeśli link aplikacji między instancją Jira i zespołem airfocus zostało już nawiązane, każdy użytkownik Jira mający co najmniej uprawnienie „Create_Issue” w projekcie może skonfigurować nowe integracje z tą instancją.
  • Nasza integracja Jira jest kompatybilna z Jira Cloud, Jira Server i Jira Data Center. Obsługujemy wszystkie wersje serwera Jira wymienione w Polityce dotyczącej zakończenia eksploatacji pomocy technicznej firmy Atlassian. Wersje wcześniejsze niż wymienione tam osiągnęły koniec życia (EOL) i mogą działać, ale nie są obsługiwane.

Konfigurowanie integracji Jira

  1. Zarejestruj się w Airfocus lub zaloguj się na swoje istniejące konto. 
  2. /utworz/ nowy obszar roboczy w airfocus lub wybierz ten, z którym chcesz zintegrować Jira.
    • Autoryzację instancji Jira należy wykonać tylko raz dla każdego zespołu airfocus.
    • Do danego obszaru roboczego można dodać wiele integracji Jira (na przykład z różnych projektów lub instancji Jira).
  3. Kliknij opcję Rozszerzenia w prawym górnym rogu obszaru roboczego.
  4. Wybierz opcję Zarządzaj integracjami.
  5. Kliknij Połącz na kafelku " Jira ".
  6. Wybierz opcję Połącz nową instancję Jira z wyświetlonego menu rozwijanego.
  7. Wprowadź podstawowy adres URL instancji Jira (np. https://airfocustest.atlassian.net/ lub https://jira.mycompany.com).
  8. Kliknij przycisk Kontynu uj.
  9. Skopiuj „Adres URL aplikacji”. Będziesz tego potrzebować do następnych kroków w Jira.
  10. Kliknij Centrum link aplikacji Jira , aby otworzyć Centrum łączy aplikacji Jira.
    • Aby uzyskać dostęp do tej strony, musisz być administratorem w Jira. 

Kolejne kroki różnią się dla Jira Cloud i Jira Server/Data Center. Sprawdź poniższą sekcję, aby kontynuować swoją instancję.

Konfigurowanie filtrowania integracji

  1. Wybierz projekt, który chcesz zsynchronizować. Możesz wpisać, aby filtrować listę projektów.
    • Projekty, które można zobaczyć, ale nie posiadają uprawnień CREATE_ISSUES, są oznaczone jako takie (dostępne tylko dla Jira Cloud).
    • Nazwa Twojej integracji to /utworz/ automatycznie na podstawie projektu. Możesz go również zmienić później.
  2. Wybierz typ problemu, który chcesz zsynchronizować. 
    • Ponieważ pola mogą się różnić w zależności od typu zgłoszenia (w zależności od wersji Jira i rodzaju projektu, np. zarządzanego przez zespół lub zarządzanego przez firmę), ta opcja filtruje pola, które można mapować na pola, które są faktycznie dostępne w wybranym typie zgłoszenia.
    • Jeśli chcesz zsynchronizować wiele typów problemów, zalecamy skonfigurowanie jednej integracji w tym samym obszarze roboczym lub w kilku obszarach roboczych. Integracje z innych obszarów roboczych (np. Epics lub Podzadania) można łączyć za pomocą hierarchii airfocus.
    • Możesz także filtrować zsynchronizowane problemy jeszcze bardziej, podając zapytanie JQL w filtrze problemów (przeczytaj więcej o JQL tutaj).
Plik integrate-with-jira-5.png

Mapa pola airfocus i Jira

Użyj mapowania, aby zdefiniować, w jaki sposób informacje w Jira powinny być mapowane do informacji w airfocus. Jeśli zmienisz problem lub element w jednym systemie, drugi system zostanie odpowiednio dostosowany.

Można na przykład określić, w jaki sposób statusy Jira powinny być mapowane do pól typu single select airfocus i/lub sposób, w jaki etykiety Jira powinny być mapowane do pól wielokrotnego wyboru airfocus.

Istnieje również wiele innych opcji mapowania różnych pól niestandardowych i systemowych Jira do pól airfocus.

Kiedy spojrzysz na opcje mapowania pól, zobaczysz, że domyślnie mapowane są dwa pola: nazwy elementów i opisy elementów.

Dla każdego z pól można określić, czy ma być synchronizacja jednokierunkowa, czy dwukierunkowa synchronizacja między polem w Jira a Airfocus.

Plik integrate-with-jira-6.png

Możesz ustawić kierunki mapowania dla wszystkich pól jednocześnie (o ile jest to technicznie możliwe) za pomocą przycisku „Ustaw kierunek”.

Domyślnie kierunek mapowania jest ustawiony z Jira na tylko airfocus i może być zmieniany przez użytkownika na dowolny dostępny do mapowania.

Plik integrate-with-jira-7.png

Podczas konfigurowania nowego mapowania dla jednego z pól okaże się, że możesz mapować pole Jira na pola airfocus tylko wtedy, gdy oba końce mają ten sam typ pola.

Podczas wybierania pola w rozwijanym menu, tylko pola odpowiadające typowi pola będą 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.

Przegląd wszystkich typów pól, które można mapować

Odwzorowalne pola systemowe Jira:

Jira airfocus Jira → airfocus airfocus → Jira
Nazwa wydania Nazwa przedmiotu
Opis problemu Opis przedmiotu ⚠️
Status Status/niestandardowe pole wyboru pojedynczego
Etykiety Niestandardowe pole wielokrotnego wyboru
Utworzono Niestandardowe pole daty ✅ (tylko data)
Zaktualizowano Niestandardowe pole daty ✅ (tylko data)
Kryteria akceptacji
Osoby przypisane Osoby/Osoby odpowiedzialne ⚠️ ⚠️
Zgłaszający Osoby/Osoby odpowiedzialne ⚠️ ⚠️
Załączniki Załączniki
(Początek/Termin) Pole Data (jako para) Niestandardowe pole zakresu dat
(Początek/Termin) Pole Data Niestandardowe pole daty
Zależności Zależności
Popraw wersję Niestandardowe pole wielokrotnego wyboru
Popraw wersję Kamień milowy (wielokrotny wybór)
Popraw wersję Okres czasowy
Wersja naprawcza (najnowsza) Niestandardowe pole wyboru pojedynczego
Wersja naprawcza (najnowsza) Niestandardowe pole wielokrotnego wyboru
Napraw datę wydania wersji Niestandardowe pole daty
Identyfikator problemu Identyfikator przedmiotu
Typ problemu Niestandardowe pole wyboru pojedynczego
Wielokrotne pole wyboru Niestandardowe pole wielokrotnego wyboru
Pole priorytetowe Niestandardowe pole wyboru pojedynczego
Sprinty Pole Okres czasowy
Sprint (ID) Niestandardowe pole wielokrotnego wyboru
Sprint (nazwa) Niestandardowe pole tekstowe
Sprint (daty) Niestandardowe pole zakresu dat
Sprint (najnowszy) Niestandardowe pole wyboru pojedynczego
Zespół Field Niestandardowe pole wyboru pojedynczego

⚠️ Ostrzeżenie dotyczące synchronizacji dwukierunkowej dla pola opisu: Proces synchronizacji dwukierunkowej może spowodować niewielkie zmiany w zawartości i formatowaniu opisów Jira. Wynika to z faktu, że nie wszystkie style Jiry są jeszcze natywnie obsługiwane w airfocus.

⚠️ Ostrzeżenia dotyczące mapowania pól osób: Logika mapowania opiera się na nazwach wyświetlanych. Dlatego " Kirsten " w Jira NIE odwzorowuje się na " Kirst " w airfocus, mimo że oba konta używają tego samego adresu e-mail.

W przypadku, gdy Jira zezwala tylko na jedną wartość w polu osób (np. może mieć tylko 1 przypisanego), synchronizacja z airfokusem faworyzuje pierwszą wartość dla mapowanego pola osób z airfocus. Na przykład bilet w Jira przypisany do " Julian " zastąpi element w airfokusu przypisany do " Juliana i Nikity ". Nikita zostanie usunięta i tylko Julian zostanie przydzielony.

Odwzorowalne pola niestandardowe Jira:

Jira airfocus Jira → airfocus airfocus → Jira airfocus ↔ Jira
Pojedyncze pole wyboru Niestandardowe pole wyboru pojedynczego
Wielokrotne pole wyboru Niestandardowe pole wielokrotnego wyboru
Pole daty Niestandardowe pole daty (zakres dat, jeśli jest mutliple)
Pole tekstowe (bez tekstu sformatowanego) Niestandardowe pole tekstowe
Pole tekstowe wzbogacone Opis przedmiotu/pole opisu airfocus ⚠️ ⚠️
Pole liczbowe Pole numerów niestandardowych
Pole liczbowe Wynik ocen priorytetowych
Etykiety Niestandardowe pole wielokrotnego wyboru

Rozwiązywanie problemów: Znajdź pole zakresu dat

Potrzebujemy co najmniej dwóch pól daty (oprócz wersji poprawionych), aby móc je mapować do pola zakresu dat airfocus.

Nasza integracja może wykryć pola daty tylko wtedy, gdy są widoczne na zsynchronizowanym typie problemu (ekran). Musisz upewnić się, że na typie problemu (ekran) w Jira znajdują się co najmniej dwa pola daty, a co najmniej jedno pole zakresu dat jest dostępne do mapowania w obszarze roboczym Airfocus.

Jak to wygląda w Jira:

  • w przypadku zarządzania przez Jira Cloud Zespół przejdź do ustawień projektu > typy zgłoszeń i przeciągnij pole z prawego paska bocznego na listę pól na środku.
  • w przypadku Jira Cloud zarządzanego przez firmę (i serwera Jira Server) przejdź do ustawień projektu > problemy > i edytuj ekran typu problemu, który synchronizujesz. Możesz dodać dodatkowe pola daty u dołu.

Automatyczne mapowanie pól

Podczas mapowania pól z wieloma opcjami włącz " Opcje pól automatycznej mapowania ", aby zaoszczędzić czas. Automatycznie odwzorowuje pola o tych samych wartościach zarówno w airfocus, jak i Jira.

Plik integrate-with-jira-9.png

Automatyczne generowanie wartości pola

Włącz opcję „Automatyczne opcje pól /utworz/”, aby nowe pola /utworz/ w Jira były automatycznie dodawane do airfocus po ich dodaniu do elementu. 

Plik integrate-with-jira-10.png

Uwaga: generator pól auto-/utworz/ nie rozróżnia wielkości liter.

Jak zmapować wynik ostrości za pomocą Jira

Dzięki integracji Airfocus z Jira możesz używać airfocus do ustalania priorytetów i map drogowych, podczas gdy programiści (i inni) używają Jira do codziennego planowania rozwoju.

Domyślnie pokazujemy już dane airfocus, takie jak wyniki priorytetów, pasy ruchu i linie czasu w Jira. W tym artykule pomocy opisano, w jaki sposób można mapować wynik ostrości airfocus za pomocą niestandardowego pola Jira (które można również filtrować w Jira).

Odwzorowując wynik ostrości airfocus z projektem Jira, będziesz mógł pokazać swój priorytet numer jeden dokładnie tam, gdzie ludzie pracują — na każdej zsynchronizowanej karcie wydania Jira i na okładce karty emisji. W ten sposób cały Twój Zespół będzie zgrany i skupiony na zadaniach, które są istotne.

Plik integrate-with-jira-11.png

Aby wyświetlić wynik ostrości w Jira, musisz zmapować go za pomocą niestandardowego pola Jira. Pole niestandardowe musi mieć typ pola " Pole numeryczne ". Konfigurowanie tego zajmuje około 3 minut.

Oto jak:

  1. Wewnątrz Jira kliknij ikonę koła zębatego w prawym górnym rogu, aby otworzyć ustawienia.
  2. Kliknij pozycję Problemy.
  3. Wybierz P ola niestandardowe z menu nawigacyjnego po lewej stronie.
  4. Kliknij /utworz/ pole niestandardowe w prawym górnym rogu.
  5. Wybierz pole Num ber jako typ pola.
  6. Wpisz nazwę i opis (opcjonalnie).
  7. Kliknij /utworz/.
  8. Skojarzenie nowego pola niestandardowego z ekranami (zsynchronizowanego projektu)
    Plik integrate-with-jira-19.png
  9. Wróć do ustawień integracji Jira w Airfocus i wybierz nowe pole niestandardowe /utworz/ z listy rozwijanej
    Plik integrate-with-jira-20.png

Wynik ostrości airfocus pojawi się teraz w przypadku problemów z Jira
 

Jeśli chcesz również pokazać wynik ostrości na okładkach kart, wykonaj następujące kroki:

  1. Kliknij ikonę z trzema kropkami w prawym górnym rogu tablicy.
  2. Wybierz ustawienia tablicy.
  3. Kliknij Układ karty z menu nawigacyjnego po lewej stronie.
  4. Wybierz pole niestandardowe wyniku ostrości z listy rozwijanej.
  5. Kliknij Dodaj.
  6. Teraz na tablicy znajdziesz także wynik skupienia.
    Plik integrate-with-jira-24.png

Skonfiguruj dodatkowe ustawienia

  • Gdy " Archiwizuj nieznane problemy " jest włączona, wówczas wcześniej zaimportowane elementy zostaną zarchiwizowane w airfocus, jeśli nie są już obecne w Jira (lub po prostu nie pasują już do filtru JQL).
  • Gdy włączona jest funkcja " Automatyczna synchronizacja ", integracja będzie automatycznie synchronizowana 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 Jira i sprawdzić, jakie zmiany zostały wprowadzone przed ostatnią synchronizacją.

Synchronizacja hierarchii

Synchronizacja hierarchii dla Jira umożliwia automatyczną synchronizację relacji rodzic-dziecko z projektu Jira z airfocus. Pozwala to na wykonywanie prac związanych z zarządzaniem produktem na airfocus, jednocześnie mając w zasięgu wzroku najnowszą hierarchię Jira bez konieczności przełączania między airfocus a Jira.

Aby skonfigurować/włączyć synchronizację hierarchii dla Jira, potrzebujesz:

  • Dwie lub więcej przestrzeni roboczych z włączoną hierarchią AirFocus LUB przestrzeń robocza, która zezwala na relacje hierarchiczne w obrębie tej samej przestrzeni roboczej.
  • Dwa lub więcej typów problemów Jira synchronizowanych z airfokusem.
  • 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 integracji.

Aby skonfigurować synchronizację hierarchii, wykonaj następujące kroki:

  1. W ustawieniach obszaru roboczego w Airfocus upewnij się, że hierarchia produktu airfocus jest włączona w innym lub w bieżącym obszarze roboczym.
    Plik integrate-with-jira-26.png
  2. Na dole strony ustawień integracji Jira włącz widżet „Automatyczne łączenie elementów”.
  3. Możesz wybrać dowolny obszar roboczy, który spełnia następujące wymagania:
    • Drugi obszar roboczy ma hierarchiczną relację do bieżącego obszaru roboczego.
    • Drugi obszar roboczy ma integrację Jira z tą samą instancją Jira.
    • 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.

Plik integrate-with-jira-28.png

Podczas włączania synchronizacji hierarchii dla Jira 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ę, zanim nastąpi synchronizacja łącza hierarchicznego.
  • Interfejs API Jira nie ujawnia dzieci eposu, co oznacza, że zapobiega wykryciu, czy epos Jira ma jakieś problemy z dziećmi. Aby zobaczyć relacje dzieci w airfocus, epos musi być już zsynchronizowany z airfokusem podczas synchronizacji problemów na poziomie dzieci, aby wszystkie relacje były poprawnie odzwierciedlone w airfocus.

Synchronizację hierarchii dla Jira można również skonfigurować w tym samym obszarze roboczym, jeśli wiele typów problemów Jira 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.

Użytkownik wymaga przynajmniej dostępu do odczytu podłączonego projektu Jira, aby włączyć synchronizację hierarchii dla Jira.

Uwaga dotycząca synchronizacji hierarchii dla użytkowników centrum danych Jira/on-prem:

  • Hierarchia airfocus nie synchronizuje się z inicjatywami Jira on-Prem. Tylko eposy, historie, zadania i zadania podrzędne.
  • Hierarchia airfocus synchronizuje się ze wszystkimi poziomami chmury Jira, w tym inicjatywami, eposami, historiami, zadaniami i podzadaniami.

Dodatkowe informacje

Połącz wiele projektów Jira

Aby połączyć inny projekt Jira z tej samej instancji Jira z obszarem roboczym, nie musisz ponownie przechodzić przez proces uwierzytelniania. Od teraz możesz dodać kolejną integrację projektu Jira na stronie integracji. Konfiguracja wymaga tylko wybrania instancji i natychmiastowego rozpoczęcia mapowania.

Statyczne adresy IP do białej listy dla integracji Jira Server

Jeśli integrujesz się z lokalnym systemem wdrożeniowym, takim jak Jira Server, Twój zespół IT może musieć zezwolić na list airfocus w zaporze, aby airfocus mógł nawiązywać połączenia z Twoim serwerem do rekordów /utworz/. Możesz nawiązać połączenie przez port 443.

Zespół na https://app.airfocus.com lub https://app.us.airfocus.com korzysta z 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

Rozwiązywanie problemów

  • Sprawdź, czy uprawnienia użytkownika próbującego podłączyć airfocus z Jira odpowiadają wymaganiom.
  • Sprawdź ostrzeżenia lub brakujące pola w sekcji mapowania pól.
  • Kliknij przycisk " Debugowanie " u dołu ustawień integracji. Podczas synchronizacji wywoływanych jest kilka punktów końcowych API. Jeśli jeden z nich zawiedzie, trudno powiedzieć, który z nich. Okno dialogowe debugowania pokazuje wszystkie połączenia i ich wyniki, aby ułatwić znalezienie błędnej konfiguracji.
  • Usuń i ponownie zainstaluj integrację. Wskazówka: Konfiguracja link aplikacji łączącej Airfocus z Jira pozostaje taka sama.
  • Skontaktuj się z naszym wspaniałym Zespołem Obsługi Klienta, aby uzyskać dodatkowe wsparcie.

Przekaż opinię na temat tego artykułu

Masz opinię na temat tego artykułu? Opowiedz nam o swoich doświadcz eniach tutaj.

Czy znalazłeś to, czego szukałeś?

Nadal masz pytanie lub chcesz podzielić się tym, czego się nauczyłeś? Odwiedź naszą Społeczność   aby uzyskać pomoc i współpracować z innymi.