Tryb debug — szczegółowe zapisy do diagnozy błędu

Gdy dokument nie chce się wystawić, a komunikat błędu nic nie mówi, tryb debug zapisuje komplet danych zamówienia — i to, co przyszło z OMS, i to, co z tego powstało przed wysłaniem do Subiekta. Zasada jest prosta: włącz, odtwórz problem, wyłącz.

1. Kiedy warto włączyć

   Włącz tryb debug, gdy:

   • konkretne zamówienie, faktura albo paragon nie chce się wystawić, a komunikat błędu nic Ci nie mówi,
   • dokument powstaje, ale z niewłaściwymi danymi i nie wiadomo, skąd się wzięły,
   • poprosi o to serwisant AppsBusters przy zgłoszeniu.

   Na co dzień trzymaj go wyłączony — normalne logi w zupełności wystarczają do bieżącej pracy.

2. Włącz przełącznik w konfiguratorze

   W panelu integratora otwórz Konfigurację i rozwiń sekcję Zdalna pomoc. Na jej dole jest wiersz Tryb debug — szczegółowe logi diagnostyczne z przełącznikiem Zapisuj szczegółowe logi diagnostyczne (debug). Włącz go.

   

   Sekcja Zdalna pomoc — przełącznik trybu debug.

3. Zapisz i poczekaj na restart

   Kliknij Zapisz zmiany. Pojawi się pytanie Zapisać zmiany? z informacją, że aplikacja uruchomi się ponownie — potwierdź przyciskiem Zapisz i uruchom ponownie.

   Przeglądarka na chwilę straci połączenie z panelem i sama je odzyska. To normalne: tryb debug zaczyna działać dopiero po restarcie.

   Uwaga na sąsiedni przycisk Zapisz Bez walidacji — zapisuje ustawienia bez sprawdzenia poprawności. Przy zwykłej zmianie używaj Zapisz zmiany.

4. Przeczytaj ostrzeżenia — są dwa i mówią o czym innym

   Ostrzeżenie widoczne na ekranie pojawia się od razu po włączeniu przełącznika i dotyczy wyłącznie rozmiaru: logi rosną znacznie szybciej niż zwykle i zajmują więcej miejsca na dysku, więc tryb należy wyłączyć po skończonej diagnozie. Skutek uboczny: przy dużym ruchu starsze wpisy zaczynają znikać wcześniej, bo szybciej dobijasz do limitu ustawionego w Logi.

   O danych osobowych ostrzeżenie na ekranie nie mówi — ta informacja jest w opisie ustawienia (rozwiniesz go przyciskiem Pokaż Opisy u góry konfiguratora). A jest ważna: w szczegółowych zapisach lądują dane osobowe Twoich klientów — imię, nazwisko, adres, telefon, e-mail, NIP. Dlatego tryb debug nie jest ustawieniem „na stałe”, a zrzutami z logów dziel się tylko z serwisem AppsBusters.

5. Odtwórz problem

   Powtórz dokładnie tę czynność, która się nie udaje — np. zmień status zamówienia w OMS tak, żeby integrator spróbował jeszcze raz wystawić dokument.

   Zapis powstaje w chwili przetwarzania, więc dokumenty sprzed włączenia trybu debug nie mają szczegółów. Nie da się „dograć” ich wstecz — trzeba wywołać próbę ponownie.

6. Znajdź zapisy w logach — najszybciej filtrem źródła

   Wejdź w Logi. Zapisy trybu debug mają własne, osobne źródło, więc najkrótsza droga wygląda tak:

   1. W liście rozwijanej ze źródłami wybierz Debug. Ta pozycja pojawia się dopiero po tym, jak tryb debug coś zapisze.
   2. Upewnij się, że chip poziomu Debug jest zaznaczony (domyślnie jest).
   3. Ustaw zakres czasu obejmujący Twoją próbę, np. 5 min albo 1 godz.
   4. Chcesz jeden konkretny dokument? Dopisz jego numer w wyszukiwarce.

   Wpisy zaczynają się od słowa DEBUG, po nim skrót rodzaju dokumentu (ZK, FS, PA, KFS, KPA) i numer z OMS — więc możesz też szukać po samym skrócie, jeśli chcesz zobaczyć np. wszystkie zamówienia.

   Zapisy bywają bardzo długie, dlatego na liście są przycięte. Kliknij wiersz — okno szczegółów pokaże komplet, a przycisk ⛶ rozciągnie je na pełny ekran.

7. Wyłącz, gdy skończysz

   Wróć do Konfiguracja → Zdalna pomoc, wyłącz przełącznik i kliknij Zapisz zmiany, a potem Zapisz i uruchom ponownie. Ostrzeżenie zniknie, a integrator wróci do normalnego zapisu logów.

   Zapisy, które już powstały, zostają — przestają jedynie przybywać nowe. Znikną same, gdy dobiją do limitu przechowywania.

8. Sprawdź również

   • Dokument nie chce się wystawić — od komunikatu do przyczyny — zacznij tam; tryb debug to dopiero drugi krok.
   • Logi aplikacji — jak znaleźć to, czego szukasz — jak filtrować wpisy i ile czasu są przechowywane.
   • Zdalna pomoc serwisowa — jak wpuścić serwisanta, żeby sam obejrzał zapisy.
   • Historia zmian ustawień — podgląd i cofanie — jeśli po diagnozie nie pamiętasz, co zmieniałeś.