Przejdź do treści

Integracja Jira

Połącz Threada z Jira do kontrolowanego tworzenia i aktualizowania zgłoszeń z WorkItems, z audytowalnymi przekazaniami przepływu pracy.

Przegląd

Integracja Jira umożliwia Threada tworzenie i aktualizowanie zgłoszeń Jira jako kontrolowanych działań. Kontekst WorkItem — dowody, decyzje i wyniki zasad — automatycznie przepływa do Jira.

Możliwości

  • Tworzenie zgłoszeń z eskalacji WorkItem z ustrukturyzowanym kontekstem
  • Aktualizowanie zgłoszeń Jira — dodawanie komentarzy i przeprowadzanie przejść — z kontrolowanych działań
  • Mapowanie projektów, typów zgłoszeń i pól niestandardowych
  • Łączenie powiązanych WorkItems i dowodów ze zgłoszeniami Jira
  • Ścieżka audytu dla każdej operacji zgłoszenia

Przykład w praktyce

Jeden kompletny przepływ, który Threada realizuje z Jira:

  1. Zapytanie napływa pocztą e-mail, przez Slack lub formularz i staje się zarządzanym WorkItem z typowanym schematem i cytowanym materiałem dowodowym.
  2. Polityka ustala, że praca wymaga śledzonego zadania inżynierskiego, a osoba zatwierdzająca akceptuje je w ramach jawnego kroku decyzyjnego.
  3. Threada tworzy zgłoszenie w Jira jako zarządzane działanie — ze zmapowanym projektem, typem zgłoszenia i polami — wraz z dołączonym kontekstem WorkItem i materiałem dowodowym.
  4. Threada może przeprowadzać przejścia zgłoszeń Jira jako kontrolowane działania, a każda operacja jest zapisywana na ścieżce audytu WorkItem.

Konfiguracja

Skonfiguruj integrację w Studio w ramach ładu pakietu. Podaj poświadczenia Jira API z uprawnieniami o zakresie projektu i zmapuj pola do schematu przepływu pracy.

  1. W Studio dodaj integrację z Jira w ramach zarządzania pakietem.
  2. Podaj poświadczenia API Jira o zakresie ograniczonym do konkretnych projektów, do których Threada może zapisywać.
  3. Zmapuj projekty, typy zgłoszeń i pola niestandardowe Jira na swój schemat WorkItem.
  4. Zweryfikuj połączenie; integracja aktywuje się dopiero po pomyślnym zapisie testowym.

Uprawnienia i dostęp do danych

Jira korzysta z poświadczeń, które podajesz Ty — nie z aplikacji OAuth hostowanej przez Threada.

  • Threada uwierzytelnia się za pomocą podanego przez Ciebie tokena Jira API, ograniczonego do konkretnych projektów, do których może zapisywać, przechowywanego w Secret Manager.
  • Threada wywołuje REST API Jira, aby tworzyć i aktualizować zgłoszenia oraz przeprowadzać przejścia; nie odczytuje statusu Jira z powrotem do WorkItem.
  • Każda operacja na zgłoszeniu uruchamia się jako kontrolowane działanie i jest zapisywana na ścieżce audytu WorkItem.

Najczęściej zadawane pytania

Czy Threada tworzy zgłoszenia w Jira automatycznie?
Wyłącznie zgodnie z polityką. Tworzenie zgłoszeń odbywa się jako zarządzane działanie, więc o tym, czy uruchamia się automatycznie, czy czeka na osobę zatwierdzającą, decyduje Twoja nakładka polityk. Każde zgłoszenie utworzone przez Threada niesie ze sobą kontekst WorkItem i trafia na ścieżkę audytu.
Czy Threada odczytuje przejścia Jira z powrotem do WorkItem?
Obecnie nie. Threada zapisuje do Jira — tworzy zgłoszenia, dodaje komentarze i przeprowadza przejścia jako kontrolowane działania. Przychodząca synchronizacja statusu Jira z powrotem do WorkItem nie jest dziś obsługiwana.
Jakiego dostępu wymaga integracja?
Poświadczenia API Jira o zakresie ograniczonym do konkretnych projektów, do których Threada może zapisywać — najmniejsze niezbędne uprawnienia. Połączenie jest weryfikowane przed aktywacją, a każda operacja na zgłoszeniach jest rejestrowana.