Общая информация
Данное приложение позволяет работать с базой ПДС и производить редактирование справочников, а также является расширенным инструментом по сегментированию гостей, выставлению тэгов гостей и организации коммуникации с гостями по средством EMail и SMS рассылки.
В данной статье описано как настроить MarketingDesktop.
Дистрибутив
Важно: Система предоставляется только в облачном исполнении, отдельный дистрибутив недоступен.
Схема взаимосвязи модулей
Взаимосвязь модулей отображена ниже
Рис. Простейшая схема взаимосвязи модулей
Примечание: CardServ необходим не ниже версии 7.25
Так как используется распределенная ПДС (подробнее в статье http://support.ucs.ru/ru/node/6673#header-29), то подключать Сервер "CardServApi" необходимо только к центральному серверу ПДС "CardServ", который в свою очередь синхронизируется с локальными серверами с помощью SyncCard.
Рис. Взаимодействие модулей MarketingDesktop
Для работы с менеджерской частью MarketingDesktop требуется подключение к Internet.
При этом потеря связи с центральным сервером не критична для предоставления лояльности на кассах и система лояльности продолжит функционировать на локальном CardServ. Но синхронизируется как появится связь с центральным сервером.
База данных хранится в облаке на мощностях UCS. Бэкап базы предоставляется по требованию.
Лицензирование
Название ПО в системе лицензирования "R-Keeper модуль MarketingDesktop ПО".
На данный момент MarketingDesktop распространяется:
-
в составе RKCloud (базовый пакет MarketingDesktop);
-
отдельно в облачном исполнении.
Настройки на стороне R_Keeper v7
В менеджерской станции необходимо настроить доступ к серверу справочников через HTTPS. Подробнее читайте здесь http://tracker.ucs.ru:8080/redmine/projects/-helpdesk-/wiki/r-keeper-7-xmlinterface-ru.
Кратко порядок действий будет следующий:
- В справочнике "Сервис - Менеджерская станция - Привилегии на объекты" добавить новую привилегию, например HTTP_порт.
Рис. Создание привилегии
- В свойствах сервера справочников прописать порт (параметр HTTP Data Port) в секции HTTP Server. Флаг Use Free Listen Port необходим, чтобы программа выбрала другой порт в случае, когда заданный в свойстве HTTP Data Port порт занят. Поэтому проверьте сразу свободен ли порт, который вы задаете. В блоке HTTP Ограничения выбрать ограничение, созданное в п 1. После сохранение изменений необходимо перезагрузить сервер.
Рис. Задание порта "HTTP Data Port" в свойствах сервера справочников.
- Создать роль с правами на привилегию из п.1.
Также у данной роли должны быть следующие права:
-
Менеджерская станция - доступ к MarketingDesktop (по указанному email проивзодится авторизация);
-
Системные конфигурации - доступ к настройкам MarketingDesktop (например, SMS шлюз).

- Для этой роли добавить работника, задать ему пароль. Название и пароль данного работника будут использоваться для авторизации на сервере через HTTPS.


Настройка CardServApi.exe
- В файле \srcbin\rkeeper.ini в секции [RTcp] прописать IP-адрес и порт Сервера карт - CardServ.exe
[RTcp] Server1 = 192.168.101.82 Port1 = 3055
- В файле .\CardServApi.ini в секции [Main] прописать свободный порт, который будет слушать сервер API. Его нужно будет так же ввести в файле Web.Config (пункт ниже "Настройка IIS"). Для параметра UCSPassword прописать пароль пользователя ucs из системы ПДС (по-умолчанию пароль = "ucs").
Примечание: если в ПДС пользователь "ucs" был единственный в группе "Administrator", то рекомендуется создать еще одного пользователя в данной группе(роли) до запуска CardServApi.exe.
[Main] HttpPort=9988 UCSPassword=ucs
- В том же файле, но в секции [RK7] прописать IP-адрес и HTTP-порт сервера справочников согласно рис 2 и логин/пароль согласно рис 4.
[RK7] ip=192.168.101.82 port=3355 username=http_User45 password=45 ShowMarkups=0
-
Выполнить CardServApi.exe /install. Запустить службу CardServApiService
-
Логи служба пишет в папку Logs.
Интерграция CardServApi с Postgres
Поддержано в версии CardServApi 1.0.0.16 и выше.
-
Установить Postgres 9.6, создать базу данных.
-
Задать настройки коннекта к Postgres в CardServApi.ini:
[PG] ip=127.0.0.1 port=5432 dbname=cardserv username=user password=1
- В корневой папке с Cardservapi для связи с Postgres должны быть файлы:
- libiconv-2.dll
- libintl-8.dll
- libpq.dll
- Если используется RK6, то в секции [Main] выставить параметр UseRk6Image в 1. По умолчанию 0.
[Main] UseRk6Image = 1
- Если служба не запускается, установить MS Visual C++ 2013
Настройка Web-интерфейса
Для работы Web-интерфейса необходим сервер IIS.
Сервер IIS должен быть настроен и запущен. Подробнее о настройках читайте в статье http://support.ucs.ru/ru/node/8649 и дополнительно в статье http://support.ucs.ru/ru/node/7888 и http://support.ucs.ru/ru/node/7889.
Так же можно найти информацию на сайте https://technet.microsoft.com/en-us/library/hh831515(v=ws.11).aspx.
После включения сервера IIS выполняем следующее:
-
Запускаем "Диспетчер служб IIS";
-
Распаковываем архив marketingDesktop.zip в любой каталог на диске (например, D:\UCS\Marketing_desktop\web_v7\);
-
В "Диспетчере служб IIS" добавить новый сайт (приложение), где в качестве физического пути к приложению выбрать папку из пункта выше (D:\UCS\Marketing_desktop\web_v7\);
-
Прописать свободный порт для данного сайта, например 8002; Нажать кнопку "OK";
-
В свойствах пула выбрать версию Фреймворка 4. Если не доступна данная версия, то обновить Фреймворк.
Рис. Основные настройки пула
- В файле Web.config изменить следующие параметры:
-
ApiHost - URL сервера CardServApi
-
ApiTimeout - таймаут выполнения запросов к серверу Api
Фрагмент файла:
... <add key="ApiHost" value="http://127.0.0.1:9988/" /> <add key="ApiTimeout" value="10000" /> ...
-
При изменении файла Web.config приложение IIS необходимо перезагрузить, чтобы новые настройки вступили в силу.
-
После в браузере открыть страницу http://127.0.0.1:8002/ и ввести логин и пароль пользователя из РК7. Для пользователей RK-Cloud ссылка будет иметь вид http://rkcloud.ucs.ru/code_rest/MD/login, где code_rest - полный код ресторана (9 цифр).
Рис. Окно авторизации
Примечание: при доступе из RK-Cloud необходимо в меню выбрать ПДС -> Marketing_Desktop. Веб-интерфейс доступен по ссылке http://rkcloud.ucs.ru/code_rest/Home/Login, где code_rest - это полный код ресторана (9 цифр).
- В качестве логина использовать значение свойства EmployeeEMail работника (см.рис ниже).
Рис. Свойства работника
- Как выглядит интерфейс, можно посмотреть на рисунке ниже.
Рис. Web-интерфейс MarketingDesktop