Различия

Показаны различия между двумя версиями страницы.

--- external:дискобот:установка_и_настройка [2022/05/02 13:21] – Александр Ильин
+++ external:дискобот:установка_и_настройка [2022/05/03 12:08] (текущий) – удалено Александр Ильин
@@ Строка 1: / Строка 1: @@
-====== Установка и настройка ======
-===== Создание бота =====
-О том как завести своего бота [[external:zz_дополнительные_материалы:01_telegram_bot|подробно написано тут]]
-===== Настройка HTTP XML интерфейса =====
-  - Перейдите в справочник "Сервис -> Станции и устройства".
-  - Из дерева слева выберите кассовый сервер, с которым будет работать программа.
-  - Перейдите во вкладку "Свойства" выбранного кассового сервера.
-  - В группе свойств HTTP ограничения для всех пунктов проставьте значение. Можно использовать стандартную привилегию (например, "HTTP Access"), а можно завести дополнительное значение и использовать его.
-  - В группе свойств HTTP Server  параметр "HTTP Data Port" установите в соответствии с любым свободным портом на компьютере, где работает выбранный кассовый сервер.
-  - Перезапустите кассовый сервер для того, чтобы выполненные настройки вступили в силу.
-===== Настройка пользователя для HTTP XML интерфейса =====
-  - Перейдите в справочник "Персонал -> Работники"
-  - В рамках текущего ресторана выберите или создайте новую роль, дайте ей привилегию на объект "HTTP Access" (или ту что вы завели в прошлом разделе) в группе параметров "Менеджерские ограничения"
-  - Для выбранной роли создайте пользователя с названием строго из **ЛАТИНСКИХ ** букв, задайте пользователю пароль (цифры и латинские буквы).
-От имени этого работника в заказ будет добавляться информация о пресональной карте гостя, убедитесь что у данной роли есть права на «Общие операции», «Пользовательские операции» и «Редактирование заказа».
-{{:external:дискобот:pasted:20210311-063951.png}}
-==== Свойство «Телефон» у работников ====
-Для корректной работы бота ему требуются телефоны сотрудников, для этого нужно создать дополнительно поле работникам, где можно будет записывать их номера. Откройте справочник «Настройки → Настройка → Расширенные свойства». Выберите группу «Свойства для справочников» и создайте новый тип расширенных свойств «Телефон». Задайте системное имя «PhoneNumber» (регистр очень важен) и тип свойства «ANSI string».
-{{:external:дискобот:pasted:20210311-065954.png}}
-Дважды кликните по полю «Список типов», чтобы открыть окно типов для расширенного свойства «Телефон», затем добавьте новый элемент и выберите из списка «Работники → Работник».
-{{:external:дискобот:pasted:20210311-070412.png}}
-После этого, возможно, понадобится перезапустить менеджерскую станцию, чтобы можно было редактировать поле «Телефон» у работников.
-==== Настройка MCR алгоритма ====
-Для применения кода бот использует MCR алгоритм, привязанный к логическому интерфейсу платежной системы.
-В настройках MCR алгоритма необходимо указать тип устройства «Штрих код».
-{{:external:дискобот:pasted:20210428-140005.png}}
-===== Настройка бота =====
-==== Конфигурация ====
-Откройте файл config.ini и отредактируйте значения. Секция [telegram]:
-  * token — токен бота, который должен выдать BotFather в пункте [[#создание_бота|«Создание бота»]].
-Секция [r_keeper]:
-  * addr — адрес кассового сервера.
-  * port — порт кассового сервера (HTTP Data Port из пункта [[#XML_интерфейс|«XML интерфейс»]]).
-  * user — имя работника (не код!), созданного в пункте [[#новый_работник|«Новый работник»]].
-  * pass — пароль работника.
-  * interface — код логического интерфейса платежной системы.
-  * cash_station — код кассовой станции, от имени которой проходят операции.
-  * phone_numbers — принимать ли ввод номера телефона для применения карты. (0 — только фотографии кодов, 1 — принимать также и ввод)
-Секция [log]
-  * retention — время жизни старых Log файлов в днях.
-  * level — уровень важности логируемых сообщений, высокий уровень логирования будет показывать только критичные ошибки программы, низкий — всю информацию о работе программы.
-Пример конфигурационного файла:
-<code ini>
-[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
-[log]
-; Время жизни старых Log файлов в днях
-retention = 7
-; Уровень важности логируемых сообщений, высокий уровень логирования будет показывать
-; только критичные ошибки программы, низкий — всю информацию о работе программы.
-level = 1
-</code>
-==== Лицензирование и Запуск ====
-  - Запустить DiscoBot.exe с ключом /license (либо запустить license_form.bat, который делает то же самое), подождать несколько секунд и произвести лицензирование: \\ 1.1 В окне программы нажать кнопку "Лицензирование" \\ 1.2 В открывшемся окне ввести логин и пароль в системе лицензирования ГК "Карбис" \\ 1.3 В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку "Отправить" \\ 1.4 Программа сообщит об успешном применении лицензии и закроет окно лицензирования \\ 1.5 После синхронизации данных с сервером лицензирования, в главном окне программы отобразятся данные о текущей лицензии \\ 1.6 Убедившись, что лицензия установлена корректно, закрыть окно программы.
-  - Установить DiscoBot.exe с ключом /install и запустить службу CarbisDiscoBot
-**ВНИМАНИЕ!** \\ Перед запуском и лицензированием убедитесь, что файл server.bin не пустой. \\ В ином случае будет невозможно получить лицензию.
-**ВАЖНО!** \\ Дальнейшее **продление лицензии**  на модуль "CarbisDiscoBot" делается **ТОЛЬКО**  через сайт лицензирования ([[https://wiki.carbis.ru/lic/lic#продление_лицензий|инструкция]])