Archiwum programu nie wymaga instalacji: rozpakuj je i uruchom plik programu. Poniżej — co dzieje się przy pierwszym uruchomieniu i jak upewnić się, że jest łączność z serwerem.
Gdzie rozpakować
Do folderu, w którym użytkownik ma prawa zapisu, na przykład C:\cnc_client. Obok programu powstają jego pliki robocze: ustawienia, baza zamówień i dzienniki. Foldery typu C:\Program Files nie nadają się — Windows zabroni zapisu.
Skąd program zna twoją firmę
Klucz firmy (KEY) i adres serwera (API_URL) są już wpisane do pliku config_gui.txt obok programu: wpisuje je serwer, gdy pobierasz archiwum z panelu administracyjnego. W oknie programu tych pól nie ma — sprawdzić je można tylko w pliku. Więcej: Zakładka „Ustawienia”.
Co zobaczysz
- W nagłówku okna — nazwa twojej firmy, pod nią podpis „Klient pobierania” i numer wersji. Nazwa przychodzi z serwera po kluczu i jest zapamiętywana, więc następnym razem pojawia się od razu. Dopóki nie ma odpowiedzi — neutralny podpis.
- Po lewej w kolumnie — zakładki, po prawej — zawartość wybranej. Więcej: Przegląd okna.
- Na dole — pasek stanu: kolorowa kropka, bieżący stan i zegar.
- Domyślnie program od razu zaczyna odpytywać serwer i zwija się do paska zadań. Oba zachowania wyłącza się polami na zakładce „Ustawienia”.
Sprawdzenie łączności w trzech krokach
- Na zakładce „Główna” naciśnij „↻ Sprawdź”. Jeśli klucz w pliku jest pusty, program odpowie komunikatem „Klucz API nie jest ustawiony” i nie zacznie odpytywania.
- Spójrz na górę „Głównej”. Dopóki wszystko jest w porządku, nie ma tam czerwonego paska; jeśli serwer nie przyjął zapytania, pojawi się pasek z przyczyną i przycisk „Szczegóły w logu”.
- Otwórz zakładkę „Log”. Tam krok po kroku widać: adres, na który poszło zapytanie, odpowiedź serwera, ile zamówień jest do pobrania, pobieranie i rozpakowanie każdego.
Ile czekać
- Jedno nowe zamówienie przechodzi całą drogę — zapytanie, pobieranie, rozpakowanie, kopiowanie na maszyny, konwersja — w około 10–40 sekund.
- Pierwszy cykl jest zwykle najdłuższy: serwer oddaje wszystkie zamówienia z ostatnich dni (domyślnie 60, ustawia się w
time.txt). W dużej firmie to setki zamówień. - Dalej program odpytuje serwer według harmonogramu: interwał ustawia parametr
every_minuteswconfig_gui.txt, minimum — trzy minuty.
Jeśli nie ma łączności
Przyczyna jest pokazywana na czerwonym pasku na „Głównej” i w logu:
- „Serwer nie zna tego klucza API” — klucz jest błędny lub odwołany. Pobierz archiwum z panelu administracyjnego ponownie albo wpisz świeży
KEYdoconfig_gui.txti uruchom program ponownie. - „Serwer prosi o wysyłanie zapytań na inny adres” — naciśnij „Użyj tego adresu” na pasku: program sam zapisze nowy
API_URLi zaproponuje powtórzenie sprawdzenia. - „Nie znaleziono adresu”, „Serwer nie odpowiedział na czas”, „Nie można się połączyć” — problem z siecią lub adresem. Sprawdź internet i
API_URLw pliku. - „Serwer odpowiedział kodem 500” — problem po stronie serwera, nie w programie. Spróbuj później.
- „Nie podano klucza API” — parametr
KEYw pliku jest pusty, odpytywanie nie startuje. - Pełne omówienie — Częste błędy i co robić.
Nie ma zamówień, ale nie ma też błędów
To normalna sytuacja, jeśli dla zamówień nie wygenerowano jeszcze plików. Program zabiera tylko to, co serwer oddał jako gotowe; zamówienia w stanie oczekiwania pokazuje osobnym licznikiem „Generacja” i zabierze je w jednym z kolejnych cykli.
Dalej — Reguły tras: bez nich pliki zostaną w folderze zamówień i nie dojadą do maszyn.
Jeśli w planach jest też wymiana z systemem księgowym, następny krok po trasach to Podłączenie przetwarzania BAS / 1C: adres tego komputera, port i token, który wydawany jest tutaj, przyciskiem „API dla 1C” na zakładce „Towary”.