UAT Studioby Salvion
Pomoc · Połączenia

Publikowanie zgłoszeń i postępu w Slacku

Zespół projektowy jest na bieżąco tam, gdzie już pracuje: wiadomość na kanale Slack o nowych zgłoszeniach, nowych rundach testów i sign-offach, a w razie potrzeby krótkie podsumowanie co rano. To Państwo decydują, co jest warte wiadomości.

Czas około 5 minutKto administrator przestrzeni roboczej oraz osoba, która może dodawać aplikacje do przestrzeni SlackPlany Team, Business, Partner i Enterprise
Zanim Państwo zaczną

Co będzie potrzebne

  • Kanał Slack na wiadomości, np. #uat-crm.
  • Uprawnienie do dodania aplikacji do przestrzeni Slack. W wielu przestrzeniach ma je każdy członek; w innych aplikacje zatwierdza administrator Slacka. Wtedy należy zwrócić się do niego.
  • Uprawnienia administratora w przestrzeni roboczej UAT Studio.
Bez konta i tokenuSlack udostępnia adres webhooka dla jednego kanału. UAT Studio wysyła wiadomości na ten adres i nie może w Slacku robić nic więcej: nie może czytać kanału ani publikować gdzie indziej.
Konfiguracja · raz na kanał

Połączenie z kanałem Slack

1

Utworzenie webhooka w Slacku

  1. Przejść do api.slack.com/apps, zalogować się do przestrzeni Slack i kliknąć Create New App.
  2. W Or start your own way wybrać Blank app i kliknąć Continue.
  3. App name: UAT Studio. W Workspace wybrać przestrzeń Slack i kliknąć Continue.
  4. Slack pyta teraz What it can do in Slack?, a potem What it can respond to in Slack? UAT Studio nie potrzebuje żadnego z nich: niczego nie dodawać i dwa razy kliknąć Continue.
  5. W Review your app kliknąć Create.
  6. W menu po lewej stronie nowej aplikacji otworzyć Incoming Webhooks i włączyć Activate Incoming Webhooks.
  7. Na dole kliknąć Add New Webhook (w niektórych przestrzeniach: Add New Webhook to Workspace lub Request to Add New Webhook, gdy najpierw musi go zatwierdzić administrator Slacka), wybrać kanał i kliknąć Allow.
  8. Slack pokazuje Webhook URL zaczynający się od https://hooks.slack.com/services/. Kliknąć Copy.

Opcjonalnie: w Basic Information › Display Information można nadać aplikacji ikonę, np. logo UAT Studio, aby wiadomości były łatwe do rozpoznania.

Adres należy traktować jak hasłoKażdy, kto zna ten adres, może publikować na kanale. Należy wkleić go wyłącznie w UAT Studio i nie wysyłać go na czacie ani e-mailem.

Korzystają Państwo już ze Slack Workflow Builder? Workflow rozpoczynający się From a webhook daje adres zaczynający się od https://hooks.slack.com/triggers/; to również działa.

2

Dodanie Slacka w UAT Studio

W UAT Studio otworzyć przestrzeń roboczą i kliknąć Connections. W Add a connection wybrać Slack i kliknąć Add.

Add a connection: wybrany Slack, z przyciskiem Add

Następnie wybrać, co trafia na kanał:

  • Post new issues from: Critical only, High and Critical (domyślnie), Medium and higher, Every new issue lub No new issues.
  • Status changes: domyślnie wyłączone. Po włączeniu publikowana jest też każda zmiana statusu tych zgłoszeń, np. gdy któreś jest gotowe do ponownego testu.
  • New test rounds i Sign-offs: domyślnie publikowane.
  • Daily overview: domyślnie wyłączone. Po włączeniu co rano pojawia się jedna wiadomość z projektami, w których coś się działo.
  • Projects: zaznaczyć projekty, których dotyczy ten kanał. Jeśli żaden nie jest zaznaczony, publikowane są wszystkie projekty przestrzeni roboczej.

Kliknąć Save settings. Osobny kanał dla każdego projektu albo oddzielny kanał tylko dla krytycznych zgłoszeń? Wystarczy dodać Slacka ponownie dla każdego kanału.

3

Zapisanie adresu webhooka

Wkleić adres z kroku 1 w Webhook address i kliknąć Store token. Widać wtedy, że jest zapisany, wraz z czterema ostatnimi znakami. Od tej chwili adresu nie można odczytać, można go tylko zastąpić.

4

Test połączenia

Kliknąć Test connection. Na kanale pojawi się wiadomość UAT Studio is connected, a połączenie pokaże godzinę testu z OK.

Połączenie ze Slackiem: High and Critical, zmiany statusu i dzienne podsumowanie włączone, zaznaczony projekt CRM UAT, adres zapisany i przetestowany
Przetestowane połączenie ze Slackiem. Przełączenie na Off wstrzymuje wiadomości bez utraty ustawień.
Korzystanie

Co jest publikowane

  • Nowe zgłoszenie o wybranej wadze lub wyższej: tytuł, opis, waga, status, test i krok, osoba, która je znalazła, ticket w Jira lub Azure DevOps i rekord w CRM, jeśli istnieją.
  • Zmiana statusu takiego zgłoszenia, jeśli jest włączona, np. ISS-012 is now Ready for retest (was In progress).
  • Nowa runda testów: runda, liczba przypadków testowych, wydanie, build i środowisko oraz osoba, która ją rozpoczęła.
  • Sign-off: kto zatwierdził, decyzja i ewentualne warunki.
  • Dzienne podsumowanie, jeśli jest włączone: około 08:15 jedna wiadomość, w której dla każdego projektu widać zapisane wyniki, niepowodzenia, nowe i zamknięte zgłoszenia oraz to, co jest jeszcze otwarte. Dni bez aktywności są pomijane.
  • Publikowane są także zgłoszenia utworzone przez API, np. z Zapier lub Make.
  • Każda wiadomość ma przycisk Open in UAT Studio. Otworzyć go mogą tylko osoby z dostępem do projektu.
  • Ręcznie: w każdym zgłoszeniu administrator może kliknąć Send to Slack, aby je udostępnić, niezależnie od wagi.
Co nie trafia do SlackaZrzuty ekranu i pliki nie są publikowane w Slacku; pozostają w UAT Studio, za logowaniem.
Role

Kto może co robić

Administrator przestrzeni roboczejDodaje, zmienia, testuje i usuwa połączenie oraz ręcznie wysyła zgłoszenia.
Testerzy i interesariuszeZgłaszają problemy i udzielają sign-off jak zawsze. Nie widzą połączenia.
Wszyscy na kanaleWidzą wiadomości. Otwarcie zgłoszenia wymaga dostępu do projektu w UAT Studio.
Pomoc

Gdy coś pójdzie nie tak

KomunikatCo zrobić
This is not a Slack webhook addressNależy skopiować Webhook URL z kroku 1, zaczynający się od https://hooks.slack.com/, a nie link do kanału.
Slack does not accept this address any moreWebhook lub aplikacja zostały usunięte albo kanał został zarchiwizowany. Należy dodać nowy webhook w kroku 1 i zapisać nowy adres.
Test działa, ale brak wiadomości o nowych zgłoszeniachNależy sprawdzić wybraną wagę, zaznaczone projekty i to, czy połączenie jest On. Następnie wysłać jedno zgłoszenie ręcznie przez Send to Slack: jeśli Slack je odrzuci, widać dlaczego.
Brak dziennego podsumowaniaPrzychodzi tylko po dniach z aktywnością w zaznaczonym projekcie, raz dziennie. Należy sprawdzić, czy Daily overview jest ustawione na Every morning.
Slack prosi o zatwierdzeniePrzestrzeń Slack dopuszcza tylko zatwierdzone aplikacje. Administrator Slacka zatwierdza prośbę, po czym można dodać webhook.
Connections are not part of your planPołączenia są dostępne w planach Team, Business, Partner i Enterprise, a dla Project jako dodatek. Administrator może zmienić plan w Plan & billing.

Nadal nie działa? Prosimy napisać na [email protected] i podać widoczny komunikat. Prosimy nigdy nie wysyłać nam samego adresu webhooka.

Korzystają Państwo z Microsoft Teams? Zobacz Publikowanie zgłoszeń w Microsoft Teams. Zgłoszenia we własnym systemie? Zobacz Połączenie z webhookiem.

Bezpieczeństwo

Jak postępujemy z adresem

  • Adres trafia z przeglądarki na nasz serwer jeden raz, szyfrowanym połączeniem.
  • Jest przechowywany w postaci zaszyfrowanej (AES-256). Klucz do odszyfrowania jest przechowywany oddzielnie od bazy danych.
  • Nikt nie może go odczytać: ani w aplikacji, ani przez wsparcie.
  • Wiadomości zawierają treść zgłoszenia oraz nazwiska testera i osoby zatwierdzającej, nigdy pliki. Należy wybrać kanał, którego członkowie mogą widzieć UAT.
  • Po usunięciu połączenia w UAT Studio albo webhooka lub aplikacji w Slacku wiadomości natychmiast przestają przychodzić.