Osoby: Administratorzy systemu Jira
Wersje: Wszystkie wersje Miro (dla integracji Jira Server/Data Center za pośrednictwem OAuth 1.0)
Platformy: Przeglądarka, aplikacja komputerowa (dla procedur konfiguracji)
Aby zapewnić aktualność swoich kart Jira na tablicy Miro, Miro musi otrzymywać wiadomości z Jira, gdy tylko nastąpią zmiany danych. Te zdarzenia Jira są przesyłane do Miro za pośrednictwem webhooka.
Ten przewodnik oferuje dwa sposoby tworzenia webhooków dla Jira Server i Jira Data Center przy użyciu OAuth 1.0 i OAuth2.0.
Utwórz webhook automatycznie
Podczas konfigurowania integracji kart Jira, jeśli łączysz się z Jira Server lub Jira Data Center, możesz pozostawić opcję Automatycznie utwórz webhook włączoną. To jest zalecana metoda.
✏️ Automatyczne tworzenie webhooka wymaga zalogowania się do Jira jako Administrator systemu Jira.
Ustawienia kart Jira, Krok 2: „Automatycznie utwórz webhook” jest włączony
Po automatycznym utworzeniu webhooka warto przejść do strony WebHooków Jira i edytować webhook, aby nadać mu unikalną nazwę. Jest to szczególnie ważne, jeśli planujesz połączyć kilka zespołów Miro z instancją Jira.
✏️ Dla połączeń OAuth2.0 połączenie po stronie Miro ustawiane jest na poziomie firmy. Dla wszystkich zespołów Miro tworzony jest jeden webhook.
✏️ Dla połączeń OAuth 1.0 na poziomie zespołu Miro, dla każdego zespołu tworzony jest osobny webhook. Na poziomie firmy Miro tworzony jest jeden webhook dla wszystkich zespołów.
Ręczne tworzenie webhooka
Jeśli wolisz lub musisz utworzyć webhooka ręcznie, wykonaj te kroki.
Uzyskaj URL webhooka z Miro
- W ustawieniach kart Jira w Miro (Krok 2 przy połączeniu z Jira Server/Data Center) odznacz opcję Automatycznie utwórz webhook.
- Skopiuj i wklej URL Jira swojej organizacji i kliknij Połącz i zapisz ustawienia.
Ustawienia kart Jira, Krok 2: "Automatycznie utwórz webhook" jest wyłączone - Pozwól na integrację w Jira, gdy zostaniesz o to poproszony.
- Po tych krokach Miro udostępni Ci URL WebHooka:
URL WebHooka dostarczony przez Miro
✏️ Jeśli nie jesteś administratorem systemu Jira, skopiuj podany przez Miro URL WebHooka i przekaż go swojemu administratorowi systemu Jira, aby mogli utworzyć webhooka po stronie Jira, korzystając z poniższych instrukcji.
Tworzenie webhooka w Jira
Poniżej znajdują się kroki do utworzenia webhooku w Jira przy użyciu URL pozyskanego z Miro. Możesz również zapoznać się z oficjalną dokumentacją Atlassian dotyczącą Jira Server oraz Jira Cloud (choć ten artykuł koncentruje się na Server/Data Center).
- Aby przejść do strony WebHooks w Jira, przejdź do Jira Administration > System > Advanced > WebHooks (dokładna ścieżka może się nieznacznie różnić w zależności od wersji Jira). Alternatywnie, możesz często użyć bezpośredniego linku, dodając
/plugins/servlet/webhooksdo adresu URL instancji Jira (np.https://YourJiraInstanceName/plugins/servlet/webhooks). - Kliknij Utwórz WebHook w prawym górnym rogu strony WebHooks.
- Wpisz opisową Nazwę dla WebHooka (np. "Miro Integration Webhook").
- Ustaw stan WebHooka na Włączony.
- Wklej URL webhooks skopiowany z ustawień Miro do pola URL.
Konfiguracja webhooks w systemie Jira - W sekcji Zdarzenia, pod Problem, wybierz zdarzenia zaktualizowane i usunięte.
- Kliknij Utwórz, aby zapisać webhook.
Ustawienia zdarzeń webhooka Jira - Po utworzeniu webhooka w Jira, wróć do kroku 2 w ustawieniach kart Jira w Miro, upewnij się, że Twoje URL Jira jest poprawnie wypełnione i kliknij Połącz.
Webhook został teraz utworzony i skonfigurowany. Karty Jira na Twoich tablicach Miro będą aktualizowane automatycznie, gdy wprowadzane są zmiany w Jira.
Webhooki na poziomie organizacji
UWAGA: Jeśli webhooki na poziomie zespołu były ograniczone za pomocą filtrów JQL (na przykład do konkretnych projektów), webhook na poziomie organizacji musi odzwierciedlać wszystkie te filtry JQL lub nie mieć żadnego filtra. Przejrzyj swoje wymagania dotyczące JQL przed migracją do ustawień na poziomie organizacji.
W ustawieniach administratora organizacji, po skonfigurowaniu połączenia, znajdziesz URL webhooka pod połączonymi instancjami. Skopiuj ręczny webhook i wklej go do środowiska Jira.