- управление лояльностью
Руководство пользователя
×

Как работает автоматическое обновление библиотеки подключения к облаку доминат на кассах

Автоматическое обновление клиентского ПО на точке подключения
Примечание : Если Вы устанавливали клиентское ПО ранее, чем 01.10.2018 г., ниже указанный функционал работать не будет. Вам необходимо обновить ПО вручную в следующем порядке : 1. Остановить кассовое ПО. 2. Скачать и запустить инсталлятор http://dominat.pro/downloads/DominatSetupWithoutFireBirdandNET.exe . 3. Запустить кассовое ПО и обновить сценарий http://dominat.pro/downloads/DominatScript.txt . 4. Перезагрузить компьютер
 
Как это работает ?
Точка подключения проверяет наличие новой версии на ресурсе, указанном в Bonica.ini - UpdateUrl=https://dominat.pro/downloads. Если Вы хотите процесс обновления взять в свои руки - укажите свой ресурс. 
Проверка обновлений на ресурсе, а также загрузка файлов с ресурса производится при запуске точки подключения, и далее каждые пять часов. Загрузка производится в папку <DominatInstallPath>\Update. Загрузка происходит в фоновом режиме незаметно для пользователей службой BonicaService.
Обновление из папки <DominatInstallPath>\Update происходит при запуске кассового ПО, при этом выполнение кассового ПО блокируется, на экране отображается статус обновления. Сам процесс обновления занимает 5-10 секунд в зависимости от производительности  компьютера.
 
Что находится на ресурсе ?
Важно !!! Далее по тексту названия файлов чувствительны к регистру. Используйте их именно так, как указано ниже.
 
Файл version.txt. Это реестр версий файлов, которые Вы редактируете для управления обновлением. Строчка файла выглядит следующим образом :
XXXXXXXX.YYY ZZZ
где XXXXXX имя файла, YYY его расширение, ZZZ версия файла. находящегося на ресурсе.
между YYY и ZZZ должен быть один пробел.
 
В типовом файле version.txt содержатся :
BonicaAddin.dll - библиотека подключения к серверу Dominat
BonicaForms.dll - интерфейс библиотеки.
BonicaService.exe - служба, контролирует подключение к сети Интернет, в случае накопившейся информации при отключенном интернете - отправляет в фоновом режиме эту информацию после подключения к сети Интернет. Также в фоновом режиме проверяет и скачивает новые версии ПО.
IndigoServerService.exe - служба, проверяющая активность службы BonicaService. Пытается возобновить ее работу в случае остановки.
AtolFiscalPrinterCommand.exe - программа управления фискальными регистраторами АТОЛ. Используется библиотекой BonicaAddin.dll для печати отчетов и др. на фискальных регистраторах.
DominatScript.txt - последняя версия сценария. Используется на кассовом ПО Frontol.
BonicaClient.exe - программа электронного киоска самообслуживания покупателей. Используется на точках подключения самообслуживания.
 
Все вышеуказанные файлы также находятся на ресурсе рядом с файлом version.txt
Вы можете управлять обновлениями:
Если Вы поменяете номер версии ZZZ на большую. чем имеется на точке подключения - точка подключения начнет ее себе устанавливать. Обратите внимание, что если вы просто поменяете номер версии в файле version.txt и не поменяете сам файл на новый - точка подключения будет его скачивать и устанавливать бесконечно.
Если какой то из названия файлов удалить из version.txt - он перестанет обновляться.
Для пользователей ПО Frontol: 
в сценарии есть переменная MinimalDllVersion. При запуске сценарий проверяет версию BonicaAddin.dll на эту переменную, если библиотека старее, чем требуется - сценарий не запускается.
в сценарии есть строка Bonica.UpdateFrontolScript(); Если ее закомментировать - сценарий в Frontol перестанет обновляться автоматически.
при автоматическом обновлении сценария анализируется его текст. Если Вы используете свои вставки в код сценария и они находятся между //<-StopFragment и //->StartFragment, то Ваш код переносится в новую версию сценария.