Перший запуск і перевірка зв'язку

Архів програми не потребує встановлення: розпакуйте його та запустіть файл програми. Нижче — що відбувається під час першого запуску і як переконатися, що зв’язок із сервером є.

Куди розпаковувати

У теку, де користувач має права на запис, наприклад C:\cnc_client. Поруч із програмою створюються її робочі файли: налаштування, база замовлень і журнали. Теки на кшталт C:\Program Files не підходять — Windows заборонить запис.

Звідки програма знає вашу фірму

Ключ фірми (KEY) та адреса сервера (API_URL) уже вписані у файл config_gui.txt поруч із програмою: їх підставляє сервер, коли ви завантажуєте архів з адмінпанелі. У вікні програми цих полів немає — перевірити їх можна лише у файлі. Докладніше: Вкладка «Налаштування».

Що ви побачите

У шапці вікна — назва вашої фірми, під нею підпис «Клієнт завантаження» і номер версії. Назва приходить із сервера за ключем і запам’ятовується, тому наступного разу з’являється одразу. Поки відповіді немає — нейтральний підпис.
Ліворуч стовпчиком — вкладки, праворуч — вміст вибраної. Докладніше: Огляд вікна.
Унизу — рядок стану: кольорова крапка, поточний стан і годинник.
За замовчуванням програма одразу починає опитувати сервер і згортається на панель завдань. Обидві звички вимикаються галочками на вкладці «Налаштування».

Перевірка зв’язку за три кроки

На вкладці «Головна» натисніть «↻ Перевірити». Якщо ключ у файлі порожній, програма відповість повідомленням «API ключ не встановлено» і опитування не почне.
Подивіться на верх «Головної». Поки все гаразд, червоної смуги там немає; якщо сервер не прийняв запит, з’явиться смуга з причиною і кнопка «Подробиці в лозі».
Відкрийте вкладку «Лог». Там покроково видно: адресу, на яку пішов запит, відповідь сервера, скільки замовлень до завантаження, завантаження та розпакування кожного.

Скільки чекати

Одне нове замовлення проходить увесь шлях — запит, завантаження, розпакування, копіювання на верстати, конвертація — приблизно за 10–40 секунд.
Перше коло зазвичай найдовше: сервер віддає всі замовлення за останні дні (за замовчуванням 60, задається у time.txt). На великій фірмі це сотні замовлень.
Далі програма опитує сервер за розкладом: інтервал задається параметром every_minutes у config_gui.txt, мінімум — три хвилини.

Якщо зв’язку немає

Причина показується в червоній смузі на «Головній» і в лозі:

«Сервер не знає цей API-ключ» — ключ неправильний або відкликаний. Завантажте архів з адмінпанелі заново або впишіть свіжий KEY у config_gui.txt і перезапустіть програму.
«Сервер просить надсилати запити на іншу адресу» — натисніть «Взяти цю адресу» у смузі: програма сама запише нову API_URL і запропонує повторити перевірку.
«Адресу не знайдено», «Сервер не відповів вчасно», «Не вдається підключитися» — проблема з мережею або адресою. Перевірте інтернет і API_URL у файлі.
«Сервер відповів кодом 500» — проблема на боці сервера, не в програмі. Повторіть пізніше.
«API-ключ не вказано» — параметр KEY у файлі порожній, опитування не стартує.
Повний розбір — Часті помилки і що робити.

Замовлень немає, а помилок теж немає

Це нормальна ситуація, якщо за замовленнями ще не згенеровано файли. Програма забирає лише те, що сервер віддав як готове; замовлення в стані очікування вона показує окремим лічильником «Генерація» і забере їх на одному з наступних кіл.

Далі — Правила маршрутів: без них файли залишаться лежати в теці замовлень і до верстатів не доїдуть.

Якщо в планах ще й обмін з обліковою системою, наступний крок після маршрутів — Підключення обробки BAS / 1С: адреса цього комп’ютера, порт і токен, який видається тут само, кнопкою «API для 1С» на вкладці «Товари».