Различия

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

--- external:carbistbot:установка_и_настройка [2021/02/10 09:53] – [Подключение ресторана к чату] Алексей Коробов
+++ external:carbistbot:установка_и_настройка [2024/11/25 12:50] (текущий) – Алексей Коробов
@@ Строка 1: / Строка 1: @@
+===== Инструкция по установке =====
+\\
+\\
+\\
+\\
+\\
+\\
+Это статья по настройке устаревшего ПО.
+**Актуальная информация по настройке телеграм-бота для r_keeper: [[https://wiki.carbis.ru/external/pro_alert|Настройка ProAlert]]**
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+\\
+[[https://disk.yandex.ru/d/mMWksLeuqO8Rmw|Актуальный дистрибутив]]\\
+- Библиотеки для корректной работы (dll)
-===== Состав дистрибутива =====
-[[https://yadi.sk/d/Ce61YT4tIRZkzA|Актуальный дистрибутив]]\\
-  - Библиотеки для корректной работы (dll)
   - Файл настроек config.ini
   - Исполняемый файл для установки на кассовом сервере RestAgent.exe
@@ Строка 24: / Строка 50: @@
 === Установка и лицензирование службы CarbisTBotRestAgent.exe ===
-  - Запустить CarbisTBotRestAgent.exe с ключом /desktop и произвести лицензирование: \\ 1.1 В окне программы нажать кнопку "Лицензирование" \\ 1.2 В открывшемся окне ввести логин и пароль в системе лицензирования ГК Карбис \\ 1.3 В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку "Отправить" \\ 1.4 Программа сообщит об успешном применении лицензии и закроет окно лицензирования \\ 1.5 После синхронизации данных с сервером лицензирования, на главно окне программы отобразятся данные о текущей лицензии \\ 1.6 Убедившись, что лицензия установлена корректно, закрыть окно программы.
+  - Запустить CarbisTBotRestAgent.exe с ключом /desktop и произвести лицензирование: \\ 1.1 В окне программы нажать кнопку "Лицензирование" \\ 1.2 В открывшемся окне ввести логин и пароль в системе лицензирования ГК Карбис \\ 1.3 В отобразившемся списке объектов, выбрать текущий, указать дополнительные параметры лицензии и нажать кнопку "Отправить" \\ 1.4 Программа сообщит об успешном применении лицензии и закроет окно лицензирования \\ 1.5 После синхронизации данных с сервером лицензирования, в главном окне программы отобразятся данные о текущей лицензии \\ 1.6 Убедившись, что лицензия установлена корректно, закрыть окно программы.
-  - Установить CarbisTBotRestAgent.exe с ключом /install и запустить службу CarbisTBotRestAgent \\
+  - Установить CarbisTBotRestAgent.exe с ключом /install и запустить службу CarbisTBotRestAgent
-**ВНИМАНИЕ!** \\
-Перед запуском и лицензированием убедитесь, что файл server.bin не пустой.\\
-В ином случае будет невозможно получить лицензию.
-**ВАЖНО!**\\
+**ВНИМАНИЕ!** \\ Перед запуском и лицензированием убедитесь, что файл server.bin не пустой. \\ В ином случае будет невозможно получить лицензию.
-Дальнейшее **продление лицензии** на модуль "CarbisTBot" делается **ТОЛЬКО** через сайт лицензирования ([[lic:main#продление_лицензий|инструкция]])
+**ВАЖНО!** \\ Дальнейшее **продление лицензии**  на модуль "CarbisTBot" делается **ТОЛЬКО**  через сайт лицензирования [[https://wiki.carbis.ru/lic/lic#%D0%BF%D1%80%D0%BE%D0%B4%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D0%BB%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D0%B9|Инструкция]]
 ----
@@ Строка 38: / Строка 61: @@
 ===== Настройки r_keeper =====
-  - Создать XML интерфейс на кассовом сервере, в свойствах задать ему свободный порт, записать номер порта в config.ini в параметр xmlPort{{  :external:carbistbot:2.png?nolink&  }}
+  - Создать XML интерфейс на кассовом сервере, в свойствах задать ему свободный порт, записать номер порта в config.ini в параметр xmlPort \\ {{:external:carbistbot:pasted:20210310-155509.png}}
   - Создать логический интерфейс и связать его с XML интерфейсом{{  :external:carbistbot:1.png?nolink&  }}
-  - На каждой кассе добавить I/O порт Print to TCP/IP printer. В свойствах указать ip адрес машины, на которой установлен RestAgent.exe, и порт из config.ini параметра 'ListenPort'
+  - На каждой кассе добавить I/O порт Print to TCP/IP printer. В свойствах указать ip адрес машины, на которой установлен RestAgent.exe, и порт (8421) из config.ini параметра 'ListenPort'
   - Добавить порт в исключения брандмауэра
   - **В свойствах драйвера "Print to TCP/IP printer" установить параметр "Keep connect" = "Yes"**
-  - В I/O порте Print to TCP/IP printer на каждой кассе добавить принтер PlainText, активировать его в принтерах
+  - В I/O порте Print to TCP/IP printer на каждой станции r_keeper добавить принтер PlainText, активировать его в принтерах
-  - На каждой кассе в назначении принтеров "для XML отчетов" указать ранее созданные принтеры {{  :external:carbistbot:5.png?nolink&  }}
+  - На каждой станции r_keeper в назначении принтеров "для XML отчетов" указать ранее созданные принтеры {{  :external:carbistbot:5.png?nolink&  }}
   - Если есть станция печати, создать I/O порт Print to TCP/IP printer, на него также повесить принтер PlainText. Этот принтер будет использоваться для отправки отчетов о закрытии смены.
   - Если станции печати нет, выбрать ранее созданный принтер на главной кассе, этот принтер будет использоваться для отправки отчетов о закрытии смены.
@@ Строка 51: / Строка 75: @@
 **ВАЖНО**  Необходима перезагрузка кассового сервера после добавления на него интерфейса. При добавлении интерфейса на станцию печати также перезагрузить станцию печати
 ----
@@ Строка 58: / Строка 81: @@
   - Создать группу
-  - Добавить бота @CarbisTBot в группу
+  - Добавить бота @CarbisOldTBot в группу
   - Дать ему права админа с возможностью добавления новых админов
-  - Удалить @CarbisTBot из группы
+  - Удалить @CarbisOldTBot из группы
-  - Добавить @CarbisTBot в группу снова (эти действия нужны для апгрейда группы в супергруппу и корректной работы бота)
+  - Добавить @CarbisOldTBot в группу снова (эти действия нужны для апгрейда группы в супергруппу и корректной работы бота)
   - Бот сообщит ID текущего чата для создания дальнейшей связки с рестораном.
 ----
 ===== Подключение ресторана к чату =====
-[[http://wiki.carbis.ru/doku.php?id=internal:int_soft:tbot_admin|Для инженеров ГК "Карбис". Описание настройки на стороне сервера отправки сообщений. (настройка чатов, групп, и доступных в чате отчетов)]]
+[[https://wikiint.carbis.ru/internal/int_soft/tbot_admin|Для инженеров ГК "Карбис". Описание настройки на стороне сервера отправки сообщений. (настройка чатов, групп, и доступных в чате отчетов)]]
 Для подключения ресторана к чату необходимо направить в службу технической поддержки ГК Карбис [[mailto:911@carbis.ru|письмо]], с названием ресторана и ID чата, полученным от бота в предыдущем пункте инструкции. Кроме того, необходимо указать нужные отчеты и их коды (можно посмотреть в менеджерской настройки→печать→документы и макеты). Нужны именно коды макетов, а не коды "представлений".
@@ Строка 83: / Строка 106: @@
 Удаления чеков код - 50
 Системный балансовый отчет код - 10771
 </code>
@@ Строка 88: / Строка 113: @@
 **P.S. В случае, если необходимо подключить ресторан к нескольким чатам, для повышения оперативности обработки заявок просим перечислять все чаты в одном письме.**
 ----
@@ Строка 96: / Строка 120: @@
   * /start@CarbisTBot - вывести стартовую клавиатуру
   * /getversion@CarbisTBot - показать информацию о версии
 ----
@@ Строка 104: / Строка 127: @@
 Для отображения списка отчетов отправить команду /start в чат
-\\
+===== Рекомендации =====
+Для инженеров - после настройки в телеграм-чате обязательно:
+) передать полные максимальные права на администрирование заказчику;
+) в чате сделать ссылку-приглашение и **записать её в задаче на настройку и в карточке компании** - если в дальнейшем потребуется что-то проверить - можно будет попасть в чат по этой ссылке;
+Управление группой - пригласительные ссылки. {{:external:carbistbot:pasted:20210318-120426.png}}
+===== Известные проблемы =====
+"Защитник Windows" часто считает exe-файл телеграм-бота вирусом и склонен его удалять. При этом касса r_keeper начнет немного тормозить при работе с заказом (т. к. не сможет отправлять данные боту). Рекомендуется сразу добавить папку с ботом в исключения антивируса.
+Название объектов в боте берется из lic.carbis.ru, и не всегда название помещается на экране телефона. Учитывать при создании объекта.
+Спецсимволы в названии ресторана "съедаются" при отображении в телеграм-боте.