Ten artykuł odpowiada na najpopularniejsze pytania dotyczące sposobu działania integracji z kartami Jira.
Jak działa uwierzytelnianie między Jira a Miro?
Zobacz artykuły w Centrum pomocy dotyczące
- Jira Server (instalowany lokalnie)
- Jira Data Center (instalowany lokalnie)
-
Jira Cloud
Wybierz na stronie ustawień kart Jira.- OAuth 2.0 (3LO)
Czy dane są zabezpieczone podczas przesyłania między Jira a Miro?
Używamy protokołu bezpieczeństwa TLS. Szyfruje on wiadomości HTTP przed wysłaniem i odszyfrowuje je po dotarciu. Obsługujemy też mutual TLS w abonamencie Enterprise.
Czy obsługujemy mutual TLS?
Tak, Dowiedz się więcej.
Czy Miro przechowa jakiekolwiek dane Jira klienta?
Tak. Miro przechowuje dane karty dodane do tablicy.
Jak długi jest okres retencji i jak dane będą zabezpieczone?
W przypadku OAuth 1.0 (Jira Server lub Data Center) dane są również aktualizowane, jeśli webhooki zostały skonfigurowane podczas procesu konfiguracji wtyczki Jira Cards. Okres retencji jest nieograniczony. Stosowane są wyłącznie ogólne protokoły bezpieczeństwa Miro.
Czy można ograniczyć informacje pobierane z Miro?
W dokumentacji Atlassian nie znaleźliśmy informacji o tym, jak ograniczyć pobierane dane tylko do kilku pól.
Czy można otrzymać schemat ilustrujący przepływ danych między Jira a Miro?
Szczegółowe informacje znajdziesz w tym artykule dla deweloperów Jira. Wdrażamy integrację zgodnie z dokumentacją Atlassian.
Jak obsługiwany jest token?
OAuth 1.0: Używany jest tylko token dostępu. Token dostępu pozostaje ważny przez 5 lat, chyba że zostanie unieważniony (brak możliwości dostosowania, ponieważ ta zasada jest określona po stronie Atlassian. Token można unieważnić po stronie Jira, korzystając z interfejsu sieciowego). Pamiętaj, że każdy nowy token powoduje przerwanie działania integracji i wymaga ponownego połączenia.
OAuth 2.0: Token dostępu jest ważny przez 1 godzinę. Token odświeżania jest ważny przez 90 dni (jeśli przez 90 dni nie będziesz korzystać z integracji, wymagane będzie ponowne uwierzytelnienie).
Czy jeden token dostępu jest używany do całego dostępu klienta w Jira?
Każdy użytkownik Miro, który zamierza importować, tworzyć lub edytować karty Jira, musi połączyć swoje indywidualne dane dostępowe do Jira. Wymienione działania można wykonywać wyłącznie przy użyciu indywidualnych danych dostępowych do Jira.
Jak są zabezpieczone tokeny żądań, tokeny dostępu, klucze prywatne oraz inne sekrety/poświadczenia OAuth?
W trakcie działania integracji używane są tylko tokeny dostępu. Są bezpiecznie przechowywane w bazie danych i wykorzystywane wyłącznie po stronie serwera.
Dla OAuth 1.0. (Jira Server i Data Center) authToken jest używany wyłącznie do webhooka. Nie jest to rzeczywisty token uwierzytelniający używany przez OAuth. Żądania są wysyłane przez zaszyfrowane połączenie. Klucz tajny jest generowany automatycznie i powiązany z danym zespołem.
Jakich endpointów używa integracja?
POST /rest/api/2/issue - create new issue
PUT /rest/api/2/issue/id - update issue
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
Dla OAuth 1.0 (Jira Server i Data Center) dodatkowo używamy:
POST /rest/webhooks/1.0/webhook
Czy karty będą działać z Jira Datacenter?
Tak. Zostaliśmy zatwierdzeni przez Atlassian i już wielu klientów z powodzeniem korzysta z kart Jira z Datacenter. Procedura instalacji jest taka sama.
Jakich adresów IP używacie do komunikacji z systemem Jira?
Listę naszych statycznych adresów IP znajdziesz tutaj.
Zwróć uwagę, że są to adresy używane wyłącznie do komunikacji z systemem Jira. Adresy IP aplikacji Miro są dynamiczne i, aby wszystkie funkcje na tablicach Miro (w tym niektóre powiązane z kartami Jira) działały poprawnie, dodaj nasze domeny do listy dozwolonych.
Czy możemy zintegrować Jira z Miro, ale zablokować zgłoszenia Jira, których poziom zabezpieczeń ustawiony jest na „Private”?
Nie, to nie jest możliwe. Poziomy zabezpieczeń w Jira nie są powiązane z Miro.
Czy możesz połączyć Miro z Jira, jeśli korzystasz z Jira Server?
Ponieważ Miro jest narzędziem online, możesz połączyć się z Jira tylko wtedy, gdy Twoja instancja jest dostępna w publicznym internecie.
Czy można jednocześnie połączyć kilka instancji Jira?
Tak. Pamiętaj jednak, że podłączenie instancji Jira polega na nawiązaniu początkowego połączenia, natomiast aktywne połączenie oznacza powiązaną instancję będącą aktualnie w użyciu. Aktywne połączenie określa, skąd importowane są karty Jira po otwarciu aplikacji Jira Cards oraz do której instancji użytkownicy mają autoryzację. Dla danego użytkownika w danym momencie może istnieć tylko jedno (1) aktywne połączenie. Przy użyciu OAuth 2.0 użytkownik może edytować dowolną kartę Jira powiązaną z dowolną instancją, do której jest już uwierzytelniony. W przypadku innego protokołu uwierzytelniania cały zespół korzysta ze wspólnej aktywnej instancji i może importować oraz wchodzić w interakcję wyłącznie z kartami z tej instancji. Możesz zdefiniować wiele ustawień na poziomie organizacji i przełączać się między aktywnymi połączeniami na poziomie zespołu.
Jak wygląda proces migracji z Jira Server do Jira Cloud?
Ponieważ adres bazowy (Base URL) Twojego Jira nieuchronnie zmieni się podczas migracji do Jira Cloud, integracja zostanie przerwana, jeśli nie wprowadzimy zmian po naszej stronie. Skontaktuj się z pomocą Miro.
Czy Miro utworzy webhook dla każdego zespołu, projektu czy instancji Miro?
Jeśli w ustawieniach Miro włączysz opcję Automatic Webhook, tworzenie webhooków odbywa się automatycznie. Jeśli korzystasz z autoryzacji na poziomie zespołu z Jira, Miro tworzy webhooki dla każdego zespołu. Jeśli korzystasz z autoryzacji na poziomie organizacji, Miro tworzy webhooki dla każdej organizacji.
Czy wtyczka Jira Cards obsługuje projekty Next-Gen?
Tak.
Obecnie po stronie Miro podczas tworzenia karty Jira dla projektu Next-Gen nie ma pola ani łącza do Epica.
Czy obsługiwane są niestandardowe pola Jira?
Tak — obsługujemy niemal wszystkie niestandardowe pola o typach podstawowych. Jeśli masz pole o złożonym typie danych, może nie być obsługiwane i powodować nieoczekiwane zachowanie podczas aktualizowania lub tworzenia kart Jira na tablicy.
Co stanie się z istniejącymi kartami Jira, jeśli przejdziemy na inną instancję Jira?
Obecnie, gdy przeniesiesz zgłoszenia Jira z jednego projektu do innego w Jira, nie będą się one już aktualizować po stronie Miro.
Jako obejście proponujemy skopiować adres URL zgłoszenia Jira (Ctrl/Cmd+C) i wkleić go na tablicę Miro (Ctrl/Cmd+V). W ten sposób karta Jira pokaże nowe wartości i zostanie zaktualizowana automatycznie.
Co stanie się z kartami Jira na tablicy, jeśli tablica zostanie przeniesiona do innego zespołu w Miro?
Karty Jira pozostaną na tablicy, ale nikt nie będzie mógł ich modyfikować (nawet jeśli ta sama instancja Jira jest skonfigurowana dla docelowego zespołu).
Po kliknięciu karty zobaczysz komunikat: „Karta Jira została zaimportowana z innego konta”. Aby karty można było edytować, zaimportuj je ponownie na tablicę.
Czy integracja kart Jira wiąże się z dodatkowymi kosztami?
Karty Jira są dostępne we wszystkich płatnych abonamentach oraz w planie Education bez dodatkowych opłat (Starter, Business, Education i Enterprise).
Czy użytkownik ma dostęp do wszystkich kart Jira na tablicy?
Uprawnienia integracji kart Jira gwarantują, że użytkownicy mogą tworzyć i edytować karty tylko w projektach Jira, do których mają dostęp.
Ponieważ wszystkie widżety na tablicy Miro są widoczne dla każdego, kto ma dostęp do tablicy, osoba, która nie ma danych dostępowych do Jira lub nie ma odpowiednich danych dostępowych, będzie mogła zobaczyć zwiniętą kartę Jira na tablicy (z tytułem i niektórymi innymi polami), ale nie będzie mogła jej rozwinąć, aby zobaczyć pełne szczegóły ani jej edytować.
Czy Atlassian zakończył wsparcie dla Jira Server?
Tak. Atlassian zakończył wsparcie dla Jira Server w lutym 2024.
Czy Planer Miro i karty Jira obsługują niestandardowe pola Jira: niestandardowe typy zgłoszeń i niestandardowe zależności?
Tak. Oba są obsługiwane. Jeśli w Jira skonfigurowano pola niestandardowe typy zgłoszeń i niestandardowe zależności, i Planer Miro jest uwierzytelniony dla tej instancji Jira, to te pola będą dostępne w Planerze.
Czy Miro obsługuje OAuth 2.0 dla Jira Data Center?
Tak. Zobacz Połącz z Jira Data Center przy użyciu OAuth 2.0.
Jak zaimportować zgłoszenia Jira do tabel i na oś czasu?
Możesz przeciągnąć i upuścić jedną lub wiele kart Jira bezpośrednio do tabeli, na oś czasu, do kanbana lub do Journey. To obecnie jedyny sposób.
Które pola w tabeli są powiązane z Jira?
Systemowe pola Jira:
- Tytuł
- Opis
- Data zakończenia (Due Date w Jira)
- Przypisana osoba
- Stan
Niestandardowe pola Jira: - Każde niestandardowe pole, które dodasz za pomocą Dodaj pola Jira, oraz następujące automatycznie mapowane pola: Data początkowa, Estymata. Aby dodać niestandardowe pola do tabeli, kliknij przycisk plus (+) na górze tabeli i wybierz Dodaj pola Jira. Następnie wybierz dowolne niestandardowe pole, które chcesz synchronizować.
Które pola w tabeli nie synchronizują się z Jira?
Kliknij komórkę, aby sprawdzić, które pola synchronizują się z Jira. Każde pole, które się synchronizuje, jest oznaczone logo Jira. Pozostałe pola są przechowywane tylko w Miro i nie synchronizują się z Jira.
Dlaczego nie mogę edytować w tabeli lub na osi czasu któregoś z pięciu obsługiwanych pól Jira wymienionych wyżej?
Pole może nie być dostępne na ekranie edycji w Jira.
Prosty sposób, by sprawdzić, czy pole jest dostępne na ekranie edycji:
W Miro otwórz panel boczny karty Jira. Sprawdź, czy pole jest widoczne w panelu bocznym. Jeśli pole nie jest widoczne, dodaj je do ekranu edycji w Jira.
W rzadkich przypadkach pola mogą być edytowalne w Jira, ale nie pojawiać się na ekranie edycji. W takim przypadku tych pól nie da się edytować w Miro.
Czy pole, którego nie możesz edytować, to Start date lub Estimate? Jeśli tak:
Pole może nie istnieć w Jira albo brakować go na ekranie edycji (odnieś się do poprzedniego punktu).
Może występować problem z mapowaniem pola Data początkowa lub Estymata, ponieważ są to niestandardowe pola w Jira.
Mapujemy te pola według następującej logiki:
- Data początkowa: Sprawdzamy pola o nazwach: Start Date, StartDate, Target Start
- Estymata: Sprawdzamy pola o nazwach: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Jeśli pole Data początkowa lub Estymata nie nosi żadnej z powyższych nazw, może to tłumaczyć, dlaczego edycja nie działa.
Dlaczego edycja pola Data początkowa lub pola Estymata w tabeli Miro lub na osi czasu nie działa albo aktualizuje niewłaściwe pole w Jira?
Obecnie polegamy na automatycznym mapowaniu pól Start Date i Estimate w Jira. Ponieważ są to pola niestandardowe w Jira, może się zdarzyć, że kilka pól w Twojej konfiguracji Jira spełnia powyższe kryteria.
Wybieramy pierwsze pasujące pole zgodnie z kolejnością nazw pól podaną powyżej:
Na przykład, jeśli w zgłoszeniu Jira występują zarówno pola Story Points, jak i Story point estimate, dopasowujemy to, które pojawia się pierwsze na powyższej liście, czyli Story Points. W związku z tym zmiany w polu Estimate w tabeli zaktualizują pole Story Points w Jira, a nie Story point estimate.
Na razie nie ma obejścia tego problemu. Jeśli napotkasz ten problem, wyślij opinię do zespołu pomocy, abyśmy mogli lepiej zrozumieć Twoje potrzeby podczas prac nad bardziej zaawansowanymi możliwościami mapowania pól.
Dlaczego nie mogę zaimportować kart Jira z dwóch różnych instancji do tabeli lub osi czasu?
Obecnie obsługujemy tylko jedną instancję Jira na każdą tabelę lub oś czasu. Po zaimportowaniu karty Jira do tabeli lub osi czasu ta tabela lub oś czasu zostaje powiązana z daną instancją Jira.
Nawet jeśli wszystkie rekordy Jira zostaną usunięte, powiązanie z pierwotną instancją Jira pozostaje. Aby zaimportować karty z innej instancji Jira, musisz utworzyć nową tabelę lub oś czasu.
Dlaczego nie widzisz ani nie możesz edytować pól Stan i Osoba przypisana w rekordach Jira w tabeli lub na osi czasu?
Obecnie pola Stan i Osoba przypisana z Jira nie są obsługiwane w tabelach i na osi czasu. Zdecydowaliśmy się wyłączyć te pola w tabelach i na osi czasu, aby lepiej ustawić oczekiwania, uniknąć nieporozumień i zapobiec możliwej utracie danych. Te pola oraz ich zawartość istnieją w Jira, lecz nie są wyświetlane w tabelach ani na osi czasu.
Możesz nadal edytować te pola bezpośrednio na kartach Jira w panelu bocznym. Po prostu przeciągnij wiersz z tabeli lub osi czasu na planszę, aby karta Jira ponownie się pojawiła.
Więcej informacji: