Osoby: Administratorzy systemu Jira
Abonamenty: Wszystkie abonamenty Miro (dla integracji z Jira Server/Data Center przez OAuth 1.0)
Platformy: Przeglądarka, aplikacja komputerowa (do procedur konfiguracji)
Aby zapewnić, że Twoje karty Jira na tablicy Miro są zawsze aktualne, Miro musi otrzymywać wiadomości z Jira za każdym razem, gdy dochodzi do zmian danych. Te zdarzenia Jira są przekazywane do Miro za pomocą webhoka.
Ten przewodnik przedstawia dwa sposoby tworzenia webhooków dla Jira Server i Jira Data Center za pomocą OAuth 1.0 i OAuth2.0.
Automatyczne tworzenie webhoka
Podczas konfigurowania integracji kart Jira, jeśli łączysz się z serwerem Jira lub Jira Data Center, możesz pozostawić opcję Automatycznie utwórz webhook włączoną. Jest to zalecana metoda.
✏️ Automatyczne tworzenie webhooków wymaga zalogowania się do Jira jako administrator systemu Jira.
Ustawienia kart Jira, Krok 2: "Automatycznie utwórz webhook" jest włączona
Po automatycznym utworzeniu webhooka dobrą praktyką jest przejście do strony WebHooks w Jira i edycja webhooka, aby nadać mu unikalną nazwę. Jest to szczególnie ważne, jeśli planujesz podłączyć kilka zespołów Miro do swojej instancji Jira.
✏️ W przypadku połączeń OAuth2.0, połączenie po stronie Miro jest ustawiane na poziomie firmy. Jeden webhook jest tworzony dla wszystkich zespołów Miro.
✏️ W przypadku połączeń OAuth 1.0 na poziomie zespołu Miro, webhook jest tworzony dla każdego zespołu. Na poziomie firmy Miro, jeden webhook jest tworzony dla wszystkich zespołów.
Utwórz webhooka ręcznie
Jeśli wolisz lub potrzebujesz utworzyć webhooka ręcznie, wykonaj te kroki.
Uzyskaj URL webhooka z Miro
- W ustawieniach kart Jira w Miro (Krok 2, podczas łączenia z Jira Server/Data Center) odznacz opcję Twórz webhook automatycznie.
- Skopiuj i wklej URL Twojej organizacji Jira i kliknij Połącz i zapisz ustawienia.
Ustawienia kart Jira, Krok 2: "Twórz webhook automatycznie" jest wyłączony - Zezwól na połączenie integracji w Jira, gdy zostaniesz o to poproszony.
- Po wykonaniu tych kroków Miro dostarczy Ci adres URL webhooka:
Adres URL webhooka dostarczony przez Miro
✏️ Jeśli nie jesteś administratorem systemu Jira, skopiuj adres URL webhooka dostarczony przez Miro i przekaż go administratorowi systemu Jira, aby mógł utworzyć webhook po stronie Jira, korzystając z poniższych instrukcji.
Tworzenie webhooka w Jira
Poniżej znajdują się kroki do utworzenia webhooka w Jira za pomocą URL uzyskanego z Miro. Możesz również odwołać się do oficjalnej dokumentacji Atlassian dla Jira Server oraz Jira Cloud (choć ten artykuł skupia się na Server/Data Center).
- Aby przejść do strony Webhooki w Jira, wybierz Zarządzanie Jira > System > Zaawansowane > Webhooki (dokładna ścieżka może nieznacznie się różnić w zależności od wersji Jira). Alternatywnie możesz często użyć bezpośredniego linku, dodając
/plugins/servlet/webhooksdo URL Twojej instancji Jira (np.https://TwojaNazwaInstancjiJira/plugins/servlet/webhooks). - Kliknij Utwórz webhook w prawym górnym rogu strony Webhooki.
- Wpisz opisową nazwę dla webhooka (np. "Webhook integracji Miro").
- Ustaw status webhooka na Włączony.
- Wklej skopiowany z ustawień Miro URL Webhooka w pole URL.
Konfiguracja systemowa webhooków w Jira - W sekcji Zdarzenia, pod Zadanie, wybierz zdarzenia zaktualizowane i usunięte.
- Kliknij Utwórz, aby zapisać webhook.
Ustawienia zdarzeń webhooka Jira - Po utworzeniu webhooku w Jira, wróć do Kroku 2 w ustawieniach kart Jira w Miro, upewnij się, że URL Jira jest poprawnie wypełniony, i kliknij Połącz.
Teraz webhook jest utworzony i skonfigurowany. Karty Jira na Twoich tablicach Miro będą aktualizowały się automatycznie po dokonaniu zmian w Jira.