Установка и настройка

Данная статья является устаревшей. Актуальная документация по установке и настройке модуля:ProDiscoBot

О том как завести своего бота подробно написано тут

Описано в статье Настройка XML интерфейса

1. Перейдите в справочник «Персонал → Работники»
2. В рамках текущего ресторана выберите или создайте новую роль, дайте ей привилегию на объект «HTTP Access» (или ту что вы завели в прошлом разделе) в группе параметров «Менеджерские ограничения»
3. Для выбранной роли создайте пользователя с названием строго из ЛАТИНСКИХ букв, задайте пользователю пароль (цифры и латинские буквы).

Важно! От имени этого работника в заказ будет добавляться информация о пресональной карте гостя, убедитесь что у данной роли есть права на «Общие операции», «Пользовательские операции» и «Редактирование заказа».

Для корректной работы бота ему требуются телефоны сотрудников, для этого нужно создать дополнительно поле работникам, где можно будет записывать их номера. Откройте справочник «Настройки → Настройка → Расширенные свойства». Выберите группу «Свойства для справочников» и создайте новый тип расширенных свойств «Телефон». Задайте системное имя «PhoneNumber» (регистр очень важен) и тип свойства «ANSI string».

Дважды кликните по полю «Список типов», чтобы открыть окно типов для расширенного свойства «Телефон», затем добавьте новый элемент и выберите из списка «Работники → Работник».

После этого, возможно, понадобится перезапустить менеджерскую станцию, чтобы добавленное свойство стало доступно в справочнике.
Для всех сотрудников, которые будут работать с ботом, необходимо заполнить реальный телефон (тот, который указан в аккаунте Telegram).

Для применения кода бот использует MCR алгоритм, привязанный к логическому интерфейсу платежной системы.
В настройках MCR алгоритма необходимо указать тип устройства «Штрих код».

В составе установочного пакета в папке redist находится VC_redist.x86. Установите его.
Если visual c++ уже установлен в системе - этот пункт можно пропутистить.

Откройте файл config.ini и отредактируйте значения. Секция [telegram]:

• token — токен бота, который должен выдать BotFather в пункте «Создание бота».

Секция [r_keeper]:

• addr — адрес кассового сервера.
• port — порт кассового сервера (HTTP Data Port из пункта «XML интерфейс»).
• user — имя работника (не код!), созданного в пункте «Новый работник».
• pass — пароль работника.
• interface — код логического интерфейса платежной системы.
• cash_station — код кассовой станции, от имени которой проходят операции.
• phone_numbers — принимать ли ввод номера телефона для применения карты. (0 — только фотографии кодов, 1 — принимать также и ввод)
• seat_discounts - поддержка скидок «по местам» (0 - скидка только «на заказ», 1 - выбор «на заказ» или «на место»)

Секция [log]

• retention — время жизни старых Log файлов в днях.
• level — уровень важности логируемых сообщений, высокий уровень логирования будет показывать только критичные ошибки программы, низкий — всю информацию о работе программы.

Пример конфигурационного файла:

[telegram]
; Токен бота, который должен выдать BotFather
token = <BOT_TOKEN>
 
[r_keeper]
; Адрес кассового сервера
addr = 127.0.0.1
; Порт кассового сервера (HTTP Data Port)
port = 15151
; Имя работника (не код!)
user = Username
; Пароль работника
pass = Password
; Код логического интерфейса платежной системы
interface = 12
; Код кассовой станции, от имени которой проходят операции
cash_station = 1
; Принимать ли ввод номера телефона для применения карты. (0 — только фотографии кодов, 1 — принимать также и ввод)
phone_numbers = 0
; Включить поддержку скидок "на место"
seat_discounts = 1
 
[log]
; Время жизни старых Log файлов в днях
retention = 7
; Уровень важности логируемых сообщений, высокий уровень логирования будет показывать
; только критичные ошибки программы, низкий — всю информацию о работе программы.
level = 1

1. Запустить DiscoBot.exe с ключом /license (либо запустить license_form.bat, который делает то же самое), подождать несколько секунд и произвести лицензирование:
   1. В окне программы нажать кнопку «Лицензирование»
   2. В открывшемся окне ввести логин и пароль в системе лицензирования ГК «Карбис»
   3. В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку «Отправить»
   4. Программа сообщит об успешном применении лицензии и закроет окно лицензирования
   5. После синхронизации данных с сервером лицензирования, в главном окне программы отобразятся данные о текущей лицензии
   6. Убедившись, что лицензия установлена корректно, закрыть окно программы.
2. Установить DiscoBot.exe с ключом /install (либо запустить install.bat)
3. Запустить службу CarbisDiscoBot

ВНИМАНИЕ!
Перед запуском и лицензированием убедитесь, что файл server.bin не пустой.
В ином случае будет невозможно получить лицензию.

ВАЖНО!
Дальнейшее продление лицензии на модуль «CarbisDiscoBot» делается ТОЛЬКО через сайт лицензирования (инструкция)