Uruchomienie i konfiguracja - Notion

Co robi ta integracja

Integracja z Notion tworzy stronę w wybranej bazie danych bezpośrednio ze szczegółów błędu w DockRay - bez ręcznego przepisywania komunikatu, miejsca awarii czy stosu wywołań. Powstanie strony zapisuje trwałe powiązanie: jeden błąd DockRay ↔ jedna strona Notion. Gdy strona trafi do grupy statusów Complete, DockRay sam oznaczy błąd jako rozwiązany. Odczyt jest okresowy: komenda thor:sync-notion sprawdza powiązane strony co pięć minut - Notion udostępnia webhooki wyłącznie aplikacjom publicznym, a integracja wewnętrzna klienta taką nie jest.

Czego potrzebujesz po stronie Notion

• uprawnień do tworzenia integracji w workspace Notion,
• bazy danych, do której mają trafiać zgłoszenia,
• chwili na udostępnienie tej bazy nowo utworzonej integracji - to krok, o którym najłatwiej zapomnieć, a bez niego integracja nie zobaczy niczego.

W przeciwieństwie do Jiry nie ma tu adresu instancji ani adresu e-mail - Notion ma jedno API pod stałym adresem, a uwierzytelnia sam token integracji.

Utworzenie integracji i skopiowanie tokenu

W ustawieniach integracji Notion (poziom workspace) utwórz nową integrację wewnętrzną i skopiuj wygenerowany token. Token widać w Notion przez cały czas, ale w DockRay - tak jak każdy inny sekret tej klasy - jest szyfrowany i nie wraca do formularza po zapisaniu.

Udostępnienie bazy danych integracji

Integracja Notion domyślnie nie widzi żadnej bazy danych - to nie ograniczenie DockRay, tylko sposób działania Notion: dostęp trzeba nadać ręcznie. Otwórz bazę, którą chcesz połączyć, i w menu Connections dodaj do niej utworzoną wcześniej integrację. Dopiero po tym kroku baza pojawi się na liście w DockRay.

Połączenie na poziomie konta i projektu

W panelu DockRay przejdź do Ustawienia → Notion i wklej token integracji - to połączenie obsługuje wszystkie projekty konta bez własnego tokenu. W Ustawienia projektu → Notion wybierz bazę danych, do której mają trafiać zgłoszenia, domyślną osobę przypisaną oraz opcjonalny status początkowy. Nazwy właściwości w bazie nie mają tu znaczenia - DockRay rozpoznaje pola po ich typie (tytuł, osoba, status), nie po nazwie wpisanej przez kogoś w Notion.

Pierwszy test

Utwórz stronę Notion z dowolnego istniejącego błędu w projekcie testowym. Sprawdź w Notion, że strona powstała we właściwej bazie, z tytułem, opisem diagnostycznym i linkiem do panelu DockRay. Przy błędzie w DockRay powinien pojawić się odnośnik do utworzonej strony.