Diagnostyka¶
Lista objawów, przyczyn i sposobów postępowania, gdy konektor nie działa lub dane nie docierają do MobiSkan.
Usługa konektora zapisuje komunikaty do Dziennika zdarzeń Windows, w dzienniku Aplikacja. To pierwsze miejsce, do którego warto zajrzeć przy każdym objawie z tej strony.
Szybka kolejność sprawdzania¶
- Czy usługa konektora jest uruchomiona.
- Czy sonda stanu odpowiada: otwórz w przeglądarce na maszynie w tej samej sieci adres
https://<adres konektora>:<port>/api/v1/health. Przeglądarka ostrzeże o certyfikacie samopodpisanym - to normalne. - Czy odpowiedź zawiera potwierdzenie połączenia z bazą ERP.
- Czy terminal i konektor są w tej samej sieci, a port jest otwarty w zaporze.
- Czy token po stronie klienta zgadza się z tokenem konektora.
Brak połączenia¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Terminal: nie można połączyć się z konektorem | Terminal i konektor są w różnych sieciach, port jest zamknięty w zaporze albo usługa nie działa. Sprawdź sondę stanu z przeglądarki w tej samej sieci |
| Panel: test połączenia kończy się błędem | Zły adres lub token albo serwer panelu nie ma trasy sieciowej do konektora. Jeśli panel stoi poza siecią klienta, potrzebny jest VPN albo przekierowanie portu, bo sam adres lokalny nie wystarcza |
| Usługa nie startuje po ręcznej edycji pliku konfiguracyjnego | Nieprawidłowa nazwa tabeli lub kolumny w konfiguracji schematu albo złe hasło certyfikatu. Konektor odmawia startu zamiast pracować z błędną konfiguracją, a komunikat jest w Dzienniku zdarzeń |
| Usługa nie startuje, w Dzienniku brak biblioteki środowiska uruchomieniowego | Dotyczy konektora PC-Market: brak ASP.NET Core Runtime 8.0 na maszynie. Zainstaluj środowisko uruchomieniowe |
Certyfikat¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Terminal odrzuca połączenie po wymianie certyfikatu | Zachowanie oczekiwane. Klient przypina odcisk certyfikatu przy pierwszym połączeniu. Sparuj terminal ponownie |
| Panel odrzuca połączenie po wymianie certyfikatu | Użyj w panelu funkcji resetu przypiętego certyfikatu, a następnie ponów test połączenia |
| Przeglądarka ostrzega o niezaufanym certyfikacie przy sprawdzaniu sondy stanu | Zachowanie oczekiwane. Konektor używa certyfikatu samopodpisanego, a tożsamości dowodzi przypięty odcisk, nie łańcuch zaufania |
| Przeglądarka odmawia połączenia po adresie IP, choć terminal i panel działają | Certyfikat pochodzi z instalacji sprzed dodania adresu IP do certyfikatu. Powtórz instalację po usunięciu pliku certyfikatu, aby powstał nowy, obejmujący także adres IP. Po wymianie certyfikatu trzeba ponownie sparować terminal i zresetować przypięty certyfikat w panelu |
Zapora i sieć¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Sonda stanu nie odpowiada z innej maszyny, ale odpowiada lokalnie | Port jest zablokowany. Instalator dodaje regułę zezwalającą na ruch przychodzący. Sprawdź, czy nie została usunięta lub czy nie blokuje jej zapora innego producenta |
| Sonda stanu nie odpowiada z maszyny w innej podsieci albo po zmianie profilu sieci | Zachowanie zamierzone. Reguła zapory dopuszcza ruch tylko w sieciach domenowych i prywatnych oraz tylko z podsieci lokalnej. Terminal i panel mają być w tej samej sieci co konektor, a połączenie spoza niej wymaga sieci VPN lub przekierowania portu |
| Terminal widzi konektor sporadycznie | Terminal przełącza się między sieciami albo maszyna z konektorem ma kilka kart sieciowych i rozgłasza inny adres niż osiągalny. W takim wypadku wpisz właściwy adres ręcznie w konfiguracji konektora |
| Panel odbiera odpowiedzi w formacie HTML zamiast danych | Adres panelu wpisany w konektorze wskazuje na interfejs użytkownika panelu zamiast na jego API. Popraw adres |
Dostęp do bazy ERP¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Sonda stanu odpowiada, ale zgłasza brak połączenia z bazą | Zły serwer lub nazwa bazy w konfiguracji albo konto bez dostępu. W Dzienniku zdarzeń widać wtedy błąd logowania do bazy |
| W Dzienniku: nieudane logowanie konta systemowego do bazy | Konektor korzysta z uwierzytelniania Windows, a konto usługi nie ma dostępu do bazy programu ERP. Najprościej uruchomić instalator ponownie z zaznaczonym automatycznym nadaniem dostępu, bo reinstalacja jest bezstratna. Alternatywnie administrator bazy nadaje prawo odczytu ręcznie |
| Instalator zgłosił, że nie mógł nadać dostępu do bazy | Konto Windows uruchamiające instalator nie ma uprawnień administratora instancji SQL. Reszta instalacji przebiegła normalnie, a dostęp trzeba nadać ręcznie albo powtórzyć instalację z konta z odpowiednimi uprawnieniami |
| PC-Market: konektor nie łączy się z bazą, a program działa normalnie | Sprawdź silnik bazy. Konektor obsługuje wyłącznie MS SQL Server, a instalacje na Sybase SQL Anywhere nie są obsługiwane |
Uwierzytelnianie¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Terminal: brak towarów po sparowaniu, panel: brak autoryzacji | Token po stronie klienta różni się od tokenu konektora, zwykle po ręcznej edycji konfiguracji. Zeskanuj świeży kod QR albo przepisz token z okna konfiguracji panelu w aplikacji zasobnika |
| Konektor odpowiada na wszystko bez tokenu | Token w konfiguracji konektora jest pusty, co wyłącza uwierzytelnianie. To tryb wyłącznie deweloperski, a instalacja produkcyjna musi mieć token ustawiony |
Brak Sfery i problemy z zapisem¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Zapis towaru lub wyniku kompletacji zgłasza, że operacja jest niedostępna | Jedna z trzech przyczyn: aplikacja zasobnika nie jest uruchomiona (nikt nie jest zalogowany albo została zamknięta), zapis nie został włączony w konfiguracji, albo pakiet instalacyjny zbudowano bez wsparcia dla interfejsu producenta. Zaloguj użytkownika, uruchom aplikację zasobnika i włącz zapis w oknie konfiguracji ogólnej |
| Komunikat, że aplikacja zasobnika jest zajęta poprzednim żądaniem | Inna sytuacja niż powyższa. Aplikacja zasobnika działa, tylko obsługuje wcześniejszy zapis, który potrafi trwać ponad minutę. Poczekaj i powtórz operację, niczego nie uruchamiaj ponownie |
| Zapis wyniku kompletacji zgłasza pozycje bez odpowiednika w dokumencie źródłowym | Dokument został zmieniony w programie ERP już po zaimportowaniu go na terminal, więc pozycje przestały do siebie pasować. Do programu ERP nie trafiło nic. Zaimportuj dokument ponownie i powtórz kompletację |
| Zapis zgłasza błąd komunikacji ze Sferą | Najczęściej brak ważnej licencji dodatku producenta, licencja wygasła albo program działa w wersji próbnej. Zweryfikuj stan licencji u klienta |
| Zapis zgłasza nieudaną próbę zalogowania do serwera bazy | Interfejs automatyzacji korzysta z konta bez prawa zapisu. Zapis wymaga osobnego konta o szerszych uprawnieniach. Włącz zapis w kreatorze instalacji albo w aplikacji zasobnika, co utworzy je automatycznie |
| Zapis zgłasza brak uprawnienia na poziomie serwera | Konto używane przez interfejs automatyzacji nie ma uprawnienia serwerowego wymaganego przez program ERP. Powtórz włączenie zapisu, które nadaje to uprawnienie |
| Nieprawidłowy login lub hasło operatora | Popraw dane operatora programu ERP w oknie konfiguracji ogólnej. To konto operatora programu, nie konto SQL |
| Zapis się powiódł, ale w programie ERP nic nie widać | Odśwież widok w programie ERP klawiszem F5 albo zamknij i otwórz listę ponownie. Program nie widzi automatycznie zmian wprowadzonych z innej sesji. To pierwsza rzecz do sprawdzenia, zanim uznasz zapis za nieudany |
| Jedna kompletacja utworzyła w programie ERP kilka takich samych dokumentów | Objaw starszej wersji aplikacji na terminalu. Terminal ponawia wysyłkę, gdy program ERP odpowiada dłużej niż jego limit oczekiwania, a bez klucza powtórzenia konektor nie potrafi rozpoznać ponowienia. Zaktualizuj aplikację na terminalu - nowsza wersja wysyła ten klucz i konektor odsyła wynik pierwszego zapisu zamiast tworzyć kolejny dokument |
| Błąd licencji dodatku producenta przy losowej operacji zapisu | Objaw starszej wersji konektora, która otwierała kilka równoległych sesji dodatku producenta i wyczerpywała licencję liczoną na jednoczesne sesje. Zaktualizuj konektor - obecna wersja używa jednej wspólnej sesji |
| Subiekt nexo: komunikat o innej wersji bibliotek niż baza | Rozbieżność wersji między bazą nexo a bibliotekami producenta użytymi do zbudowania pakietu. Wymaga zrównania wersji: aktualizacji nexo albo pakietu zbudowanego na zgodnej wersji bibliotek |
| Subiekt nexo: zapis kompletacji kończy się błędem przy tworzeniu dokumentu | Brak wskazanego w konfiguracji symbolu magazynu, w którego kontekście dokument ma powstać. Uzupełnij go i zrestartuj usługę |
| Subiekt nexo: zapis towaru z ceną kończy się odmową | Zachowanie zamierzone. Konektor nexo nie obsługuje ceny przy zapisie, więc wyślij żądanie bez ceny |
| PC-Market: każdy zapis zgłasza, że operacja jest niedostępna | Zachowanie zamierzone i nieusuwalne. Producent nie udostępnia mechanizmu zapisu |
Rozjazd nazw tabel i kolumn¶
Schemat bazy Subiekta GT nie jest publikowany przez producenta i bywa różny między wersjami programu. Konektor nie ma na sztywno wpisanych nazw tabel ani kolumn - wszystkie są konfigurowalne bez ponownego budowania pakietu.
| Objaw | Przyczyna i postępowanie |
|---|---|
| Usługa nie startuje z komunikatem walidacji nazw schematu | Pusta lub nieprawidłowa nazwa w konfiguracji. Konektor sprawdza to przy starcie celowo, żeby błąd ujawnił się od razu, a nie dopiero przy pierwszym zapytaniu |
| Usługa startuje, ale synchronizacja zgłasza błąd bazy | Nazwa tabeli lub kolumny nie odpowiada wersji programu zainstalowanej u klienta. Dokładny komunikat bazy jest w Dzienniku zdarzeń i wskazuje, którego obiektu brakuje. Poprawka polega na skorygowaniu nazwy w konfiguracji konektora |
| Katalog zawsze pobiera się w całości, mimo że towary się nie zmieniły | Instalacja nie ma kolumny znacznika zmiany. Konektor wykrywa jej brak i przechodzi na pełny zrzut zamiast zgłaszać błąd. Skutkiem jest wyłącznie dłuższa synchronizacja |
Wszelkie takie poprawki wykonuje się po stronie MobiSkan. Konektor nie zmienia schematu bazy programu ERP ani jego ustawień.
Synchronizacja z panelem¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Konektor nie wysyła nic do panelu i nie zgłasza błędów | Adres panelu nie jest ustawiony w konfiguracji konektora, brakuje mapowania magazynów w panelu albo adres wskazuje na interfejs użytkownika zamiast na API. Cykl bez konfiguracji jest pomijany po cichu |
| Dokumenty nie pojawiają się w panelu, choć katalog tak | Dokument odwołuje się do magazynu bez mapowania i jest pomijany do czasu uzupełnienia mapowania. Sprawdź także, czy katalog dotarł do panelu wcześniej, bo pozycja wskazująca na nieznany towar jest odrzucana |
| Nie da się zamknąć w panelu dokumentu pochodzącego z ERP | Zamknięcie wysyła powiadomienie do konektora synchronicznie i przy niepowodzeniu blokuje zamknięcie, żeby stany obu systemów się nie rozjechały. Usuń przyczynę po stronie konektora, a następnie powtórz zamknięcie |
| W Dzienniku: nieczytelny plik stanu synchronizacji dokumentów | Plik stanu i jego kopia zapasowa zostały uszkodzone, a konektor celowo wstrzymał wysyłkę, zamiast potraktować je jako puste. Napraw lub usuń oba pliki, pamiętając, że usunięcie oznacza ponowne wysłanie całej historii dokumentów |
| Po zainstalowaniu drugiego konektora na tej samej maszynie dokumenty poszły do panelu ponownie | Objaw starszej wersji, w której oba konektory dzieliły jeden plik stanu. Obecna wersja trzyma stan osobno dla każdego konektora i przy pierwszym starcie kopiuje do niego dotychczasową zawartość |
| Subiekt nexo: panel nie pokazuje kontrahentów, stanów ani mapowania magazynów | Zachowanie zamierzone w obecnej wersji. Panel obsługuje nexo wyłącznie w zakresie podglądu katalogu |
Terminal¶
| Objaw | Przyczyna i postępowanie |
|---|---|
| Nieprawidłowy kod parowania | Zeskanowano kod niepochodzący z konektora MobiSkan |
| Aparat nie skanuje | Sprawdź uprawnienie do aparatu w ustawieniach systemowych urządzenia |
| Po sparowaniu terminal wyczyścił lokalną kartotekę | Zachowanie oczekiwane przy przełączeniu na inny system lub inną instalację ERP. Aplikacja pyta o potwierdzenie przed wykonaniem tej operacji |
| Lista magazynów jest pusta i nie da się wykonać mapowania | Dotyczy Subiekta nexo bez Sfery. Bez tego dodatku konektor nie ma skąd pobrać magazynów i zwraca pustą listę zamiast błędu |
| Baza towarów i kontrahenci są tylko do odczytu | Zachowanie oczekiwane przy sparowaniu z ERP. Źródłem prawdy jest program ERP, a blokada zapobiega cichej utracie zmian przy najbliższej synchronizacji |
| Zamknięta kompletacja nie wraca do ERP | Dotyczy PC-Marketu, który nie przyjmuje zapisu. Kompletacja zamyka się w MobiSkan normalnie, tylko wynik nie ma dokąd trafić |
| Symbole towarów nie są kodami kreskowymi | Dotyczy PC-Marketu. Symbol to kod wewnętrzny programu, a kody kreskowe są przekazywane osobno, więc wyszukiwanie po zeskanowanym kodzie działa poprawnie |
| Jedno przesunięcie MM widoczne jako dwa dokumenty | Dotyczy PC-Marketu, który zapisuje przesunięcie jako dwa niezależne dokumenty bez klucza łączącego. Zachowanie zamierzone |
| PC-Market: kreator nie pokazał kodu QR po instalacji | Usługa nie zdążyła wystartować albo zapis pliku z kodem się nie powiódł. Sparuj terminal danymi wypisanymi przez kreatora, albo zrestartuj usługę i otwórz plik z kodem z katalogu instalacji - powstaje przy każdym starcie. Postępowanie opisuje strona PC-Market |