Nowość: connector do Comarch Optima.Zobacz, jak działa

Jak connector działa: pull, kolejka, heartbeat, aktualizacje

Connector pracuje w cyklu: odzywa się do Taxso, zabiera zadania i zaakceptowane dokumenty, zapisuje je w Optimie i odsyła wynik. Taxso nigdy nie łączy się do serwera biura. Ta strona tłumaczy, co znaczą Connector aktywny i Connector milczy, skąd biorą się alerty o Optimie offline, jak zaktualizować connector z panelu i co dają testy w Diagnostyka.

Księgowa / księgowyAdministrator biura5 minAktualizacja:

Pull: connector pyta, Taxso odpowiada

Każde żądanie niesie klucz connectora (Taxso trzyma tylko skrót) i identyfikator firmy; serwer biura nie potrzebuje publicznego adresu ani otwartego portu. Wszystko, co zlecasz w panelu, czeka na najbliższy cykl: przy kilku firmach pół minuty, przy dwustu bazach Optimy kilkadziesiąt minut.

Jeden cykl connectora

1/5

Krok 1

Heartbeat

Co około 30 sekund: wersja connectora i Optimy, długość kolejki, liczba udanych i nieudanych zapisów, ostatni błąd, tryb tylko do odczytu, start bieżącego cyklu.

Heartbeat, `Connector aktywny` i alerty

Dwa progi: krótki steruje plakietką, długi wysyła alert. Sygnałem jest każde uwierzytelnione żądanie, nie tylko heartbeat, więc connector zajęty długim cyklem nie „milknie”.

GdziePanel biuraUstawienia biuraPołączeniaKonfigurujConnector ERP

Connector aktywny
Sygnał w ciągu ostatnich 2 minut, obok Ostatni heartbeat: …. Ten sam stan widać w Ustawienia biura → Połączenia.
Connector milczy
Ponad 2 minuty bez sygnału (około 4 przegapione heartbeaty). Diagnostyka i aktualizacja z panelu są wyłączone; dokumenty czekają w kolejce z notką czeka na connector.
Optima offline od HH:MM
Alert: cisza co najmniej 20 minut, sprawdzana co 5 minut, tylko 7-19 w dni robocze, jeden na incydent. Dzwonek i mail Awaria connectora / Optimy do administratorów i księgowych.
Optima: częściowa awaria eksportu (N)
Connector żyje, ale co najmniej 3 dokumenty biura mają Błąd wysyłki.
Optima wróciła - connector znów online
Zamyka incydent, wysyłane także poza godzinami pracy.

Alert offline wymienia, co sprawdzić: serwer z Optimą, usługę Morpheus, klucz connectora. Szybki rzut oka bez ustawień: ikona Odśwież: KSeF i Optima w Obiegu, wiersz Optima.

Aktualizacja z panelu

Karta Wersja connectora pokazuje W biurze: i Dostępna:. Przycisk Zaktualizuj do X i dialog Zaktualizować connector do X? → Tak, zaktualizuj. Przycisk jest nieaktywny, gdy zlecenie trwa albo connector milczy (Connector milczy - aktualizację zlecisz, gdy znów będzie aktywny.). Zlecenie jest ważne 24 godziny.

Zlecono
Zlecono {czas}. Connector odbierze zlecenie, gdy skończy bieżącą pracę w Optimie. Cykl trwa od {czas}. Nic nie trzeba klikać ponownie.
Przyjęte
Connector przyjął zlecenie {czas} i zainstaluje wersję X. Robi to po skończeniu bieżącego cyklu pracy (trwa od …) - przy wielu firmach to bywa nawet godzina. Zapis do Optimy nie zostanie przerwany.
Za stary connector
Ten connector jest za stary, by zaktualizować się z panelu (wymaga 1.5.46). Zaktualizuj go raz ręcznie instalką powyżej. Jednorazowa instalacja na tym samym kluczu.
Z serwera
Komenda taxso update --apply. Taxso podaje ją w komunikatach o wymaganej wersji, np. Księgowanie zbiorcze do KPiR wymaga connectora 1.5.64 (jest X). Zaktualizuj go: taxso update --apply.

Nowe funkcje mają progi wersji; starszy connector dostaje Connector wymaga aktualizacji do wersji X.

Diagnostyka i tryb tylko do odczytu

Każdy przycisk w karcie Diagnostyka to zadanie odbierane w zwykłym cyklu. Po 3 minutach bez odpowiedzi panel pokazuje Connector nie odpowiedział w 3 minuty., ale zadanie nie przepada: wynik jest w kolejce w grupie Connector. Gdy connector milczy: Connector nie odpowiada - diagnostyka ruszy, gdy wróci.

PrzyciskCo zwracaOd wersji
StanWersja connectora, Wersja Optimy, Tryb tylko do odczytu, Operator Optimy, Klucz licencji Optimy, Konto Windows usługi, Architektura, Wysyłka do Optimy1.5.28
DziennikOstatnie linie dziennika connectora, checkbox tylko błędy (domyślnie zaznaczony), pole Szukaj w dzienniku…. Pusto: Brak pasujących wpisów.1.5.28
Zaloguj ponownie do OptimyZamyka sesję connectora w Optimie i loguje od nowa, pobierając licencje modułów od nowa.1.5.28
Dlaczego tylko do odczytu?Raport o licencjach: Połączenie z serwerem licencji (HASPConnection), Okres abonamentu (HASPKeySubscriptionPeriod), Karta operatora, Rejestr Windows.1.5.37
Zrzut API OptimyPlik OPTIMA-COM-SURFACE.md z opisem interfejsu COM tej instalacji; przydatny przy zgłoszeniu nietypowego błędu.1.5.57

Tryb tylko do odczytu: connector czyta rejestr i deklaracje, ale nie tworzy wpisów; Stan pokazuje Tryb tylko do odczytu: włączony, a dokumenty czekają w kolejce. Kliknij Dlaczego tylko do odczytu?, usuń przyczynę w Optimie (licencja, abonament, karta operatora), potem Zaloguj ponownie do Optimy.

Limity w liczbach

Zadania na cykl
3; zadanie w toku dłużej niż 15 minut wraca do puli.
Żądania biura
Co najmniej 600 na 5 minut, przy większym biurze 20 na firmę. Po przekroczeniu Za dużo żądań - zwolnij i ponów. i minuta przerwy; connector wznawia sam.
Błędne uwierzytelnienia
20 na 5 minut z jednego adresu IP, potem 5 minut blokady.
Samoodświeżenie rejestru
Od 1.5.48 co 12 godzin w oknie 90 dni, dodatkowo po każdym zapisie.

Pytania z wdrożeń

Plakietka mówi „Connector milczy”, a na serwerze usługa działa.+

Typowe przyczyny: odwołany klucz (Brak lub zły X-Wise-Api-Token.), brak wyjścia do internetu z serwera, usługa zatrzymana po aktualizacji Windows. Sprawdź dziennik na serwerze.

Dlaczego alert o offline nie przyszedł w nocy?+

Watchdog alarmuje tylko 7-19 w dni robocze, żeby nie budzić zespołu restartami po godzinach. Powrót jest wysyłany zawsze, a dokumenty z nocy wejdą w pierwszym cyklu rano.

Czy connector ponawia nieudany zapis sam?+

Nie, jeśli Optima odrzuciła zapis (Błąd wysyłki): czeka na Ponów. Tak, jeśli to chwilowa blokada (Wstrzymane). Rozróżnienie: Kolejka i nieudane eksporty.